6 files changed, 88 insertions(+), 36 deletions(-)

M galeb/all.do
M galeb/booting.slw
M galeb/clean.do
M galeb/faq.slw
M galeb/index.slw
A galeb/install.slw

@@ 1,1 1,1 @@
-redo-ifchange booting.html index.html faq.html
+redo-ifchange booting.html index.html install.html faq.html

@@ 14,19 14,6 @@ setting up boot configuration correctly. The perceived difficulty mostly comes
 from not understanding the basic concepts behind booting.
 
 
-## Disclaimer
-
-Galeb is a distro for advanced users, who know how a Unix-like system is
-organized internally. I will not be responsible for any damage resulting from
-not paying attention when needed, lack of will to read documentation, or lack of
-experience in administering a Unix-like system. You have been warned, so please
-pay attention, read the documentation, search the Web and avoid sending
-questions or requests for guidance.
-
-What I will appreciate, and will take into consideration, is patches solving
-potential issues.
-
-
 ## Firmware type
 
 There are two firmware types: the older, BIOS, and newer, UEFI. Which one of the


@@ 93,7 80,8 @@ assumes an UEFI/GPT system.
 | `/dev/sda2` | `/`          | ext4            | Rest    |
 {/.scroll}
 
-When configuring a boot entry, this means that the kernel command line will be
+When configuring a boot entry, this means that the kernel command line will
+include
 ```
 root=/dev/sda2
 ```


