VDP.TXT -- Documentation for VDP.BAT and VDPALIAS.BAT
C.L. Distefano rev.9/18/16

VDP.BAT is a Windows batch file that allows you to launch Wengier Wu's
vDosPlus with or without command-line configuration parameters.

VDP.BAT allows you to save configuration arguments with a simple nickname,
or "alias". Aliases are saved in a separate file, VDPALIAS.BAT. See "Setting
Aliases in VDPALIAS.BAT", below.

New in rev.8/10/16:
Configuration setting saved in a file named CONFIG.ext can be launched by
commanding, simply: VDP.BAT ext.

vDosPlus's README.TXT has instructions for setting configuration options
on the Windows (CMD.EXE) command line.

Note: There is a companion U2 routine, VDP,VDP/, for XyWrite 4 with the
XyWWWeb Jumbo U2 customization file loaded. It is packaged as VDP.FRM, in
VDP.ZIP: download: <http://users.datarealm.com/ammaze/xy/VDP.ZIP>. The
command- line usage for U2 frame VDP is the same as for VDP.BAT; for
example, VDP /cfg config.new<Helpkey> (see "VDP.BAT Usage", below).
Alternate frame VDP/ quits the current XyWrite session upon loading the new
vDosPlus session. VDP,VDP/ is included in the current update of the Jumbo
U2; download at XyWWWeb: <http://users.datarealm.com/xywwweb/>.
========================================================================

VDP.BAT Usage
-------------

Usages
......
1) Launch vDosPlus without command-line arguments:
   VDP.BAT

2) Launch vDosPlus with command-line arguments:
   VDP.BAT [vDosPlus arg(s) here]

3) Launch using config.ext (same as VDP.BAT /cfg config.ext):
   VDP.BAT ext

4) Launch using config.ext and set additional config options:
   VDP.BAT ext /set option1=value1; option2=value2; ...

5) Launch using settings saved as an "alias" in VDPALIAS.BAT:
   VDP.BAT [alias_name]

6) Launch using internal vDosPlus settings:
   VDP.BAT D

Examples
........

Start vDosPlus using your current config.txt and autoexec.txt:
  VDP.BAT

Start vDosPlus using config.new:
  VDP.BAT /cfg config.new

Start vDosPlus using config.new (short form):
  VDP.BAT new

Start vDosPlus using specified config and autoexec files and additional
settings:
  VDP.BAT /cfg config.pnk /set autoexec=autoexec.pnk; title=Xy-Pink

Start vDosPlus using specified config and autoexec files and additional
settings (short form):
  VDP.BAT pnk /set autoexec=autoexec.pnk; title=Xy-Pink

Start vDosPlus using a configuration alias "pink":
  VDP.BAT pink

To set up the alias "pink", you would edit VDPALIAS.BAT to add a three-
line subroutine, like this:

:pink
set VDPargs=/cfg config.pnk /set autoexec=autoexec.pnk; title=Xy-Pink
goto :eof

Setting Aliases in VDPALIAS.BAT
-------------------------------
Collect your VDP.BAT aliases in VDPALIAS.BAT. There are examples in
VDPALIAS.BAT; see also example ":pink", above.

Aliases are constructed as batch-file subroutines, using the following
model:

:Alias_name
set VDPargs=[vDosPlus args here]
goto :eof

Alias_name may not contain the forward slash (/) or blank spaces.

If Alias_name is the same as a config file extension, the config file
takes precedence. For example, if you have both a config.drk and an alias
named "drk", commanding VDP.BAT drk will load the config.drk settings, not
the drk alias settings. For this reason, alias names generally should be
different from config file extensions.
========================================================================
