[Fedora-livecd-list] [PATCH 1/4] Minor text fixes
Horst H. von Brand
vonbrand at inf.utfsm.cl
Sun Jan 14 01:38:14 UTC 2007
From: Horst H. von Brand <vonbrand at inf.utfsm.cl> - unquoted
Signed-off-by: Horst H. von Brand <vonbrand at inf.utfsm.cl>
---
HACKING | 1 -
README | 90 +++++++++++++++++++++++++++++++++------------------------------
2 files changed, 47 insertions(+), 44 deletions(-)
diff --git a/HACKING b/HACKING
index 14cc02f..b82b8d9 100644
--- a/HACKING
+++ b/HACKING
@@ -1,4 +1,3 @@
-
SOURCE CONTROL MANAGEMENT
=========================
diff --git a/README b/README
index eb92530..d296d8e 100644
--- a/README
+++ b/README
@@ -1,45 +1,47 @@
- The Fedora live CD tools
+ The Fedora Live CD tools
David Zeuthen <davidz at redhat.com>
Last updated: Dec 22 2006 (v0.1)
+ Fixes: Jan 13 2007
-This project concerns tools to generate live CD's on Fedora based
+This project concerns tools to generate Live CDs on Fedora based
systems including derived distributions such as RHEL, CentOS and
others. See the project Wiki at
- http://fedoraproject.org/wiki/FedoraLiveCD
+ <http://fedoraproject.org/wiki/FedoraLiveCD>
-for more details. Discussion of this project takes places at the
-fedora-livecd at redhat.com mailing list
+for more details. Discussion of this project takes place at the
+<fedora-livecd at redhat.com> mailing list. So subscribe or view the
+archives, go to
- http://www.redhat.com/mailman/listinfo/fedora-livecd-list
+ <http://www.redhat.com/mailman/listinfo/fedora-livecd-list>
This project and it's source files is licensed under the GPLv2
license. See the file COPYING for details.
1. LIVE CD DESIGN GOALS
-The live CD is designed in such a way that the when running from a
-live CD, the system should appear as much as possible as a standard
-system with all that entails; e.g. read-write rootfs (achieved using
+The Live CD is designed in such a way that when running from a live
+CD, the system should appear as much as possible as a standard system
+with all that entails; e.g. read-write rootfs (achieved using
dm-snapshot), standard ext3 file system (for extended attributes) and
-so on.
+so on.
-Another design goal is that the live CD should be ''installable'',
-ie. an user should be able to install the bits from the live CD onto
-his hard disk without this process requiring network access or
-additional media. (NOTE: this feature is not yet implemented)
+Another design goal is that the Live CD should be "installable", i.e.,
+an user should be able to install the bits from the Live CD onto his
+hard disk without this process requiring network access or additional
+media. (NOTE: this feature is not yet implemented)
Finally, another design goal is that the tool set itself should be
-separate from configuration; the same unmodified tool should be usable
-for building various live CD flavors with vastly different
-configurations, e.g. a GNOME live CD, a KDE live CD, a live cd with
+separate from the configuration; the same unmodified tool should be
+usable for building various Live CD flavors with vastly different
+configurations, e.g. a GNOME Live CD, a KDE Live CD, a Live CD with
music programs and so on.
2. CREATING A LIVE CD
-To create a live cd, the livecd-creator tool is used. Super user
+To create a Live CD, the livecd-creator tool is used. Super user
privileges are needed. The tool is more or less self-documenting, use
the --help option to see options.
@@ -48,7 +50,7 @@ the --help option to see options.
In a nutshell, the livecd-creator program
o Sets up a file for the ext3 file system that will contain all the
- data comprising the live CD
+ data comprising the Live CD
o Loopback mounts that file into the file system so there is an
installation root
@@ -59,24 +61,27 @@ In a nutshell, the livecd-creator program
o Installs, using yum, the requested packages into the installation
using the given repositories
- o Looks at live CD configuration files dropped in the directory
+ o Looks at Live CD configuration files dropped in the directory
/etc/livecd/ inside the installation root
- o Optionally installs more packages as specified by the live CD
+ o Optionally installs more packages as specified by the Live CD
configuration files in /etc/livecd/ inside the installation root
- o Optionally runs scripts as specified by the live CD configuration
+ o Optionally runs scripts as specified by the Live CD configuration
files in /etc/livecd/ inside the installation root
o Relabels the entire installation root (for SELinux)
- o Creates a live CD specific initramfs that matches the installed kernel
+ o Creates a Live CD specific initramfs that matches the installed
+ kernel
- o Unmounts the kernel file systems mounted inside the installation root
+ o Unmounts the kernel file systems mounted inside the installation
+ root
o Unmounts the installation root
- o Creates a squashfs file system containing only the ext3 file (compression)
+ o Creates a squashfs file system containing only the ext3 file
+ (compression)
o Configures the boot loader
@@ -91,32 +96,32 @@ The command
--repo=c6,http://download.fedora.redhat.com/pub/fedora/linux/core/6/i386/os \
--package=bash --package=kernel --package=grub
-will create a live CD that will boot to a login prompt. Not that since
+will create a Live CD that will boot to a login prompt. Not that since
no configuration is done the user will not be able to login to the
-system as the root password is not set / cleared.
+system as the root password is not set/cleared.
2.3 LIVE CD CONFIGURATION FILES
-These are files that packages to be included on the live CD can
+These are files that packages to be included on the Live CD can
install in /etc/livecd. They need to be bash scripts and is used to
both specify additional packages to install as well as what system
configuration (such as enabling NetworkManager by default) to do at
-build time. The live cd configurations in /etc/livecd/ are processed
+build time. The Live CD configurations in /etc/livecd/ are processed
in alphabetical order (using the C local).
The rationale behind moving the package manifest + system
configuration into live cd configuration files is that maintainers of
-a certain live cd flavor (say "Acme Music Live CD") can keep all the
+a certain Live CD flavor (say "Acme Music Live CD") can keep all the
relevant bits in an RPM (say acme-livecd-music) and use existing SCM
mechanism to manage it.
-For the Fedora project, there are current three different live CD
-RPM's that contain live CD configuration files; they are
+For the Fedora project, there are current three different Live CD
+RPM's that contain Live CD configuration files; they are
fedora-livecd : the base livecd system
fedora-livecd-gnome : a stock GNOME desktop; suitable for basing
- other more targeted live CD's on such as
+ other more targeted Live CD's on such as
flavors for Eclipse, Music and so forth
fedora-livecd-desktop : complete desktop with applications and
@@ -125,9 +130,9 @@ RPM's that contain live CD configuration files; they are
See the RPM's for details on what configuration they do.
-(NOTE: these are currently available
+(NOTE: These are currently available from
- from http://people.redhat.com/davidz/livecd/
+ <http://people.redhat.com/davidz/livecd/>
but will be proposed for inclusion in Fedora Extras)
@@ -150,16 +155,16 @@ then the following command
--package=fedora-livecd-desktop \
--fslabel=Fedora-6-Zod-LiveCD-1-foo
-will create a live CD called "Fedora-6-Zod-LiveCD-1-foo". The name
-given by --fs-label is used.
+will create a Live CD called "Fedora-6-Zod-LiveCD-1-foo". The name
+given by --fs-label is used.
o as a file system label on the ext3 and iso960 file systems
(as such it's visible on the desktop as the CD name)
o in the GRUB boot loader
-If you don't have the repositories available locally and don't mind waiting
-for the download of packages, the command is
+If you don't have the repositories available locally and don't mind
+waiting for the download of packages, the command is
# livecd-creator \
--repo=c6,http://download.fedora.redhat.com/pub/fedora/linux/core/6/i386/os/ \
@@ -173,18 +178,17 @@ and this should work on any FC6 system.
3. LIVE CD INSTALLS
-Currently there is only a textual live CD installer. It is a bit
+Currently there is only a textual Live CD installer. It is a bit
wonky; to use it first you have to disable SELinux's enforcing
mode. From a root terminal (open a terminal and type 'su -') on the
-live CD do
+Live CD do
# setenforce 0
# service livecd-install-daemon start
Then disable automounting; go into "System -> Preferences -> Removable
Drives and Media" and unclick all check boxes under the tab "Storage",
-heading " Removable Storage". Now open a terminal and run (not as
-root)
+heading "Removable Storage". Now open a terminal and run (not as root)
$ livecd-installer-tui
--
1.5.0.rc1.gb60d
More information about the Fedora-livecd-list
mailing list