@@ 186,6 174,7 @@ you choose to boot from the Galeb USB medium.
 3. [https://wiki.archlinux.org/title/EFISTUB][efistub]
 4. [http://www.ivarch.com/programs/pv.shtml][pv]
 
+ 
 {made-by}
 {/main}
 

@@ 1,1 1,1 @@
-rm -f booting.html index.html faq.html *~
+rm -f booting.html index.html install.html faq.html *~

@@ 183,7 183,7 @@ running bootstrap scripts.{/dd}{/dl}
 {dt}**Q: Why not use heirloom vi/ex?**{/dt}
 {dd}**A:** Unfortunately, heirloom vi gives “Out of memory - too many
 lines in file”:
-[https://github.com/n-t-roff/heirloom-ex-vi/issues/3][exviissue]
+[https://github.com/n-t-roff/heirloom-ex-vi/issues/3][exviissue]{/dd}{/dl}
 
 {dl}
 {dt}**Q: Why not use vis instead of vim?**{/dt}


@@ 228,7 228,7 @@ marks?**{/dt}
 {dd}**A:** Because the default console font, `LatArCyrHeb-16`, doesn't have
 some Unicode characters. Use a console font with a different selection of
 characters, for example  
-[https://git.sr.ht/\~strahinja/fonts/](https://git.sr.ht/~strahinja/fonts/){/dd}
+[https://git.sr.ht/\~strahinja/fonts/](https://git.sr.ht/~strahinja/fonts/){/dd}{/dl}
 
 {made-by}
 {/main}

@@ 1,6 1,6 @@
 ---
-site-name: Galeb - Simple musl-based static meta distro
-site-desc: Simple musl-based static meta distro
+site-name: Galeb - Simple musl-based static distro
+site-desc: Simple musl-based static distro
 inline-stylesheet: ../index.css
 inline-stylesheet: galeb.css
 canonical: https://strahinja.srht.site/galeb/


@@ 9,7 9,7 @@ meta: index-meta.tsv
 {main}
 # Galeb
 
-Simple musl-based static meta distro
+Simple musl-based static distro
 
 
 ## Prerequisites


@@ 44,22 44,22 @@ To build Galeb from source, you'll need:
   your daily schedule).
 
 
-## Installation
+## Disclaimer
+
+Galeb is a distro for advanced users, who know how a Unix-like system is
+organized internally. I will not be responsible for any damage resulting from
+not paying attention when needed, lack of will to read documentation, or lack of
+experience in administering a Unix-like system. You have been warned, so please
+pay attention, read the documentation, search the Web and avoid sending
+questions or requests for guidance.
 
-Installation is quite straightforward: adjust `lib/env.sh`, then run the
-numbered scripts, `01-*` to `05-*`. This will leave you with a directory~~`$GR`
-(by default, `$HOME/galeb-root`) containing the files of the root filesystem,
-and a compressed raw disk image made from those files.
+What I will appreciate, and will take into consideration, are patches solving
+potential issues or adding missing _planned_ functionality.
 
-`02-chroot.sh` needs to be run with root privileges, which you will be warned
-about if you try to execute it as a regular user. Other than that, just pay
-attention to on-screen prompts and messages. See [BOOTING][booting] for
-information on what to do next.
 
-**Note:** Files in the created directory `$GR` are configured for a system on
-a USB medium. You should adjust files like `/etc/fstab` and `/etc/rc.conf` (for
-example) if you don't intend on using the raw disk image, and wish to install
-the files directly (for example, with **rsync**(1)).
+## Installation
+
+See [INSTALL][install].
 
 
 ## FAQ


@@ 69,6 69,9 @@ See [FAQ][faq].
 
 ## Known bugs/Errata
 
+* x86\_64 is assumed. Other architectures are not planned for now, although
+  patches supporting them are welcome.
+
 * Packages having dynamic binaries in `/bin` instead of having them in
   `/sucks/bin` (only until a fix):
 {ul}


@@ 122,7 125,7 @@ See git log for details.
 - Rich Felker and others for their work on musl-libc.
 
 - [Derrick][derrick] for his work on Musl-LFS, which served as the initial
-  foundation of Galeb.
+  inspiration for Galeb.
 
 - All the people not explicitly mentioned here which helped make the programs 
   which are used in Galeb.


@@ 139,7 142,7 @@ sources, which might be covered by other compatible licenses).
 In particular, musl-libc is licensed under the Expat (“MIT”)
 license.
 
-Galeb - Simple musl-based static meta distro.  
+Galeb - Simple musl-based static distro.  
 Copyright © 2022 Страхиња Радић
 
 This program is free software: you can redistribute it and/or modify it under


@@ 166,5 169,6 @@ but if you are multi~-booting, that limit can easily be hit.
 [faq]: faq.html
 [galebboot]: ../img/programi/galeb-20-boot-001.png
 [galebsvc]: ../img/programi/galeb-20-svc-001.png
+[install]: install.html
 [licenses]: https://www.gnu.org/licenses/
 [r36]: http://r-36.net/scm/

@@ 0,0 1,59 @@
+---
+site-name: Installation - Galeb
+site-desc: On installing Galeb
+inline-stylesheet: ../index.css
+inline-stylesheet: galeb.css
+canonical: https://strahinja.srht.site/galeb/install.html
+meta: index-meta.tsv
+---
+{main}
+# Installation
+
+Installation is quite straightforward: adjust `lib/env.sh`, then run the
+numbered scripts, `01-*` to `05-*`. This will leave you with a directory~~`$GR`
+(by default, `$HOME/galeb-root`) containing the files of the root filesystem,
+and a compressed raw disk image made from those files.
+
+`02-chroot.sh` needs to be run with root privileges, which you will be warned
+about if you try to execute it as a regular user. Other than that, just pay
+attention to on-screen prompts and messages. See [BOOTING][booting] and
+“[Things to do after booting][ttdab]” below for information on what
+to do next.
+
+**Note:** Files in the created directory `$GR` are configured for a system
+booted from a USB medium. You should adjust files like `/etc/fstab` and
+`/etc/rc.conf` if you don't intend on using the raw disk image, and wish to
+install the files directly (for example, with **rsync**(1)).
+
+
+### Prebuilt boot image
+
+Bootstrap scripts (`01-*` … `05-*`) produce a boot image, which is planned to be
+available to download separately. The boot image contains the compiled packages
+in binary form in `/pkg`, intended to be used on the x86\_64 architecture. When
+booting from this prebuilt boot image, you can login as the user
+“root” with a password “root” (in contrast, you will be
+prompted to set a root password if you build from source).
+
+
+{a#ttdab}{/a}
+### Things to do after booting
+
+* Create regular user accounts with **useradd**(8).
+
+* **rsync** files from the boot USB flash to the prepared hard disk partitions
+  and adjust the configuration files.
+
+* Setup UEFI entries for booting from hard disk (see [BOOTING][booting]).
+
+* After rebooting from hard disk, install more software from source or using the
+  package manager **mkpk**(8).
+
+ 
+{made-by}
+
+{/main}
+
+
+[booting]: booting.html
+[ttdab]: #ttdab