  
  Tested CCE 0.50 on Minix 2.0.3(x86, /dev/mem file mode, slow) and 
  Minix-vmd 1.7.0(x86, Direct VGA mmap mode). 
  
  Minix website: 
  Minix:     http://www.cs.vu.nl/~ast/minix.html
  Minix1:    http://minix1.hampshire.edu  
  Minix-VMD: http://www.minix-vmd.org 
    It's a superset of standard Minix that provides virtual
    memory and support X11. This is a 32 bit version of Minix.
    Also from cs.vu.nl Minix-VMD = 32bit Minix + virtual memory + X11
    1996 Minix-vmd 1.7.0  
	2003 Minix-vmd 2.0.x (current tree)
    You can update Minix-vmd to 2.0.1 from http://www.minix-vmd.org/current,
	it includes some new device drivers(like 3Com NIC support)


 1. How to install Minix/Minix-vmd

  Please check Minix websites for detailed information, just a brief introduction
  here:

  1) in Linux: cat ROOT.MNX USR.MNX > /dev/fd0
  2) boot floppy
     For Minix-vmd:       type /dev/fd0c for /usr  
	 For Minix 2.0.3:     type /dev/fd0p2 for /usr
  3) login as root and run 'setup'
  4) partition your hard drive 
     For Minix-vmd: you need to use '>' to make sub-partition a/b/c
	 For Minix:     setup will make sub partitions for you.
  5) type 'halt' to Boot Monitor
     For Minix-vmd:   boot hd[1234]a   (pick the right partition number)
	 For Minix 2.0.3: boot c0d0pN      (N is the partition number starting from 0)
  6) install USR.TGZ(full /usr commands) & SRC.TGZ(*.h manual, source)
     For Minix-vmd: in /usr, do gzcat USR.TGZ | tar xvfp -
     For Minix:     in /usr, do zcat  USR.TAZ | tar xvfp -

  You can use floppy disks to transfer the *.TGZ/*.TAZ to Minix/Minix-vmd, or you
  can use a FAT parition to do it(you can use mtools in Minix to access FAT partition)

  mtools in Minix-VMD 1.7.0
  mdir /dev/hd1:    (or other DOS partition)
  mcopy /dev/hd1:/dir/filename ...    It does support long filenames.

  mtools in Minix 2.0.3
  mtools dir /dev/c0d0pN:
  mtools copy /dev/c0d0pN:/dir/filename ...


 2. How to install CCE on Minix-vmd? 

   ./configure --build=i386-minixvmd
   make
   make install

   Because autoconf/automake's config.guess can't get the correct host information
   for Minix-vmd, so you need to supply the build variable.

   If you have some memory allocation failures, try to use chmem to change the
   memory requirement of CCE. (man chmem first)

   CCE will use 640x480x16 colors mode. The keys are different in Minix-vmd,
   all the commands use prefix CTRL-Q(can be changed in source code)

    Ctrl-q SPACE    switch between Chinese/English input
	Ctrl-q .        switch between Chinese/English punctuation
    Ctrl-q w        switch between full-width and half-width 
	Ctrl-q x        eXit a window
	Ctrl-q r        Repaint the whole window
	Ctrl-q l        enable/dissable LianXiang 
	Ctrl-q k        change the Keyboard map
	Ctrl-q 0-9      switch to input method 0-9

    You can input Chinese directly on Minix 2.0.3/Minix-vmd 1.7.0's default shell.


 3. How to install CCE on Minix 2.0.x?

   ./minixsetup.sh    To copy some symbolic-linked files(Minix doesn't support it)
                      chmem for shell/compiler, otherwise compilation will fail
   ./configure        Just ignore the last error
   make
   make install

   Minix 2.0.3 is distributed with ACK C compiler, can't understand gcc's C 
   externsion. Its assembler uses different syntax.

   You need a lot more memory space for cin2tab, possibly 16384000(16MB)
   Or you can install those compiled *.tab files. Key assignment is the
   same as in Minix-vmd.

   By default Minix 2.0.3 doesn't configure any pseudo terminals
   modify NR_PTYS in /usr/include/minix/config.h (say, make it 4)
	  NR_CONS  system console(1-8)    /dev/conN
      NR_PTYS  pseudo terminals(0-64) /dev/ptypN /dev/ttypN
	 
   then recompile and install the new Minix kernel, reboot.
	  cd /usr/src/tools
	  make
	  cp image /minix

   Since standard Minix doesn't support any mmap(not even video ram mapping like
   in Minix-vmd), so I'm using /dev/mem for file operation. It's slow, but works :)


  KNOWN PROBLEMS:

  1) No virtual terminal switching handling, don't know how to do it
     in Minix-vmd. Minix-vmd doesn't support POSIX style VT_GETMODE (AUTO/PROCESS)
	 VT switching handling. So you CAN'T use ALT-Fn to switch terminals
	 while CCE is running.
  2) Keyboard handling, use a simpler approach like screen/minicom, use a CTRL-xxx prefix
	 then an ASCII command.
  3) No multiple window support in Minix, Ctrl-Alt-A/N/P does not work
  4) No mouse support in Minix-vmd.
  5) After CCE exits, console terminal may have a garbage text screen,
     press a few keys to recover.
  6) No select() system call in Minix, so using nonblocking read and loop forever,
     the cursor is flashing too frequently.
  7) Due to the memory management limit of Minix/Minix-vmd, some/most input methods
     can't be compiled using cin2tab, but you can copy *.tab and use them.
	 zhiyin.tab/ciyin.tab is ok, but sometimes Minix will fail on memory allocation.
	   chmem =16384000 inputs/utils/cin2tab (16MB memory)

  8) For Minix-vmd: If CCE can't start, you can try commenting out the font jis/8x16rk.bin	
     in cce.cfg.  Don't know why it's not working with 8x16rk.bin(cce only, 
	 cceb5/ccejis/cceksc works, strange!)  zhiyin.tab doesn't work on cceksc.



