чување be5868c411b795bf43f4f5286cf6e1450f5b2a35
родитељ 4646cefbe51fb9a841b2671ec15560c2736e2931
Аутор: Страхиња Радић <contact@strahinja.org>
Датум: Sun, 14 Aug 2022 21:10:33 +0200
Documentation touchups
Signed-off-by: Страхиња Радић <contact@strahinja.org>
Diffstat:
измењених датотека: 5, додавања: 57(+), брисања: 25(-)
diff --git a/BOOTING b/BOOTING
@@ -6,20 +6,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
-------------
@@ -89,7 +75,8 @@ assumes an UEFI/GPT system.
/dev/sda1 /boot vfat (32-bit) ~500MB
/dev/sda2 / ext4 Rest
-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
diff --git a/BUGS b/BUGS
@@ -1,6 +1,9 @@
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):
- LibreSSL
diff --git a/INSTALL b/INSTALL
@@ -1,6 +1,23 @@
Galeb 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.
+
+What I will appreciate, and will take into consideration, are patches solving
+potential issues or adding missing _planned_ functionality.
+
+
+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
@@ -8,10 +25,35 @@ 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 for information on what
-to do next.
+attention to on-screen prompts and messages. See BOOTING and "Things to do after
+booting" 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).
+
+
+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).
-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)).
+* After rebooting from hard disk, install more software from source or using the
+ package manager mkpk(8).
diff --git a/README b/README
@@ -1,7 +1,7 @@
Galeb README
============
-Galeb is a meta distro with a focus on simplicity.
+Galeb is a static distro with a focus on simplicity.
Questions
@@ -19,8 +19,8 @@ Thanks
- Rich Felker and others for their work on musl-libc.
-- Derrick[1] for his work on Musl-LFS, which served as the initial foundation
- of Galeb.
+- Derrick[1] for his work on Musl-LFS, which served as the initial inspiration
+ for Galeb.
- All the people not explicitly mentioned here which helped make the programs
which are used in Galeb.
diff --git a/fil/man/man8/galeb.8 b/fil/man/man8/galeb.8
@@ -4,7 +4,7 @@
.Os Galeb 2.0
.Sh NAME
.Nm Galeb
-.Nd simple musl-based static meta distro
+.Nd simple musl-based static distro
.Sh DESCRIPTION
.Nm
is a distribution of musl/Linux which is inspired by and based on parts of
