[pocket-linux] Suggestions for PLG 2.0 (termcap/terminfo typo, missing gzip in App. A)

[Alexander Sieck]

First many thanks to David Horton for his Pocket Linux Guide.
I went through the guide and learned a lot.

I refer to Revision 2.0 as of 2003-11-08  Revised by: DH
(file date is 2003-11-10).

Here are some suggestions for small improvements ( created
with $> diff -U 3 Pocket-Linux-Guide.txt.orig Pocket-Linux-Guide.txt :


--- Pocket-Linux-Guide.txt.orig	Fri Jan  2 16:51:56 2004
+++ Pocket-Linux-Guide.txt	Fri Jan  2 18:11:12 2004
@@ -135,7 +135,7 @@
 and although this is highly unlikely, the author(s) do not take any
 responsibility.
 
- All copyrights are held by their by their respective owners, unless
+ All copyrights are held by their respective owners, unless
 specifically noted otherwise. Use of a term in this document should not be
 regarded as affecting the validity of any trademark or service mark. Naming
 of particular products or brands should not be seen as endorsements.
@@ -706,6 +706,10 @@
 bash# ./configure --enable-minimal-config --host=i386-pc-linux-gnu           
 bash# make                                                                   
 bash# strip bash                                                             
+
+Remark: After "make distclean" I (Alexander) could not rebuild bash due
+        to some missing tools. A "make clean" works on my system (Debian 3.0,
+	woody).
 -----------------------------------------------------------------------------
 
 3.3.3. Determine which libraries are required
@@ -2025,6 +2029,14 @@
 bash# mknod tty5 c 4 5                                                       
 bash# mknod tty6 c 4 6                                                       
 bash# mknod tty c 5 0                                                        
+
+Remark: Once you get more familiar with BASH, you will create tty0 to tty6
+        with the BASH "for" statement, e.g.:
+	bash# for i in $(seq 7); do
+	    >     let $((i--))
+	    >     mknod tty$i c 4 $i
+	    > done
+
 -----------------------------------------------------------------------------
 
 7.3.4. Create support files in /etc
@@ -2717,6 +2729,9 @@
 information about the subject of curses, see John Strang's book entitled
 "Programming with Curses" available from O'Reilly publishing at [http://
 www.oreilly.com] http://www.oreilly.com.
+
+We further need to install the gzip binary in order to uncompress the
+usr-image, if we did not already in Sec. "9.2 Planning Next Steps".
 -----------------------------------------------------------------------------
 
 A.2.5. Summary of tasks
@@ -2734,6 +2749,8 @@
   * Create a startup script to load a compressed image from floppy into a
     ramdisk and mount the ramdisk on /usr.
    
+    * Install gzip on the root disk.
+
   * Create a compressed floppy that holds the mp3blaster program, its
     required libraries and terminfo files.
    
@@ -2811,6 +2828,10 @@
 bash# mknod -m 640 ~/staging/dev/ram5 b 1 5                                  
 bash# mknod -m 640 ~/staging/dev/ram6 b 1 6                                  
 bash# mknod -m 640 ~/staging/dev/ram7 b 1 7                                  
+
+Alternatively, do these steps in one single step:
+bash# for i in $(seq 7); do mknod -m 640 ~/staging/dev/ram$i b 1 $i; done
+
 -----------------------------------------------------------------------------
 
 A.3.2.1.3. Audio
@@ -2854,7 +2875,18 @@
 bash# ln -s ../init.d/usr_image ~/staging/etc/rcS.d/S21usr_image             
 -----------------------------------------------------------------------------
 
-A.3.2.3. Create a compressed root disk
+A.3.2.3 Install gzip, gunzip and zcat binaries
+
+bash# cd /usr/src/gzip-1.2.4a
+bash# ./configure --host=i368-pc-linux-gnu
+bash# make
+bash# cp gzip ~/staging/bin/
+bash# cd ~/staging/bin
+bash# ln gzip gunzip
+bash# ln gzip zcat
+------------------------------------------------------------------------------
+
+A.3.2.4. Create a compressed root disk
 
 bash# cd /                                                                   
 bash# dd if=/dev/zero of=/dev/ram7 bs=1k count=4096                          
@@ -2870,12 +2902,9 @@
 bash# dd if=~/phase8-image.gz of=/dev/fd0 bs=1k                              
 -----------------------------------------------------------------------------
 
-A.3.2.4. Unmount the root disk
-
-bash# cd /                                                                   
-bash# umount /mnt                                                            
-bash# sync                                                                   
------------------------------------------------------------------------------
+Remark (Alexander): "umount /mnt" makes no sense here, since we already
+                    did "umount /dev/ram7" .
+------------------------------------------------------------------------------
 
 A.3.3. Create a compressed /usr disk for mp3blaster
 
@@ -2890,7 +2919,7 @@
 bash# mkdir ~/usr-staging                                                    
 bash# cd ~/usr-staging                                                       
 bash# mkdir bin lib                                                          
-bash# mkdir -p share/termcap/l                                               
+bash# mkdir -p share/terminfo/l                                               
 -----------------------------------------------------------------------------
 
 A.3.3.2. Install the mp3blaster program

 --- end of diff output ---