home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / xlist.zip / XLIST.DOC < prev    next >
Text File  |  1993-03-22  |  57KB  |  1,445 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                           Xlist
  22.  
  23.                                           DISK MANAGER
  24.  
  25.                                           USERS GUIDE
  26.  
  27.                                           for the
  28.  
  29.                                           MS-DOS & OS/2
  30.  
  31.  
  32.  
  33.                                           by
  34.  
  35.                                           GARY W. WOOD
  36.  
  37. Xlist User Manual
  38. ==================================================================
  39.  
  40.                    *** READ CAREFULLY BEFORE USING XLIST ***
  41.                            PROGRAM LICENSE AGREEMENT
  42.  
  43. Xlist is NOT "Public Domain" and it is NOT "Freeware".  Xlist is
  44. a copyrighted software product developed and owned by Gary W. Wood.
  45. Xlist is distributed under the shareware concept.  You are free to
  46. copy and use the software for personal use and shareware
  47. distribution in its original, unmodified form provided no fee
  48. beyond reasonable media and/or shipping charges is levied.
  49.  
  50. If you are using the software for personal use, you're required to
  51. license the software after a 21 day evaluation period for $25 and
  52. become a Xlist supporter.  Xlist supporters will receive the next
  53. major release free of charge and be keep informed of major
  54. developments for one (1) year.  A license is required for use of
  55. Xlist by corporations and institutions, and for its commercial
  56. distribution.  You may obtain a license for the use of Xlist by
  57. writing to me.  The license is for perpetual, non-exclusive use of
  58. any version.  Purchase orders and invoicing are acceptable.  If you
  59. have special requirements, such as licensing for an unlimited
  60. number of copies, local area networks, site licenses, or
  61. customization, please feel free to submit them in writing.  You may
  62. request a license for:
  63.  
  64.       o     an unlimited number of end user copies at a single site;
  65.       o     customization of messages and documentation,  an
  66.             additional fee may be required depending on the extent of
  67.             changes;
  68.       o     permission to distribute within your organization;
  69.       o     permission to include with your company's commercial
  70.             products;
  71.  
  72. The fee for a license depends on the estimated number of copies of
  73. the program that you will use.  If you wish to distribute Xlist
  74. with your own programs or hardware, write for a "Marketing
  75. License".  To use the discount schedule below, estimate the total
  76. number of copies that you may eventually use.
  77.  
  78.      2 to  9 computers ..... at $20 each
  79.     10 to 24 computers ..... at $16 each
  80.     25 to 49 computers ..... at $13 each
  81.     50 to 99 computers ..... at $10 each
  82.     100 or more computers .. $1000 one time fee
  83.  
  84. Regardless of the quantity, only one set of materials will be sent
  85. to you.  You may then make as many copies of it that are licensed.
  86. Maintenance is free.  Upgrades will be made available upon request.
  87. Technical support is available via mail, or through the Compuserve
  88. bulletin board systems (76156,317), at no charge.
  89. Xlist User Manual
  90. ===================================================================
  91.  
  92.                      Copyright (C) 1985-1992 Gary W. Wood
  93.  
  94.  
  95.  
  96. If you use Xlist after the 21 day evaluation period a license fee
  97. of $25 will register you to receive a current version of Xlist.
  98. Please state the current version of Xlist that you have.  Send
  99. contributions to:
  100.  
  101.             Gary Wood
  102.             5401 Lakeview Road
  103.             North Little Rock, Arkansas  72116
  104.  
  105. All rights reserved.  Printed in the United States of America.  No
  106. part of this publication may be reproduced, stored in a retrieval
  107. system, or transmitted in any form or by any means, electronic,
  108. mechanical, photocopying, recording, or otherwise without the prior
  109. written permission from Gary W. Wood, 5401 Lakeview Road, North
  110. Little Rock, Arkansas, 72116.
  111.  
  112.  
  113.  
  114.  
  115.                                   DISCLAIMER
  116.  
  117. The author has taken due care in the preparation of this document
  118. and the associated program.  Insofar as specific mention of program
  119. features, the author believes the information to be true.  No
  120. warranty is made regarding the suitability of the program to be
  121. compatible with your computer.  Incidental and consequential
  122. damages caused by malfunction, defect, or otherwise are not the
  123. responsibility of Gary W. Wood, and to the extent permitted by law,
  124. and hereby excluded both for the property and, to the extent not
  125. unconscionable, for personal injury damage. (Some states or
  126. jurisdictions do not allow the exclusion or limitation of
  127. incidental or consequential damages, so the above limitation or
  128. exclusion may not apply to you.)  Gary W. Wood also reserves the
  129. right to make amendments to the contents of this document from time
  130. to time, to reflect changes made to the specification of the Xlist
  131. system or for any other reason.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. Xlist is a Trademark of Gary W. Wood.  IBM, IBM-PC, PC-XT, PC-AT,
  139. PS/2, DOS, OS/2, VM/CMS, FLIST, and PC-DOS are Trademarks of
  140. International Business Machines Corp. MS-DOS is a Trademark of
  141. Microsoft Corporation.
  142. Xlist User Manual
  143. ===================================================================
  144.  
  145. CHAPTERS
  146.  
  147.  
  148.  
  149. 1.    Introduction                                          5
  150.  
  151. 2.    Getting Started                                       6
  152.  
  153. 3.    Invoking the Xlist Command                            8
  154.  
  155. 4.    Using the Keyboard                                    9
  156.  
  157. 5.    Increasing background performance (OS/2)              10
  158.  
  159. 6.    Mouse Support                                         11
  160.  
  161. 7.    Tagging Files                                         12
  162.  
  163. 8.    Use of the Xlist.CNF File                             14
  164.  
  165. 9.    Maintaining the Xlist.PRO Profile                     15
  166.  
  167. 10.   Command Line Commands                                 26
  168.  
  169. Xlist User Manual
  170. ==================================================================
  171.  
  172. INTRODUCTION
  173.  
  174.  
  175.  
  176. WELCOME TO THE WORLD OF DISK MANAGEMENT USING
  177. Xlist - DISK UTILITY
  178.  
  179.       If you are new to MS-DOS, you have realized that commands
  180.       provided by MS-DOS are designed to be short and sweet.  This
  181.       program is designed as a tool to effectively provide the user
  182.       a friendly way to view files contained in sub-directories and
  183.       be able to execute programs and MS-DOS commands.
  184.  
  185.       Xlist was written in 1985 modelled after IBM's VM/CMS mini-
  186.       disk manager called FLIST.  FLIST is a full-screen utility
  187.       that runs under CMS that allows professional programmers using
  188.       IBM 370 architecture VM machines to view a structured list of
  189.       available files and launch applications and commands by just
  190.       entering the command next to the corresponding file.
  191.  
  192.       Xlist provides a greatly enhanced version of FLIST providing
  193.       a powerful platform for executing MS-DOS commands, hard disk
  194.       management and launching applications.  Much time has been
  195.       used to make sure Xlist respects the current video mode and
  196.       tries to provide a natural feel that is easy to master.
  197.  
  198.  
  199. Xlist User Manual
  200. ==================================================================
  201.  
  202. GETTING STARTED
  203.  
  204.  
  205.  
  206. WHAT KIND OF HARDWARE & SOFTWARE DO I NEED?
  207.  
  208.  
  209.       To use Xlist you need the following:
  210.  
  211.       An IBM-MS with hard disk, MS-AT, PS/2, or a very closely
  212.       compatible microcomputer.
  213.  
  214.       A color/graphics adapter, monochrome adapter, EGA, or VGA
  215.       adapter
  216.  
  217.       640K of RAM memory for best results.  The program requires at
  218.       least 135K of memory.
  219.  
  220.       One diskette drive
  221.  
  222.       DOS 2.1+ or OS/2 1.2 or larger (Note: OS/2 1.0 version
  223.       available on request.)
  224.  
  225.       Will use Extended, XMS, EMS or DOS 5.0 high memory when
  226. available.
  227.  
  228. Xlist User Manual
  229. ===================================================================
  230.  
  231. WHAT DO I DO NOW
  232.  
  233.  
  234.       Installing Xlist to operate on your system is a simple
  235.       process.  You should start by copying the distribution
  236.       diskette and putting the original away in a safe place.
  237.  
  238.       Now, copy the files on the diskette or unarchive the
  239.       application to a directory on your hard disk searched by the
  240.       DOS PATH.  The MS-DOS "PATH" command specifies a directory
  241.       search order for commands and/or batch files that are not in
  242.       the current drive/directory.
  243.  
  244.       For best performance of Xlist when utilizing the capability to
  245.       page Xlist memory to a temporary file, set the TMP=
  246.       environment parameter to a RAM disk.  Xlist will normally
  247.       search the default drive/directory then the PATH= directories
  248.       to locate the XLIST.PRO & XLIST.CNF files.  To cause Xlist to
  249.       search using another directory order use the XLIST=
  250.       environment parameter.  This parameter can contain a number of
  251.       directories separated by a semi-colon.
  252.  
  253.       (See the *OVERLAY option in Chapter 7 for more information.)
  254.  
  255.       SET TMP=D:\         <--- Point to RAM disk.
  256.       SET XLIST=C:\XLIST  <--- Point to where XLIST.CNF & XLIST.PRO
  257. are located.
  258.  
  259.       You are now ready!
  260. Xlist User Manual
  261. ===================================================================
  262.  
  263. INVOKING THE Xlist COMMAND
  264.  
  265.  
  266. WHAT ARE THE INVOKING PARAMETERS?
  267.  
  268.  
  269.       First, no parameters are mandatory, but under some conditions
  270.       you may want to specify them to limit or expand the directory
  271.       entries displayed.
  272.  
  273.       To invoke the program enter:
  274.  
  275.             Xlist [[d:][path][filename[.ext]] /L /A
  276.  
  277.       The optional parameters have the following definitions:
  278.  
  279.             [[d:][path][filename[.ext]] to specify the file and/or
  280.             files that will be initially be displayed by the Xlist
  281.             screen.
  282.  
  283.             [/L] or [-L] is used to tell Xlist to display license
  284.             information.
  285.  
  286.             [/A] or [-A] will instruct Xlist to display every file on
  287.             the drive.
  288.  
  289.             [/*] is used to provide override "XLIST.PRO" profile
  290. commands.
  291.  
  292.  
  293.       Examples:
  294.  
  295.       Execute Xlist loading the directory from the default drive
  296.       directory.
  297.  
  298.       XLIST *.*
  299.  
  300.       Activate the performance options for Xlist OS/2 to wait 10
  301.       seconds before going into idle mode.
  302.  
  303.       XLIST /*KEYWAIT=10 /*SLEEP=1000
  304.  
  305.       Execute Xlist and redefine hotkey to press alt & right shift
  306.       key and disable the mouse functions.
  307.  
  308.       XLIST /*hotkey=alt=rightshift /*mouse=off
  309. Xlist User Manual
  310. ===================================================================
  311.  
  312. USING THE KEYBOARD
  313.  
  314.  
  315. WHAT KEYS ON THE KEYBOARD DOES XLIST USE?
  316.  
  317.       Xlist uses the keyboard for communicating instructions from
  318.       you to Xlist.  The keyboard is used to enter commands, scroll
  319.       the display, and to invoke user-defined function keys.  These
  320.       are the keystroke commands used by Xlist.
  321.  
  322.       You may change command keys by using the "Alt-k" key.
  323.  
  324.       Defaults are defined as follows:
  325.  
  326.       Keystroke         Definition
  327.       Home              Position the cursor to the first character or
  328.       entry.
  329.       End               Position the cursor to the last character or
  330.       entry.
  331.       Ctrl-End          Erase data in the command line from the cursor
  332.                         to the end-of-line.
  333.       Alt-a                   Change file attributes.
  334.       Alt-c                   Change screen colors.
  335.       Alt-e                   EGA/VGA video mode toggle switch.
  336.       Alt-f                   Toggle to set Xlist to flush unexecuted
  337.                               commands when an error or CNTL-BREAK is
  338.                               encountered.
  339.       Alt-k                   Change keyboard definitions.
  340.       Alt-s                   Toggle between displaying filesize in K's
  341.                               or in total number of bytes.
  342.       Alt-t                   Tag multiple files.
  343.       Alt-x                   Exclude entry.
  344.       Esc               Exit Xlist.
  345.       Enter             Pass control to Xlist to process the command
  346.                         lines.
  347.       Ctrl-Enter              Pass control to Xlist to process one
  348. command line.
  349.       Ctrl-PgUp         Goto top of directory. Will position to the
  350.                         first tagged entry.
  351.       Ctrl-PgDn         Goto bottom of directory.
  352.       PgUp              Scroll up one screen.
  353.       PgDn              Scroll down one screen.
  354.       Shift-Shift             Popup the menu.
  355.       `                 Tag single entry toggle. (Key above TAB to left
  356.       of "1")
  357. Xlist User Manual
  358. ===================================================================
  359.  
  360. INCREASING BACKGROUND PERFORMANCE
  361.  
  362.  
  363.       When you use Xlist for OS/2 in the foreground and have another
  364.       application running in the background, OS/2 scheduling
  365.       conventions give the majority of the processing power to the
  366.       foreground application.  This can sometimes cause a dramatic
  367.       decrease in background processing performance.  Xlist of OS/2
  368.       avoids this possible decrease in performance by providing two
  369.       profile options that let you enhance your background
  370.       processing speed.  These profile commands are: *KEYWAIT and
  371.       *SLEEP.
  372.  
  373.       Why is there sometimes a decrease in background performance?
  374.       Xlist for OS/2 must continuously check for mouse movements and
  375.       keyboard shift status.  This is necessary for Xlist to display
  376.       shifted function key definitions and to sense mouse movements.
  377.       Because Xlist is always trying to gather this information, the
  378.       program is never really "idle" even when it appears to be.
  379.  
  380.  
  381. HOW THE PERFORMANCE OPTIONS WORK
  382.  
  383.  
  384.       When you use the *KEYWAIT and *SLEEP options, Xlist for OS/2
  385.       operates as explained in the example below.
  386.  
  387.       Example:
  388.  
  389.       You are running Xlist in the foreground, another application
  390.       in the background, and you're using the defaults for the
  391.       *KEYWAIT (5 seconds) and *SLEEP (1000 milliseconds).  When
  392.       using Xlist, if you do not make an entry for 5 seconds, Xlist
  393.       will become idle for 1/10 of a seconds (1000 milliseconds).
  394.       When Xlist is idle, the background application is given
  395.       increased processing power resulting in an improved processing
  396.       speed.  At the end of the idle time Xlist checks for user
  397.       input.  If none is found, Xlist goes back into idle mode for
  398.       another 1/10 of a second.  Xlist continues the idle/check loop
  399.       until it detects user input.
  400.  
  401.       How does Xlist idle time affect you?  When Xlist is idle the
  402.       response to you input is delayed by the number of milliseconds
  403.       specified.  This means that your first couple of keystrokes
  404.       will not appear on the screen for a fraction of a second.
  405.       However, after you begin typing, Xlist comes out of the idle
  406.       mode and normal typing speed is resumed.
  407. Xlist User Manual
  408. ===================================================================
  409.  
  410. MOUSE SUPPORT
  411.  
  412.  
  413. HOW DOES THE MOUSE INTERFACE WITH XLIST?
  414.  
  415.  
  416.  
  417.       Xlist will use a mouse device when available.  The mouse is
  418.       capable of scrolling the screen, executing function keys,
  419.       moving between directories, tagging & untagging entries, and
  420.       bring up a series of menus.  A mouse will have anywhere from
  421.       2 to 3 buttons.  For the purpose of this discussion, we will
  422.       call the buttons the left, center and right buttons.
  423.  
  424.       Scrolling: You may scroll the display by positioning the mouse
  425.       pointer to the top or bottom right or left most position and
  426.       pressing either the right or left button.  The left button
  427.       will scroll a full screen while the right button will scroll
  428.       continuously one entry at a time.
  429.  
  430.       Function Key: Position the mouse pointer over the function key
  431.       definition on the last row of the display and press the left
  432.       button.
  433.  
  434.       Directories: Position the mouse pointer on the first row and
  435.       press the right button to move from the current directory to
  436.       the directory's parent.  Position the mouse pointer to a
  437.       directory entry on the main screen area and double click the
  438.       left button to move to the corresponding directory.
  439.  
  440.       Tagging: Position the mouse pointer to the first entry to tag
  441.       and press the center button or both the left and right buttons
  442.       at the same time an drag the mouse pointer to tag multiple
  443.       entries.  Use the right button to untag already tagged
  444.       entries.
  445.  
  446.       Menus: Position the mouse pointer to the first row and click
  447.       the left button.
  448.  
  449. Xlist User Manual
  450. ===================================================================
  451.  
  452. TAGGING FILES
  453.  
  454.  
  455.  
  456.       When using Xlist you normally view the directory structure and
  457.       process a series of MS-DOS commands against corresponding
  458.       directory entries.  This is normally executed by positioning
  459.       the highlighted line with the cursor keys to the directory
  460.       entry and entering a MS-DOS command beside the entry.
  461.  
  462.       If you would like to perform the same command to a series of
  463.       files you should navigate from page to page and tag files you
  464.       would like to execute the same command using the designated
  465.       "tag" key or using the alt-t command to globally tag multiple
  466.       files.
  467.  
  468.       After pressing the <ENTER> key, Xlist will process commands
  469.       starting with the first command located adjacent to a
  470.       directory entry.  Subsequent tagged entries will have that
  471.       command processed against that entry as if you had entered the
  472.       command over and over adjacent to each tagged directory entry.
  473.  
  474.  
  475.        LVL 1 - C:\                   (   8K) 158,447  PAGE 1 OF 15
  476.       DELETE                        <DIR>     12-17-91   7:20p ....
  477.       NOWHERE                       <DIR>     12-17-91   7:21p ....
  478.       OS2                           <DIR>     12-17-91   6:49p ....
  479.       ANIMATE  EXE  erase               19152 05-07-90   9:18p A...
  480.       ASTEROID EXE                      23936 06-22-90  11:47a A...
  481.       AUTOEXEC BAT  copy / a:            1048 12-22-91   3:58p ....
  482.       CONFIG   SYS                        417 12-22-91   8:11p ....
  483.       DASDDRVR SYS                       1170 03-02-90  12:00p ....
  484.       IMAGE    BAK  /a-r~erase          50688 12-23-91   8:21p .R..
  485.       KTCCACHE EXE                       3344 04-11-91  12:02p A...
  486.       OS2LDR   MSG                       7928 10-09-91   2:20p ....
  487.       SPOOL         cd              <DIR>     12-17-91   7:21p ....
  488.       STARTUP  CMD                         76 12-22-91   4:32p ....
  489.       IMAGE    DAT                      50688 12-23-91   8:21p ....
  490.  
  491.       In the example specified above we have tagged entries from ANIMATE.EXE
  492.       through KTCCACHE.EXE using the "tag" key causing Xlist to highlight the
  493.       tagged lines.  Then, we positioned the cursor to "ANIMATE.EXE" and entered
  494.       "erase", skipped to "AUTOEXEC.BAT" and entered "copy / a:", skipped to
  495.       "IMAGE.BAK", entered "/a-r~erase" and changed directory to C:\SPOOL.
  496. Xlist User Manual
  497. =======================================================================
  498.  
  499.       What happens???
  500.  
  501.       Xlist will execute the MS-DOS "erase" command following by "ANIMATE.EXE"
  502.       causing the file to be deleted by MS-DOS...because the following line is
  503.       also tagged, Xlist will erase "ASTEROID.EXE"...the command is changed to
  504.       "copy / a:" causing Xlist to execute "copy AUTOEXEC.BAT a:"...then "copy
  505.       CONFIG.SYS a:"...then "copy DASDDRVR.SYS a:"...the command is changed to
  506.       "/a-r~erase" causing Xlist to remove the read-only file attribute and
  507.       erase "IMAGE.BAK"...then will erase the last tagged file
  508.       "KTCCACHE.EXE"...then will change directory to C:\SPOOL.
  509.  
  510.       You should note that the "~" character is used for logical command end
  511.       used to stack commands and the "/a-r" is an internal Xlist command used
  512.       to change file attributes.  You will see discussions of these commands
  513.       later within the documentation.
  514. Xlist User Manual
  515. =======================================================================
  516.  
  517. USE OF THE XLIST.CNF FILE
  518.  
  519.  
  520. WHAT PARAMETERS ARE IN THE CONFIGURATION FILE?
  521.  
  522.  
  523.       The 'XLIST.CNF' file contains the initial keyboard and color settings.  You
  524.       may modify these using the "Alt-c" for color changes and the "Alt-k" for
  525.       keyboard changes.  If by some chance this file is corrupted, erase the
  526.       file and Xlist will recreate it to its default values.  This file is
  527.       maintained by Xlist and cannot be edited by a text editor.  If you corrupt
  528.       the keyboard or color settings, Xlist will recreate the file if you erase
  529.       the file.  It will be recreated in the current drive/directory if XLIST.EXE
  530.       is located in the directory or in the first path specified by the MS-DOS
  531.       PATH= command.
  532.  
  533. Xlist User Manual
  534. =======================================================================
  535.  
  536. MAINTAINING THE XLIST.PRO PROFILE
  537.  
  538.  
  539. WHAT PARAMETERS ARE IN THE PROFILE?
  540.  
  541.  
  542.       The 'Xlist.PRO' file is used to communicate a multitude of parameters to
  543.       Xlist that allow it to be tailored to your individual needs.  Use a text
  544.       editor, such as BRIEF, KEDIT, or EDLIN to modify the profile parameters
  545.       based on the following parameter descriptions.  There is no way the
  546.       provided profile will suit your needs and you should modify at least the
  547.       *PFKEYS and *EXECUTE parameters.
  548.  
  549.       The profile is found by Xlist by first checking the default
  550.       drive/directory, then by following the paths set by the MS-DOS "PATH"
  551.       command.  All Xlist options are identified by preceding keyword that start
  552.       with an asterisk "*".  When the first character is not an asterisk the
  553.       command line is treated as a comment.
  554.  
  555.       Following is description of the parameters specified in the Xlist.PRO file.
  556.       Optional parameters are designated by separation using the "|" and
  557.       parameters that need a numeric value specified use "n" to designate a
  558.       numeric value.  The default value is the first parameter specified or
  559.       underlined.
  560. Xlist User Manual
  561. =======================================================================
  562.  
  563. XLIST.PRO PROFILE PARAMETERS
  564.  
  565.  
  566. *ALLATTR    OFF | ON | DISABLE
  567.  
  568.       The *ALLATTR is used in conjunction with changing the attributes of a MS-
  569.       DOS directory using the /A command.
  570.  
  571.       OFF         Only files under the specific directory will be changed.
  572.       ON          All files under the sub-directory will be changed.
  573.       DISABLE     Will not function on sub-directories.
  574.  
  575.  
  576. *BUFSIZE    30422 | nnnnn
  577.  
  578.       Use the *BUFSIZE command to assign the size reserved for "Xlist" to use
  579.       as a "COPY" Input / Output buffer.  The buffer is allocated the first time
  580.       the "COPY" command is used.  The size may be decreased down to 512
  581.       characters.  By decreasing the buffer size, performance of the "COPY"
  582.       command will be impaired.  The maximum value is 60844.
  583.  
  584.  
  585. *CMD-DEFAULT      [ commands ]
  586.  
  587.       Use the *CMD-DEFAULT to set the default command line options that are
  588.       appended to commands entered in the command area.  This can be used to
  589.       set Xlist to automatically clear the screen before executing commands or
  590.       to pause before re-entering Xlist after executing the command.  This
  591.       combination can be set by following the *CMD-DEFAULT with "/c /p".
  592.  
  593.  
  594. *DIRATTR    n+r+d+a | n+r+h+s+v+d+a
  595.  
  596.       The *DIRATTR command is used to define what attribute is used to search
  597.       the DOS directory.  This is used to setup a mask used during the search
  598.       of the directory to select what entries are included when displaying
  599.       directory entries on the Xlist screen.
  600.  
  601.       Value                   Description
  602.         n               Normal file
  603.         r               Read-only file
  604.         h               Hidden file
  605.         s               System file
  606.        *v               Volume label
  607.         d               Directory
  608.         a               Archival file
  609.  
  610. * Volume is not available on OS/2 operating systems.
  611. Xlist User Manual
  612. =======================================================================
  613.  
  614. *DISABLE    [command]
  615.  
  616.       Xlist will intercept some MS-DOS commands to give greater control to Xlist
  617.       when monitoring the directory and keeps MS-DOS from writing over Xlist's
  618.       screen.  The MS-DOS "Copy" & "Rename" command executed by Xlist are not
  619.       fully compatible with MS-DOS's "Copy" & "Rename" in that Xlist won't allow
  620.       wild cards in the source parameter.  Also, note that Xlist will get an up
  621.       to a 32K buffer and will increase the size of Xlist and this space won't be
  622.       given back.  If you wish to use wild cards, either disable the command or
  623.       use the "DOS" command to use MS-DOS.
  624.  
  625.       Profile parameter *DISABLE command is used to disable MS-DOS commands
  626.       that Xlist will intercept.  The following commands can be disabled:
  627.  
  628.             *DISABLE COPY
  629.             *DISABLE DEL
  630.             *DISABLE ERASE
  631.             *DISABLE RENAME
  632.             *DISABLE REN
  633.             *DISABLE CHDIR
  634.             *DISABLE CD
  635.             *DISABLE MKDIR
  636.             *DISABLE MD
  637.             *DISABLE RMDIR
  638.             *DISABLE RD
  639.             *DISABLE MOVE
  640.  
  641.       It is to your advantage not to disable the above commands unless they
  642.       fail to perform to your expectations.  By allowing Xlist to intercept these
  643.       commands, it is better able to keep the command line up to date as changes
  644.       are made to the current directory.
  645.  
  646.  
  647. Xlist User Manual
  648. =======================================================================
  649.  
  650. *ENTRIES    500 | nnn
  651.  
  652.       The *ENTRIES command is used to provide a method for the user to specify
  653.       how much memory is used by Xlist to hold directory entry information.
  654.       Each directory is held in memory by Xlist to be displayed on the screen.
  655.       The maximum number of entries Xlist can load is 5900.
  656.  
  657.       Whenever there are more entries than set by the *ENTRIES command, the
  658.       excess entries are bypassed.
  659.  
  660.  
  661. *EXECUTE          [pattern] [commands......]
  662. *EXECUTE-ARC      [pattern] [commands......]
  663. *EXECUTE-LZH      [pattern] [commands......]
  664. *EXECUTE-ZIP      [pattern] [commands......]
  665. *EXECUTE-ZOO      [pattern] [commands......]
  666.  
  667.       The *EXECUTE command is used to associate a series of commands to be
  668.       entered when the ENTER key is pressed.  This can be used to invoke a
  669.       browser, editor, Lotus 1-2-3, DBASEIII, or any other series of commands.
  670.  
  671.       You can set up multiple *EXECUTE commands within the Xlist.PRO profile.
  672.       They are scanned sequentially each time the ENTER key is pressed to see
  673.       if any commands should be entered if the pattern matches the name of the
  674.       active file.
  675.  
  676.       Example:
  677.  
  678.       To have a program called "LIST" invoked whenever the ENTER key is
  679.       pressed for all files that start with either an A, B, or C and the extension
  680.       is "DOC".
  681.  
  682.       *EXECUTE [ABC]*.DOC LIST
  683.  
  684.       To execute the Wordperfect word processor when ENTER key is pressed
  685.       beside all files having the .WP5 extension.
  686.  
  687.       *EXECUTE *.WP5 WP
  688.  
  689.  
  690. Xlist User Manual
  691. =======================================================================
  692.  
  693. *HOTKEY     RIGHTSHIFT  |  LEFTSHIFT  |  ALT  |  CONTROL
  694.  
  695.       The *HOTKEY command is used to redefine the menu keyboard hotkey
  696.       combination used to bring up the menus.  The default is by pressing both
  697.       shift keys at the same time.  You must specify two of the four possible
  698.       values.  The default is pressing both the shift keys at the same time.
  699.       This is the same combination as the IRMA's 3270 emulator and should be
  700.       changed in that instance.
  701.  
  702.       Example:
  703.  
  704.       To define the alt & control combination to envoke the menus.
  705.  
  706.       *HOTKEY     ALT  CONTROL
  707.  
  708.  
  709. *KEYBOARD   STANDARD | ENHANCED
  710.  
  711.       This command allows Xlist to check for the F11 and F12 keystroke.  When
  712.       using the enhanced keyboard containing the F11 and F12 keys you should
  713.       set this option to ENHANCED.
  714.  
  715.  
  716. *KEYWAIT    5 | nn
  717.  
  718.       The *KEYWAIT command is used to tell Xlist for OS/2 the number of seconds
  719.       to wait before going into idle mode.  Where nn is the number of seconds
  720.       (between 1 and 99) to wait.  The default is 5.  (See *SLEEP command)
  721.  
  722.  
  723. *LINEEND    ~ | c
  724.  
  725.       The *LINEEND command is used to define the logical line end character.
  726.       For entering multiple commands on the same line for execution.  The
  727.       default character is the '~'.  This character may be put on the command
  728.       line or used within the *PFKEYS or *EXECUTE profile commands.
  729.  
  730.  
  731. *LOGO       ON | OFF
  732.  
  733.       The *LOGO command is used to disable the presentation of the initial
  734.       copyright screen.  This presentation delays Xlist execution for 3
  735.       seconds.
  736. Xlist User Manual
  737. =======================================================================
  738.  
  739. *MOUSE      ON | OFF
  740.  
  741.       The *MOUSE command is used to disable the interface to the mouse pointer.
  742.       This can be used to keep Xlist from continuously checking for mouse
  743.       movements.  Initialization of the Microsoft PS/2 mouse causes a noticable
  744.       startup delay.  This is normal for Microsoft's PS/2 mouse interface.
  745.  
  746.  
  747.  
  748. *OVERLAY    ON | OFF    SWAP_ANY | SWAP_EMS | SWAP_XMS | SWAP_DISK
  749.  
  750.       The *OVERLAY command is used to maximize the amount of memory available
  751.       for commands invoked from within Xlist.  Xlist reduces the resident
  752.       portion of Xlist while another command is executed by temporarily
  753.       storing the Xlist program to either EMS, XMS or a disk file.  After the
  754.       invoked command is finished, Xlist is read back in memory and execution
  755.       resumes.  This will effectively reduce the memory requirements of Xlist
  756.       down to only 10K.  The feature can be toggled on and off by using the "/s"
  757.       option on the command line.
  758.  
  759.       If you have specified "*OVERLAY ON", you can follow the command with
  760.       options to specify which method to use for swapping memory.
  761.  
  762.  
  763. *PATHSZ     200 | nnn
  764.  
  765.       The *PATHSZ command is used to define the amount of memory reserved for
  766.       saving the DOS paths that have been previous displayed during a Xlist
  767.       session.  This memory is automatically managed in conjunction with use
  768.       of the /BD command.
  769. Xlist User Manual
  770. =======================================================================
  771.  
  772. *PFKEYS           Xnn (btd) function
  773. *PFKEYS-ARC       Xnn (btd) function
  774. *PFKEYS-LZH       Xnn (btd) function
  775. *PFKEYS-ZIP       Xnn (btd) function
  776. *PFKEYS-ZOO       Xnn (btd) function
  777.  
  778.       This command provides the user with a method of defining the function
  779.       keys F1-F12 in order to execute commands using the function keys rather
  780.       than entering the command.  The function may be more than one command
  781.       each separated by the logical line end character (See *LINEEND for more
  782.       information). When viewing a ARC, LZH, ZOO or ZIP directory structure by
  783.       utilizing the /EXP, /ZIP, /LZH, /ZOO or /ARC commands, Xlist has the ability
  784.       to load another set of function key definitions.  These are specified by
  785.       appending "-ZIP", "-LZH", "ZOO" or "-ARC" upon the *PFKEYS keyword.
  786.  
  787.       The format for the command is as follows:
  788.  
  789.       *PFKEYS Xnn (btd) function
  790.  
  791.       X     = Shift key indicator.
  792.       blank       = unshifted.
  793.       S     = right or left shift pressed.
  794.       C     = CTRL pressed.
  795.       A     = ALT pressed.
  796.       nn    = Function key number (1 through 12).
  797.       btd   = Abbreviation for display (optional).
  798.       function = Text inserted into Xlist command line.
  799.  
  800.       Examples:
  801.  
  802.       Set function key (F1) to compile a program using the Lattice C compiler.
  803.  
  804.       *PFKEYS 1 (lcs) lc -ms /c
  805.  
  806.       Set function key (F2) to link-edit a program and cancel execution of Xlist.
  807.  
  808.       *PFKEYS 2 (lnk) link @xlistlk.lnk /o/c~/can
  809.  
  810.       Set function key (F3) to execute F1 & F2 commands.
  811.  
  812.       *PFKEYS 3 (all) /F1~/F2
  813.  
  814.       Set function key (F3) to un-zip active file using PKUNZIP to the
  815.       drive/directory specified by the TMP environment variable; execute a
  816.       program called "LIST" passing the name of the file as the first parameter;
  817.       erase the un-zipped file after execution of LIST.
  818.  
  819.       *PFKEYS-ZIP 3 (LIS) /cPKUNZIP -o $A %TMP% $F~LIST %TMP%$~ERASE %TMP%$
  820. Xlist User Manual
  821. =======================================================================
  822.  
  823.       Same as last example with LHA for a LZH archive entry with the TMPDRV
  824.       environment variable set to "D:" for a RAM drive.
  825.  
  826.       *PFKEYS-LZH 3 (LIS) /c%TMPDRV%~LHA -o $A %TMP% $F~LIST %TMP%$~ERASE
  827.       %TMP%$~/RESET
  828.  
  829.  
  830. *PFREF      OFF | ON
  831.  
  832.       The *PFREF command is used to tell Xlist to refresh the function key
  833.       definitions from the Xlist.PRO profile found in the current directory.
  834.       When Xlist senses that a drive or sub-directory change has occurred a
  835.       search is made in the current directory for the Xlist.PRO profile.  This
  836.       can be used to refresh the function key definitions between drives
  837.       and/or directories.
  838.  
  839.  
  840. *RETRACE    OFF | ON
  841.  
  842.       Profile parameter *RETRACE is used for IBM Personal Computers with IBM
  843.       Color/Graphics Monitor Adapters (CGA).  They require special programming
  844.       to prevent "snow" from appearing on the screen when a program changes
  845.       the contents of the screen buffer.  The required programming will slow
  846.       down screen updating and is not necessary for many other display
  847.       adapters.  Setting *RETRACE OFF with an CGA color adapter will cause
  848.       "snow" on the screen in some instances.
  849.  
  850.  
  851. *SLEEP      1000 | nnnnn
  852.  
  853.       This command controls idle mode.  It tells Xlist for OS/2 the number of
  854.       milliseconds to remain idle before checking for user input (keystrokes
  855.       or mouse movement).  nnnnn is the number of milliseconds (between 100 and
  856.       32000) to remain idle.  Any input cancels idle mode (after the *SLEEP
  857.       milliseconds expire).  The default is 100.
  858.  
  859. Xlist User Manual
  860. =======================================================================
  861.  
  862. *SORT       [A | S | B | N | D | E | T][-]
  863.  
  864.       Profile parameter *SORT will cause Xlist to sort the directory before it
  865.       is displayed.  This will allow you to specify the order the entries are
  866.       arranged.
  867.  
  868.       The parameter definitions are:
  869.  
  870.             A     by attribute
  871.             S     by size
  872.             B     by blocksize (same as S)
  873.             N     by name
  874.             D     by date
  875.             E     by extension
  876.             T     by type (same as E, except sub-directories go to the top)
  877.  
  878.             -     descending order
  879.  
  880.  
  881. *SORTDIR    OFF | ON
  882.  
  883.       The parameter *SORTDIR when set to ON will force the sub-directory
  884.       entries to the top of the list when using the /S[bdnta] sort commands.
  885.  
  886.  
  887. *TOPVIEW    OFF | ON
  888.  
  889.       The *TOPVIEW command is used to disable the access of the TOPVIEW video
  890.       buffer address.  Some video adapters have conflicts with the interrupts
  891.       used to access the TOPVIEW video buffer.  Setting this to OFF will make for
  892.       faster screen access.
  893.  
  894.  
  895. *TREE       OFF | ON
  896.  
  897.       The *TREE command when set to "ON" will automatically load the directory
  898.       tree during startup of the Xlist program.  This will cause the startup of
  899.       Xlist to take a little longer.
  900.  
  901.  
  902. *TREEDATE   OFF | ON
  903.  
  904.       The *TREEDATE command is used to determine if the Xlist_x.LOG file
  905.       internal timestamp is to be used.  Xlist will create the file when scanning
  906.       directories.  The file is used when changing back to the drive in order to
  907.       save time.  You can instruct Xlist to use the file even if it was created
  908.       by a prior execution of Xlist by setting this option to the OFF position.
  909.       Xlist will execute faster but the directory tree may not reflect all
  910.       directories or show non-existent directories from previous executions
  911.       of Xlist.  You should reload the directory tree using the /RTREE command
  912.       when this occurs.
  913. Xlist User Manual
  914. =======================================================================
  915.  
  916. *TREESCAN   OFF | ON
  917.  
  918.       The *TREESCAN command when set to "ON" will automatically preview files
  919.       within the directory.
  920.  
  921.  
  922. *UPPERCASE  OFF | ON
  923.  
  924.       The *UPPERCASE command controls the case of the files displayed.  The
  925.       default option is set to the OFF position.  This will display files in lower
  926.       case and directories in upper case.  Setting this feature ON will display
  927.       all filenames in upper case.
  928.  
  929.  
  930. *VGAMODE    "Menu Title", "Font Filename"
  931.  
  932.       The *VGAMODE command is used in conjunction with EGA/VGA display
  933.       adapters that allows you to specify an optional character display table
  934.       (ie. FONT) to be loaded in place of the resident fonts.  *VGAMODE commands
  935.       contain two pieces of information separated by a comma.  The first
  936.       parameter contains the heading contained in the menu within Xlist
  937.       corresponding to the specified FONT.  The heading must be contained
  938.       within double quotes, have two leading spaces and not exceed 40
  939.       characters in length.  The second parameter contains the MS-DOS file name
  940.       of the FONT.  This file is composed of 256 entrys between 8 to 14
  941.       characters in width.  These are the bitmaps for each possible character
  942.       from decimal 0 thru decimal 256.  You can create your own fonts by using
  943.       font editors that create normal MS-DOS character definition tables that
  944.       contain 256 entrys.
  945.  
  946.       If the *VGAMODE command isn't provided, Xlist will allow you to shift
  947.       between 25 line and 43 line modes using the alt-e keystoke or
  948.       corresponding menu commands.
  949.  
  950.       Some examples of font files are provided with Xlist which have the
  951.       extension of ".FNT".
  952. Xlist User Manual
  953. =======================================================================
  954.  
  955. COMMAND LINE COMMANDS
  956.  
  957.  
  958. HOW TO USE THE COMMAND LINE
  959.  
  960.  
  961.       Xlist will present the directory vertically down the screen with a input
  962.       line next to each entry; this is the "COMMAND LINE".  The user can use the
  963.       cursor keys to navigate up and down the directory entering commands.
  964.       When the ENTER key is depressed, Xlist will process the commands from
  965.       top-to-bottom.  All commands entered are first examined by Xlist to find
  966.       special commands used by Xlist.  These commands are from logical line end
  967.       characters to special commands used to sort the directory into another
  968.       order.  Then Xlist will pass the commands to MS-DOS for execution.
  969.  
  970.       Based on a 80-column display, there are 33 characters that can be
  971.       presented to Xlist on the command line at any one time.  But, by continued
  972.       typing up to 63 characters can be entered.
  973.  
  974.       After the command is entered Xlist will append the filename and extension
  975.       name to the command unless told otherwise by the /o line command.
  976.  
  977.  
  978.       GENERAL NOTES:
  979.  
  980.       Do not rename or erase files from a BAT file or with a "ERASE *.*"
  981.       sequence.
  982.  
  983.       These situations cannot be detected by Xlist and may result in random
  984.       displayed filenames or Xlist termination.  If you do the above, by
  985.       entering the "/RD" command, the directory is refreshed.
  986.  
  987. Xlist User Manual
  988. =======================================================================
  989.  
  990. $       - SUBSTITUTE FILENAME & EXTENSION
  991.  
  992.       There are a series of characters using the '$' as a prefix that can be used
  993.       to imbed parameters into the command line automatically.
  994.  
  995.       /       -->  Substitute the DOS filename & extension.
  996.       //      -->  Will pass on one /.
  997.       $       -->  Substitute the DOS filename & extension.
  998.       $$      -->  Will pass on one $.
  999.       $A      -->  Substitute archive filename.
  1000.       $P      -->  Substitute DOS pathname without trailing slash.
  1001.       $N      -->  Substitute DOS filename without extension.
  1002.       $E      -->  Substitute DOS extension.
  1003.       $F      -->  Substitute DOS pathname, filename & extension.
  1004.       $D      -->  Substitute DOS drive letter without trailing colon.
  1005.       $T      -->  Substitute list of tagged entries.
  1006.       $S      -->  Substitute ZIP archive password (always prompt).
  1007.       $s      -->  Substitute ZIP archive password (prompt once).
  1008.  
  1009.  
  1010. /A      - CHANGE THE FILE ATTRIBUTES
  1011.  
  1012.       This command is used to modify the file attributes.  The attribute maybe
  1013.       marked read-only, hidden, made a system file, or have the archive flag
  1014.       turned on.
  1015.  
  1016.       When this is placed on a sub-directory, Xlist will change the attributes
  1017.       of all the files within the directory. (See *ALLATTR profile command for
  1018.       more information.)
  1019.  
  1020.       The format is:  /A[+/-][attribute]
  1021.  
  1022.       [+/-] the plus(+) is used to denote adding the attribute and the
  1023.       negative(-) is used to remove an attribute.
  1024.  
  1025.       [attribute] is the one-character representation of the attribute to be
  1026.       added or removed from the file.
  1027.  
  1028.             A  - Archive            R  - Read-only
  1029.             H  - Hidden file        S  - System file
  1030.             D  - Subdirectory
  1031.  
  1032. Xlist User Manual
  1033. =======================================================================
  1034.  
  1035. /AD     -  APPEND TO THE Xlist DIRECTORY
  1036.  
  1037.       The /AD command is used to append to the internal directory.  This can be
  1038.       used to load additional entries from other drives or sub-directories.
  1039.  
  1040.       Examples:
  1041.  
  1042.       Set Xlist to only append the files with an extension of "EXE":
  1043.  
  1044.       /AD=*.EXE
  1045.  
  1046.       Append data from the root directory:
  1047.  
  1048.       /AD=C:\*.*
  1049.  
  1050.  
  1051. /ARC    - EXPAND AN "ARC" FILE DIRECTORY
  1052.  
  1053.       Same function as the /EXP command for archive files with the ".ARC"
  1054.       extension.  See the /EXP command for further details.
  1055.  
  1056.  
  1057. /BD     - GO BACK TO PRIOR DIRECTORY
  1058.  
  1059.       This command is used to proceed back to previous sub-directory.
  1060.       Whenever a sub-directory or drive change is made by entering the MS-DOS
  1061.       CHDIR commands, Xlist will save the current directory in the path area
  1062.       reserved by the *PATHSZ profile command.  By entering /BD the program
  1063.       will automatically navigate back to the previous directory.
  1064.  
  1065.  
  1066. /BOT    - BOTTOM OF LIST
  1067.  
  1068.       This command will bring you to the bottom of the list.
  1069.  
  1070.  
  1071. /C      - CLEAR SCREEN BEFORE EXECUTING COMMAND
  1072.  
  1073.       When the /C is found in the command line it is extracted from the command
  1074.       line and before the entered command is passed to the DOS command
  1075.       processor the screen is cleared.  The video mode and character definition
  1076.       table (font) is reset to MS-DOS's normal settings.  When a function key is
  1077.       defined to invoke a program it is sometimes more appealing to have Xlist
  1078.       clear the screen before invoking the program using the "/C" option.  This
  1079.       also causes Xlist to clear and re-display the entire Xlist screen when
  1080.       control is passed back from the program executed.
  1081. Xlist User Manual
  1082. =======================================================================
  1083.  
  1084. /CAN    - CANCEL XLIST
  1085.  
  1086.       This command will exit Xlist and stay in the current directory and not
  1087.       reset the video mode and character definition table (font) back to MS-
  1088.       DOS's normal settings.
  1089.  
  1090.  
  1091. /CLS    - CLEAR COMMAND LINE AREA
  1092.  
  1093.       This command will clear the Xlist command line area.
  1094.  
  1095.  
  1096. DOS     - INVOKE SECONDARY COMMAND PROCESSOR
  1097.  
  1098.       Use the DOS command to pass control to the secondary DOS command
  1099.       processor.  This command will load a copy of DOS and pass control to it.
  1100.       You will remain in DOS until you return to Xlist by entering the EXIT
  1101.       command.
  1102.  
  1103.       You should not execute any commands while in the secondary command
  1104.       processor that will make them permanently resident.
  1105.  
  1106.  
  1107. /DSPF   - DISPLAY USER-DEFINED FUNCTION KEYS
  1108.  
  1109.       You can use the /DSPF function to display the function keys currently
  1110.       defined.
  1111.  
  1112.  
  1113. /END    - END Xlist
  1114.  
  1115.       This command will exit Xlist and return to the drive and directory where
  1116.       Xlist was initially envoked.  This is the well-behaved ending of Xlist.
  1117.  
  1118. /EXE    - EXECUTE SPECIFIED PROGRAM
  1119.  
  1120.       The /EXE command is designed to be used in conjunction with the *EXECUTE
  1121.       profile command to specify the ".EXE", ".COM" and ".BAT" to be launched
  1122.       when the ENTER key is pressed next to the application executable
  1123.       program name.  This method presents a user-friendly window where you
  1124.       can specify additional parameters.
  1125. Xlist User Manual
  1126. =======================================================================
  1127.  
  1128. /EXP    - EXPAND AN "ARC", "LZH", "ZIP" or "ZOO" FILE DIRECTORY
  1129.  
  1130.       This command will read the directory contained within the specified
  1131.       archive file.  It will then display it using the Xlist directory display
  1132.       features.  Be aware that the /UD & /A sub-commands will be deactivated.
  1133.       To re-display the normal directory either press the ESC key or enter the
  1134.       /RD command.
  1135.  
  1136.       NOTE: You can use the /ZIP command to expand a ZIP file or /ARC to expand
  1137.       a ARC file or /LZH for LHA files.  The /EXP command determines whether it's
  1138.       a ZIP, LZH or ARC file from the file extension.
  1139.  
  1140.  
  1141. /F[x]nn  - EXECUTE FUNCTION KEY
  1142.  
  1143.       This command can be used to invoke function keys from the command line.
  1144.       As a matter of fact, when a function key is depressed Xlist will insert
  1145.       into the command line the above command.  The [x] position can either be
  1146.       blank, 'A' for Alt, 'S' for shift or 'C' for ctrl followed by the function key
  1147.       value from 1 through 12.
  1148.  
  1149.       Example:
  1150.  
  1151.       To invoke the F4 function key you would enter "/F4".
  1152.       To invoke the alternate F4 function key you would enter "/FA4".
  1153.  
  1154.  
  1155. /FIND    - FIND FILES ON CURRENT DRIVE
  1156.  
  1157.       The /FIND command will search the current drive locating all files that
  1158.       match the selection criteria specified with the /FIND command.  The
  1159.       results are displayed as if the files are all contained on the same
  1160.       drive/directory. To re-display the normal directory either press the ESC
  1161.       key or enter the /RD command.
  1162.  
  1163.       Examples:
  1164.  
  1165.       Find all batch files that start with either a "A" or "B".  The right and left
  1166.       bracket is used to specify optional characters in a specified location
  1167.       within the name.  The normal "*" and "?" wildcard characters can also be
  1168.       used.
  1169.  
  1170.       /FIND=[AB]*.BAT
  1171. Xlist User Manual
  1172. =======================================================================
  1173.  
  1174.       Find all files with the extension of WK1.
  1175.  
  1176.       /FIND=*.WK1
  1177.  
  1178.  
  1179. /LZH    - EXPAND AN "LZH" FILE DIRECTORY
  1180.  
  1181.       Same function as the /EXP command for archive files with the ".LZH"
  1182.       extension.  See the /EXP command for further details.
  1183.  
  1184.  
  1185. MOVE    - MOVE FILE
  1186.  
  1187.       Use the MOVE command to move a file from one directory to another
  1188.       directory on the same drive.  This program uses a feature of the DOS
  1189.       RENAME function that will logically move a file from on directory to
  1190.       another.  This command will also change the name of the file during the
  1191.       move if you wish.
  1192.  
  1193.  
  1194. /O      - OMIT THE FILENAME & EXTENSION FROM COMMAND
  1195.  
  1196.       When the /O is found in the command line it is extracted from the command
  1197.       line and before the entered command is passed to the DOS command
  1198.       processor the screen is cleared.
  1199.  
  1200.       This command is used to keep Xlist from appending the filename and
  1201.       extension to the end of the command entered on the command line.  This
  1202.       can be useful when entering DOS commands from the command line, since in
  1203.       most cases the filename shouldn't follow the command.
  1204.  
  1205.  
  1206. /P      - PAUSE AFTER EXECUTING COMMAND
  1207.  
  1208.       When the /P is found in the command line it is extracted from the command
  1209.       line and before the entered command is passed to the DOS command
  1210.       processor the screen is cleared.
  1211.  
  1212.       The /P command is used to cause Xlist to pause after executing the
  1213.       command entered on the command line.  This can be used in conjunction
  1214.       with the /C command to allow the screen to be viewed before Xlist takes
  1215.       control and refreshes the screen.
  1216. Xlist User Manual
  1217. =======================================================================
  1218.  
  1219. /RD     - RELOAD THE Xlist DIRECTORY AND RESET MASK
  1220.  
  1221.       The /RD command is used to reload the Xlist internal directory.  This can
  1222.       be used to refresh the current directory when modules are added or when
  1223.       directory clean-up is necessary.
  1224.  
  1225.       At this time a optional parameter can be entered resetting the mask used
  1226.       to select the entries to reload.
  1227.  
  1228.       Examples:
  1229.  
  1230.       Set Xlist to only load the files with an extension of "EXE":
  1231.  
  1232.       /RD=*.EXE
  1233.  
  1234.       Reload the directory with the default mask:
  1235.  
  1236.       /RD
  1237.  
  1238.  
  1239. /RESET  - RESET TO CURRENT DRIVE & DIRECTORY
  1240.  
  1241.  
  1242.       You may stack a series of commands that take you to another drive or
  1243.       directory.  When returning to Xlist from executing all commands, Xlist will
  1244.       sense the drive or directory change and reload the directory list.
  1245.       Normally, you want Xlist to execute in this fashion.  But, in special cases
  1246.       where you would like to stay in the current drive and directory then
  1247.       execute this as the last command to reset to the current drive and
  1248.       directory.
  1249.  
  1250.       Example:
  1251.  
  1252.       An example is provided extracting an entry from a LZH archive file to a
  1253.       temporary drive and directory, view the file and delete the file.  Without
  1254.       the /reset command Xlist would sense the drive/directory change and
  1255.       reload from the temporary drive.
  1256.  
  1257.       E:~LHA e $A $F~LIST $~ERASE $~/reset
  1258.  
  1259.       The command above would switch to the E: drive, extract the current LZH
  1260.       entry to the E: drive, view the entry with the LIST program, erase the file
  1261.       then return to the previous drive/directory.
  1262. Xlist User Manual
  1263. =======================================================================
  1264.  
  1265. /RF     - RE-FRESH THE Xlist FUNCTION KEYS
  1266.  
  1267.       The /RF command is used to refresh the Xlist function definitions.  This
  1268.       is useful when the "Xlist.PRO" file is changed and you want the changes
  1269.       to take effect.
  1270.  
  1271.  
  1272. /S      - TOGGLE *OVERLAY OPTION ON or OFF
  1273.  
  1274.       The /S command is used when launching a application to toggle the use of
  1275.       the *OVERLAY profile command on or off.  If the *OVERLAY profile command
  1276.       is disabled, the use of /S will temporarily enable the option for this
  1277.       execution of one application.
  1278.  
  1279.  
  1280. /Sx[-]  - SORTING DIRECTORY
  1281.  
  1282.       The following methods maybe used to sort the directory:
  1283.  
  1284.       /SA   Sort by file attribute
  1285.       /SE   Sort by extension
  1286.       /SB   Sort by filesize
  1287.       /SN   Sort by name
  1288.       /SD   Sort by file maintenance date
  1289.       /ST   Sort by extension, directories to top
  1290.       /SP   Sort by full pathname and filename
  1291.  
  1292.       The command maybe optionally followed by a "-" to denote a reverse sort
  1293.       sequence.
  1294.  
  1295.  
  1296. /SET    - SET FUNCTION KEYS
  1297.  
  1298.       This command provides the user with a method of defining the function
  1299.       keys F1-F12 interactively while Xlist is currently executing.  This
  1300.       command follows the same rules under which the *PFKEYS profile command
  1301.       follow.
  1302. Xlist User Manual
  1303. =======================================================================
  1304.  
  1305.       The format for the command is as follows:
  1306.  
  1307.       /SET Xnn (btd) function
  1308.  
  1309.       X           = Shift key indicator
  1310.       blank       = unshifted
  1311.       S           = right or left shift depressed
  1312.       C           = CTRL depressed
  1313.       A           = ALT depressed
  1314.       nn          = Function key number (1 through 12)
  1315.       btd         = Abbreviation for display (optional)
  1316.       function    = Text of command line
  1317.  
  1318.  
  1319. /START  - START AN OS/2 SESSION (OS/2 ONLY)
  1320.  
  1321.       This command will allow you to start a new session using the capabilities
  1322.       of the DosStartSession OS/2 function.  The command will search the PATH
  1323.       when the full full qualified name is not provided.  If a ICON is located in
  1324.       the same path as the program with the extension of .ICO, it will be used as
  1325.       the ICON.  The syntax of the command is:
  1326.  
  1327.       /START [-TIT:title] [-NOC] [-BG] [-FS | -PM | -WIN] [-I] [-MIN | -MAX] {program
  1328.       name} [program arguments]
  1329.  
  1330.       Parameters:
  1331.  
  1332.       title       Specify the title to assign to the session which is displayed
  1333.                   on the Presentation Manager menu and session window.
  1334.  
  1335.       -NOC        Specify not to close the window when the program ends.
  1336.  
  1337.       -BG         Start the program in the background.
  1338.  
  1339.       -FS         Start the program as a full screen session. (NOTWINDOWCOMPAT)
  1340.  
  1341.       -PM         Start the program as a PM session. (WINDOWAPI)
  1342.  
  1343.       -WIN        Start the program as PM compatible. (WINDOWCOMPAT)
  1344. Xlist User Manual
  1345. =======================================================================
  1346.  
  1347.       -I          Pass current environment settings to the starting session.
  1348.  
  1349.       -MIN        Set window state as MINIMIZED.
  1350.  
  1351.       -MAX        Set window state as MAXIMIZED.
  1352.  
  1353.       -CMD        Invoke the program session using CMD.EXE.
  1354.  
  1355.       -K          Invoke the program session using CMD.EXE with the /k option
  1356.                   that keeps the session when terminated.
  1357.  
  1358.  
  1359. /TOP   - GOTO THE TOP
  1360.  
  1361.       This command will bring you to the top of the directory list.
  1362.  
  1363.  
  1364. /TREE   - Xlist DIRECTORY STRUCTURE
  1365.  
  1366.       This command will load a graphic directory tree of the current drive.
  1367.       From within the directory tree, you can navigate to other
  1368.       sub-directories, create directories, and delete directories.
  1369.  
  1370.       To reload a directory tree use the /RTREE command.
  1371.  
  1372.  
  1373. /UD     - UPDATE DIRECTORY ENTRY WITH CURRENT DATE & TIME
  1374.  
  1375.       The /UD command is used to modify a directory entries date and time.  When
  1376.       the command is entered with no operands the corresponding directory
  1377.       entries date is set to the currently set DOS date and time.
  1378.  
  1379.       The /UD command can optionally be followed be either a date or a time
  1380.       which is recognize by Xlist by the dash for date and the colon for time.
  1381.       These separator characters are specified by MS-DOS using the COUNTRY
  1382.       command in CONFIG.SYS.
  1383.  
  1384.       Example:
  1385.  
  1386.       Set date to current date & time:          /UD
  1387.       Set date to July 2, 1985:                 /UD=07-2-85
  1388.       Set time to 12:00 noon:                   /UD=12:00:00
  1389.  
  1390. Xlist User Manual
  1391. =======================================================================
  1392.  
  1393. /V      - VERIFY ON ERASE or VERBOSE ON COPY
  1394.  
  1395.       When the /V is found in the command line it is extracted from the command
  1396.       line and before the entered command is passed to the DOS command
  1397.       processor the screen is cleared.
  1398.  
  1399.       The /V command in conjunction with the ERASE command will prompt the
  1400.       user to erase the file or not.  With the COPY command, Xlist will display
  1401.       the entry being copied.
  1402.  
  1403.  
  1404. /ZIP    - EXPAND AN "ZIP" FILE DIRECTORY
  1405.  
  1406.       Same function as the /EXP command for archive files with the ".ZIP"
  1407.       extension.  See the /EXP command for further details.
  1408.  
  1409.  
  1410. /ZOO    - EXPAND AN "ZOO" FILE DIRECTORY
  1411.  
  1412.       Same function as the /EXP command for archive files with the ".ZOO"
  1413.       extension.  See the /EXP command for further details.
  1414.  
  1415.  
  1416. /nnn    - DISPLAY DIRECTORY STARTING WITH nnn ENTRY
  1417.  
  1418.       The /nnn command is used to make Xlist display the current screen
  1419.       starting with the nth directory entry.  You can use the +- signs to
  1420.       position an offset from the current position.
  1421.  
  1422.       Examples:
  1423.  
  1424.       /80         Position to the 80th entry in the list.
  1425.       /+1         Position to next entry.
  1426.       /-1         Position to previous entry.
  1427.       /999        If the number is greater than the number of entries, Xlist
  1428.                   will position to the last entry.
  1429.       /1          Position to the 1st entry.
  1430.  
  1431.  
  1432. ?       - REDISPLAY LAST COMMAND ENTERED
  1433.  
  1434.       The ? command will cause Xlist to display the last command entered on the
  1435.       command line.
  1436.  
  1437. Xlist User Manual
  1438. =======================================================================
  1439.  
  1440. =       - REPEAT THE LAST COMMAND ENTERED
  1441.  
  1442.       The = command is entered as the only command will cause Xlist to process
  1443.       the last command entered.  Use this instead of repeating the last command
  1444.       over and over again.
  1445.