Xwoaf Construction Outline and Details

========
OUTLINE: (details below)
1 Unpack the bare xwoaf tree
2 Primary app selection
 a Either Select OXElmo
  1 configure your email account info in root/.elmorc
 b or Select rdesktop RDP client
  1 configure rdesktop with user, optional password and target host
3 CONFIGURE MOUSE
4 CONFIGURE KERNEL MODULES
 a copy desired new modules
 b configure module loading at boot
5 VIDEO KERNEL SELECTION AND SETTING
 a Either Select Framebuffer X and kernel:
  1 select the matching framebuffer kernel
  2 Setting framebuffer kernel video mode (X follows kernel)
  3 Set kernel boot video mode
  4 select the matching unwoaf script
 b Select Xvesa and vesa kernel
  1 configure X resolution and color depth
  2 select the matching vesa kernel
  3 select the matching unwoaf script
6 Make a new boot floppy image and copy to floppy

========
DETAILS:
------------------------------
# 1 Unpack the bare xwoaf tree
rm -rf woaf-ref #remove old/stale build
tar xzpf woaf-ref-0.2.0g-bare.tgz
cd woaf-ref

-------------------------
# 2 Primary app selection
#  a Select OXElmo or rdesktop to install:
#    install OXElmo email client
tar xzpf ../oxelmo-0.2.0g.tgz

#   1 configure your email account info in root/.elmorc
<your favorite editor> root/.elmorc 
# follow the instructions in woaf-ref/README.htm about configuring OXElmo.

   ---
#  b or Select rdesktop RDP client
tar xzpf ../rdesktop-0.2.0g.tgz
#   1 configure rdesktop with user, optional password and target host
#     for rdesktop help see ../doc/rdesktop.htm
<your favorite editor> root/.jwmrc # line# 11 contains configuration info

-------------------
# 3 CONFIGURE MOUSE
#   default mouse is a softlink to psaux.
#   if you have a serial mouse, say, on COM1 then to change it:
cd dev
rm mouse
ln -s ttyS0 mouse
cd ..

----------------------------
# 4 CONFIGURE KERNEL MODULES
#  a copy desired new modules
#   copy any desired new modules from ../modules-2.2.25 to lib/modules
#   e.g. to load the msdos fs module:
cp -apf ../modules-2.2.25/fs/msdos.o lib/modules/.
# check the file ../modules-2.2.25/modules.dep to ensure all required modules
# are copied.

#  b configure module loading at boot
#    to load the new modules and/or reconfigure your network card from the 
#    default NE2000, edit the file etc/rc.d/sysinit at line# 128 to load 
#    new modules at boot
<your favorite editor> etc/rc.d/sysinit

--------------------------------------
# 5 VIDEO KERNEL SELECTION AND SETTING
#  a Either Select Framebuffer X and kernel:
tar xzpf ../xfbdev-0.2.0g.tgz
#   no X configuration options need to be set
cd ..
#   1 select the matching framebuffer kernel
cp -apf bzImage-0.2.0g-fb bzImage

#   2 Setting framebuffer kernel video mode (X follows kernel)
#     The table for the Kernel mode numbers (hex decimal) are:
#
#     |  640x480     800x600    1024x768    1280x1024
#-----+----------------------------------------------
# 256 | 0x301 769 | 0x303 771 | 0x305 773 | 0x307 775
# 32k | 0x310 784 | 0x313 787 | 0x316 790 | 0x319 793
# 64k | 0x311 785 | 0x314 788 | 0x317 791 | 0x31A 794
# 16M | 0x312 786 | 0x315 789 | 0x318 792 | 0x31B 795

#   3 Set kernel boot video mode
rdev -v bzImage -3 # -3 prompts the user for mode

#      When prompted at boot, use the hex number without the 'x' from 
#      the above table. e.g. 0314 for 800x600x64k
#      or
#      explicitly set video mode using the decimal number from the above table
#      rdev may not understand hex so decimal 788 is 800x600x64k
rdev -v bzImage 788

#   4 select the matching unwoaf script
cp -apf unwoaf-fb unwoaf

   ---
#  b or Select Xvesa and vesa kernel
tar xzpf ../xvesa-0.2.0g.tgz
#   1 X resolution and color depth
#    default is 800x600x256 at line# 95
<your favorite editor> etc/rc.d/sysinit
cd ..

#   2 select the matching vesa kernel
cp -apf bzImage-0.2.0g-vesa bzImage

#   3 select the matching unwoaf script
cp -apf unwoaf-vesa unwoaf

---------------------------------------------------
# 6 Make a new boot floppy image and copy to floppy
./makewoaf.sh
#   after building the inird image, makewoaf.sh will prompt for a floppy.
#   Pay attention to the size and ensure that 'xxxxxxx total' is less than
#   the '1474560 bytes max' before copying to floppy.
