Commit graph

19 commits

Author SHA1 Message Date
anthonycaccese
66c72947d6 Wiki reference update 2023-09-20 18:52:31 -04:00
littleguy77
c746e283a9 Add a section about pushing modified images using scp/ssh. 2023-09-10 10:56:19 -04:00
littleguy77
50cad2868a Clarify building image with modifications.
Applies to any modifications, not just those using a patch.

The comments seem superfluous, and obfuscate the fact that this is just
a delta from the "Building a Single Package" section.
2023-09-10 10:46:50 -04:00
littleguy77
5cc10de5ab Minor tweak to build docs.
- PROJECT should be defined when building/cleaning a package.
- List PROJECT options.
- Use export rather than defining vars on same line (save some typing).
- Clarify "manually" to mean "outside of Docker".
2023-09-03 20:05:46 -04:00
littleguy77
38ba800c4f Most users should run scripts from within docker-shell. 2023-09-03 10:25:06 -04:00
littleguy77
2566c6df6a Explain use case for building a single package. 2023-09-03 10:25:06 -04:00
littleguy77
645054132a Add a short note about virtual machines. 2023-09-03 10:25:06 -04:00
littleguy77
1abebd8c11 Add a troubleshooting section to address build failures. 2023-09-03 10:25:06 -04:00
littleguy77
5020772a14 Establish proper expectations for the first build after clone. 2023-09-03 10:25:06 -04:00
littleguy77
347aed56c1 Clarify build commands for Docker vs. manual builds.
Use the Docker command in the example to promote Docker usage.
2023-09-03 10:25:06 -04:00
littleguy77
56396528af Fix documentation about device build dependencies. 2023-09-03 10:25:06 -04:00
littleguy77
4aa36aa365 Steer new devs to Docker builds, and be more precise about host config.
Ubuntu 22.04 is recommended for Docker builds, and virtually required
for manual builds.

New devs should use Docker unless they really know what they're doing
and why.  They need not have any past Docker experience; JELOS makes it
trivial to use.
2023-09-03 10:25:06 -04:00
littleguy77
399542c3d2 Just refer manual builders to the Dockerfile for the prerequisites.
Don't maintain the same list in two places.

After careful review, the only packages listed in the help doc that
weren't in the Dockerfile were
- ca-certificates
- gnupg
- qemu-user-static

The first two are only needed to install Docker, and thus do not belong
in the manual build section.  The last doesn't appear to be needed for
building, since the Docker container doesn't have it.
2023-09-03 10:25:06 -04:00
littleguy77
ca29aa2322 Include Docker post-install steps to run without sudo. 2023-09-03 10:25:05 -04:00
littleguy77
51f4ac181c Refresh Docker install instructions, including prerequisites. 2023-09-03 10:25:05 -04:00
littleguy77
b20f51edcc Minor tweaks for grammar and new flow. 2023-09-03 10:25:05 -04:00
littleguy77
fbb350432d Modify section headers. 2023-09-03 10:25:05 -04:00
littleguy77
919f54941b Rearrange sections in the build doc.
No change to text.  This just makes subsequent commits easier to review.
2023-09-03 10:25:05 -04:00
fewtarius
f8d6c3ce56
Add additional documentation, move device specific stuff down a level. 2023-07-14 21:53:37 +00:00
Renamed from documentation/BUILDING_THE_DISTRIBUTION.md (Browse further)