Note:   Xdos is something like windows's DosPrompt. You CANNOT run
        any graphic programs under xdos.
            Many programs can kill xdos.  You are lucky if your prgrams can 
        run under xdos smoothly.
	
	You should also thank the authors of dosemu.

---------- :-<  :-<
	If you don't like Xdos, you should write a better one to replace it.
	Do not delete xdos files on sunsite:/pub/Linux/Incoming.
        Xdos0.3e was deleted last time. You have no right to decide whether
        people may try xdos.

-----------------------------------------------------------------------
  The xdos0.3c doesn't work under later versions of linux because I forgot 
to add the -N option while compiling xdos.
  The installation guide should be better this time.


Xdos0.3f is available at
	1. sunsite.unc.edu	/pub/Linux/Incoming
	   (will probably be moved to /pub/Linux/ALPHA/dosemu )
	2. 140.112.28.163    (earth.csie.ntu.edu.tw, DNS problem)
	   /pub/Linux

Features:
	. Running under X window. ( So you can set DISPLAY to other machines )
	. 80x25 COLOR term   ( It only runs on a color VGA )
	. ALT keys and func keys work. (They don't work under xterm)
	. Xterm's scroll bar and copy-paste buffer
	. Dos text int 33 mouse driver (not fully implemented yet)
          (dos's dosshell, edit, qbasic work)

Changes:
version 0.3f:
	1. The missing character problem under dos prompt is gone.
        2. The hiding cursor works this time.
	3. Adding DOS_USE_HDIMAGE environment varible opt.
	   You can use a different name for hdimage.
	4. Example shell-script on how to use physical hdisk
	   ( /dev/hd? only,   whole physical disk)
            
version 0.3d:
	1. Add -N flag to xdos compiling flag that xdos can run on later
           versions of kernel(linker).
	2. dosemu0.49-like emu file system support.
	3. No more 15-char-paste-buffer constraint.
	4. The screen color is more pc-text-mode-like.
	5. Ability to eliminate dos app's keyboard-idle-loop.
           The CPU useage should be less than 10% on a 486/DX33.
	6. Pressing Enter will flush the floppy dirve.
           (Press CTL+left mouse button to select menu and disable this feature)
	7. You can use a file as A: and boot from it.
        8. Fix some screen-clear bugs.
        9. Fix scan_code bugs.  Qedit's keypad keys '/ * -' should work now.
	
--------------------------------------------------------------------------


	0. Run
	   # install.font
             It will install the vga font.
	   Remember to mount your dos file system as
	   /dosc  (Must contain any editor program)

	1. # cp libxdosemu /lib
	2. # chmod 4755 xdos	( set root uid for this file )
	3. # chown root xdos
	4. Note that xdos' hdimage is different from dosemu0.49pl2
           You have to build a hdimage for xdos.
	5. Make a dos bootable disk in A: with fdisk.exe ,sys.com

	6. 	% xd.fd              under xdos directoy
           will boot xdos from the floppy drive A:

	7. 	A>sys c:
		A>c:
	   Xdos like dosemu0.49 can let dos use linux file system.
           Your dos file system /dosc should be D: now.
	   Modify config.sys & autoexec.bat in C: if necessary.
	   
	8. modify 'xd' if necessary.
	   Add ' > /dev/null' if you don't like the debug message.
	9. % xd
		
             You've finish installing xdos. 
	     You should try combinations below.

.  How to create a bootable fdimage
	# dd if=/dev/zero of=fdimage count=2400
        # xd.ca
	
        C>format a:/s

.  Useful shell-scripts
        xd  :   boot from hdimage, doesn't use fdimage
	xd.fd : boot from /dev/fd0, use hdimage, doesn't use fdimage
	xd.a : boot from fdimage, doesn't use hdimage
	       (Useful:  The drive C: in real DOS is still C: under xdos)
	xd.ca : boot from hdimage, use fdimage
	xd.ac : boot from fdimage, use hdimage
	xd.hda :   example shell script on how to use /dev/hda

        The filename 'fdimage' can be changed by modifying the shell-scripts


. You can enable/disable HD write-protect at any time.
	   ( Press CTRL and the left button of your mouse, then you can see a
	     menu )
  	This function only works for hdimage and /dev/hd?
. Pressing the three buttons of mouse at the same time can enable/disable
  mouse driver

. The xdos will enter mouse-mode automatically when dos apps call mouse driver.
  The copy-paste function doesn't work under mouse-mode.

Options:
-chtr
   /* Use vga font. You must also change font option -fn 10x20 to -fn vga */
-mousedrv /* Enable text mouse driver */
-hd_head ??        /* physical HD   /dev/hd? */
-hd_cyl ???
-hd_sec ??
-imhd_head ??      /* your hdimage file */
-imhd_cyl ?? 
-imhd_sec ??

Note:  If you can use linux's msdos file system, you should avoid using
   physical HD.

---
Edward Der-Hua Liu
dhliu@solar.csie.ntu.edu.tw
