Changeset 2140

Show
Ignore:
Timestamp:
11/28/07 06:55:10 (1 year ago)
Author:
alexander
Message:

Updated documentation

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/doc/README.txt

    r2122 r2140  
    142142    $ gtf 1280 1024 85 
    143143 
    144 NOTE: You must specify the refresh rate of 60 Hz for VGA-connected LCD monitors. 
     144[NOTE] 
     145You must specify the refresh rate of 60 Hz for VGA-connected LCD monitors. 
    145146 
    146147Then look at the output: 
    …… 
    202203 
    203204It is possible to burn a customized version of the official Linux From 
    204 Scratch LiveCD, with your own files added. To do that, follow the 
    205 instructions in the /root/lfscd-remastering-howto.txt file. 
     205Scratch LiveCD, with changed default boot parameters and/or your own files 
     206added. 
     207 
     208To change the default boot arguments, follow these steps as root. 
     209 
     210 * Create directories: 
     211 
     212    export WORK=/mnt/lfslivecd 
     213    mkdir -p $WORK/{orig,copy} 
     214         
     215 * Copy all files except root.ext2 from the original image: 
     216 
     217    mount -t iso9660 -o loop lfslivecd-[version].iso $WORK/orig 
     218    cp -a $WORK/orig/*/ $WORK/copy/ 
     219    umount $WORK/orig 
     220         
     221 * Copy the compressed root.ext2 file without uncompressing it: 
     222 
     223    mount -t iso9660 -o loop,norock lfslivecd-[version].iso $WORK/orig 
     224    cp $WORK/orig/root.ext2 $WORK/copy/ 
     225    chmod 644 $WORK/copy/root.ext2 
     226    umount $WORK/orig 
     227         
     228 * Edit the boot loader configuration: 
     229 
     230    # Append new kernel options to the "append" lines 
     231    vim $WORK/copy/boot/isolinux/isolinux.cfg 
     232         
     233 * Create the new LiveCD image: 
     234 
     235    mkisofs -z -R -l --allow-leading-dots -D -o \ 
     236        lfslivecd-[version]-custom.iso -b boot/isolinux/isolinux.bin \ 
     237        -c boot/boot.cat -no-emul-boot -boot-load-size 4 -boot-info-table \ 
     238        -V "lfslivecd-[version]" $WORK/copy 
     239 
     240[NOTE] 
     241You cannot change the volume label of the customized CD (i.e., the 
     242argument to the "-V" option) this way. The "-nosrc" suffix is not part of 
     243the volume label and should be left out, but "-min" should be preserved. 
     244If in doubt, you can find out the correct volume label by running this command: 
     245 
     246    file lfslivecd-[version].iso 
     247 
     248To add or remove files, follow the instructions in the 
     249/root/lfscd-remastering-howto.txt file instead. 
    206250 
    207251AUTOSSHD 
    …… 
    268312parameter to the X server command line there. 
    269313 
    270 BRAILLE DISPLAY SUPPORT 
    271 ----------------------- 
     314ACCESSIBILITY 
     315------------- 
     316 
     317The Live CD includes software (BRLTTY and speakup) that make the contents 
     318of the Linux text console accessible to visually-impaired users. This 
     319software is not started by default, and special boot parameters (documented 
     320below) are needed in order to use it. 
     321 
     322Unfortunately, the boot loader expects the parameters to be entered with 
     323US English keyboard layout, which is not familiar to non-US users, and they 
     324cannot see their mistakes. Thus, it is recommended for such users to 
     325customize default boot parameters of the CD as described above instead of 
     326trying to type them at the boot prompt. 
     327 
     328### BRAILLE DISPLAY SUPPORT ### 
    272329 
    273330The LiveCD includes the "brltty" program that allows a blind person to read 
    …… 
    294351wrong result in the ru_RU.CP1251 locale. 
    295352 
    296 ### Known non-working cases ### 
     353#### Known non-working cases #### 
    297354 
    298355 * All CP1251-based locales (no CP1251 Braille table in "brltty") 
    …… 
    311368<livecd@linuxfromscratch.org>. 
    312369 
    313 SPEECH OUTPUT WITH SPEAKUP 
    314 -------------------------- 
     370### SPEECH OUTPUT WITH SPEAKUP ### 
    315371 
    316372This CD includes a development version of Speakup (because no stable versions 
    …… 
    402458testsuite may lead to failures that would not occur otherwise. 
    403459 
    404 NOTE: you must unmount all USB flash drives and all partitions used by other 
     460[NOTE] 
     461You must unmount all USB flash drives and all partitions used by other 
    405462operating systems installed on your computer before hibernating! Do not 
    406463attempt to mount partitions used by a hibernated system from other systems 
    …… 
    463520 * as user "jhalfs", follow the instructions in the jhalfs README file 
    464521 
    465 Note that this user already has the required root access (via "sudo") to 
    466 complete the build. 
     522This user already has the required root access (via "sudo") to complete 
     523the build. 
    467524 
    468525LOADING CD CONTENTS TO RAM 
    …… 
    478535RAM, add swap when the CD boot finishes. 
    479536 
    480 NOTE: in order to save RAM, sources and proprietary drivers are not loaded 
     537[NOTE] 
     538In order to save RAM, sources and proprietary drivers are not loaded 
    481539there. In order to access them, please mount this CD and look into 
    482540/media/cdrom/sources and /media/cdrom/drivers. 
    …… 
    800858order given above and in various combinations if the CD does not boot, or if 
    801859a device does not work correctly or fails after hibernating and resuming. 
    802 Note: if this helps, the bug is in the hardware or the BIOS, not in this CD. 
     860If this helps, the bug is in the hardware or the BIOS, not in this CD. 
    803861 
    804862THANKS 

  • trunk/doc/lfscd-remastering-howto.txt

    r2124 r2140  
    1 AUTHOR:         Alexander E. Patrakov <patrakov@ums.usu.ru>, Sylvie Migneault <alisou@alixe.org> 
    2  
    3 DATE:           2007-08-28 
     1AUTHOR:         Alexander E. Patrakov <patrakov@gmail.com>, Sylvie Migneault <alisou@alixe.org> 
     2 
     3DATE:           2007-11-28 
    44 
    55LICENSE:        GNU Free Documentation License Version 1.2 
    …… 
    9797 
    9898In the chroot, change the current directory to /build, and install any 
    99 additional packages you want. Modify other files as necessary. 
     99additional packages you want. Modify other files as necessary. If you want 
     100to compile a new kernel, please include the following options: 
     101        CONFIG_MD=y 
     102        CONFIG_BLK_DEV_DM=y 
     103        CONFIG_DM_SNAPSHOT=y 
     104        CONFIG_EXT2_FS=y or m 
     105        CONFIG_ISO9660_FS=y or m 
     106        CONFIG_ZISOFS=y 
    100107 
    101108Generate initramfs images for your CD by running the create-initramfs command 
    102109for each kernel. This command accepts the following parameters: the LiveCD 
    103110version, the kernel version, and the name of the initramfs file to create. 
     111For self-compiled kernels, the list of directories to search for modules is not 
     112accurate, and you can either ignore "no such file" errors (if you feel lucky) 
     113or edit the /usr/bin/create-initramfs script. For the default LiveCD kernel, 
     114the shipped script should just work. 
    104115 
    105116For x86: 
    …… 
    112123(you can replace the "6.3-custom" with your own string). This produces the 
    113124initramfs_data.cpio.gz and possibly initramfs_data64.cpio.gz files in the 
    114 current directory. Copy them to /build: 
     125current directory. Copy them (and kernel bzImages, if you have built any) 
     126to /build: 
    115127        cp initramfs_data*.cpio.gz /build 
    116128 
    …… 
    152164        cp -r /media/cdrom/*/ $WORK/iso 
    153165 
    154 Replace the stock initramfs images with your own: 
     166Replace the stock initramfs images (and, possibly, kernel images) with your 
     167own: 
    155168        cp $WORK/build/initramfs_data*.cpio.gz \ 
    156169            $WORK/iso/boot/isolinux/ 
    …… 
    190203   [2007-10-21] 
    191204    * Updated for the new create-initramfs script 
     205 
     206   [2007-11-28[ 
     207    * Updated my e-mail address 
     208    * Added kernel instructions