Fix docs

[johnklos]

The docs say:

Generate builder-hex0-x86-stage1.img from hex0 source:

sed 's/[;#].*$//g' builder-hex0/builder-hex0-x86-stage1-hex0 | xxd -r -p"

That's "builder-hex0/builder-hex0-x86-stage1.hex0", with a dot hex0 at the end, not dash hex0.

[johnklos]

Between steps 1 and 2 in the quickstart, the user should be told to cd live-bootstrap

[johnklos]

sed 's/[;#].*$//g' builder-hex0/builder-hex0-x86-stage1-hex0 | xxd -r -p

This doesn't make an image or a file. Is it supposed to have > builder-hex0-x86-stage1.img at the end?

The instructions after that can be given explicitly:

cat seed/stage0-posix/bootstrap-seeds/NATIVE/x86/builder-hex0-x86-stage1.img builder-hex0/builder-hex0-x86-stage2.hex0 | dd conv=sync of=image

or

cat builder-hex0-x86-stage1.img builder-hex0/builder-hex0-x86-stage2.hex0 | dd conv=sync of=image

"See the list in part a. For every file within that list, write a line to the disk". What is part a? Is that the "i. chroot:" part? Do you mean all the files in distfiles? What disk is being talked about here?

What is the "<path-to-file>" supposed to refer to in those directions? A relative path? Does that path include the filename itself, which is what a "path-to-file" would be, so every entry is the src, size, then distfiles/src?

download-distfiles.sh doesn't seem to care about or report errors (all of the gnulib distfiles gave curl: (6) Could not resolve host: _ errors)

Haven't got a clue what, "Only copy distfiles listed in sources files for build: steps manifested before improve: get_network into this disk." means. Where are we copying them? What's "improve: get_network"?

sha256sum isn't on all machines. shasum -a 256 might be more portable.

./mirror.sh fails with:

https://github.com/schierlm/gnu-autogen-bootstrapping~autogen-5.18.16-v1.0.1
Cloning into '/home/john/live-bootstrap/state/git/github.com/schierlm/gnu-autogen-bootstrapping'...
remote: Enumerating objects: 102, done.
remote: Counting objects: 100% (18/18), done.
remote: Compressing objects: 100% (15/15), done.
Receiving objects: 100% (102/102), 66.81 KiB | 495.00 KiB/s, done.
remote: Total 102 (delta 4), reused 7 (delta 3), pack-reused 84 (from 1)
Resolving deltas: 100% (43/43), done.
https://github.com/schierlm/gnu-autogen-bootstrapping~autogen-5.18.16-v1.0.1: generated tarball does not match checksum

I'll try some more tomorrow.

[fosslinux]

Reasonable points all around.

Indeed, this documentation is not great. Things should be more machine agnostic. Thanks for pointing this out.