home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 01e / list75f.zip / LIST.DOC < prev    next >
Text File  |  1990-09-27  |  103KB  |  3,263 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                  LIST
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                        A File Viewing and Browsing Utility
  21.  
  22.                        Version 7.5          September 1990
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.         Licensed Material.  Unauthorized distribution is prohibited.
  43.         (c) Copyright  Vernon D. Buerg 1983-90.  All rights reserved
  44.  
  45.             T A B L E   O F   C O N T E N T S
  46.  
  47. __________________________________________________________________________
  48.  
  49.  
  50.  Getting Started  ...................................................... 1
  51.      Introduction  ..................................................... 1
  52.      Installation  ..................................................... 2
  53.      Printing the manual  .............................................. 2
  54.      Varieties of LIST.COM  ............................................ 3
  55.  
  56.  Definition of DOS terms  .............................................. 5
  57.      DOS Redirection  .................................................. 5
  58.      DOS Filters  ...................................................... 6
  59.      DOS Pipes  ........................................................ 7
  60.  
  61.  Command line  ......................................................... 8
  62.      Command line syntax  .............................................. 8
  63.      Command line switches  ............................................ 8
  64.  
  65.  How to use LIST  ...................................................... 9
  66.      Starting LIST  .................................................... 9
  67.      Exiting LIST  ..................................................... 10
  68.        Entering Commands  .............................................. 10
  69.      Display Format  ................................................... 11
  70.        Status Line Format  ............................................. 11
  71.        Command Line Format  ............................................ 13
  72.      Scrolling  ........................................................ 15
  73.      Positioning to Lines  ............................................. 17
  74.      Filtering  ........................................................ 19
  75.        Wrap Filter  .................................................... 20
  76.        Hi-bit Filter  .................................................. 20
  77.        Star Filter  .................................................... 20
  78.        Junk Filter  .................................................... 20
  79.        Hex Format Filter  .............................................. 21
  80.      Scanning for text  ................................................ 22
  81.      Marking and Extracting Lines  ..................................... 24
  82.      Printing  ......................................................... 26
  83.      Displaying multiple files  ........................................ 27
  84.      Windows  .......................................................... 29
  85.      Telephone dialer  ................................................. 30
  86.  
  87.  DOS considerations  ................................................... 31
  88.      File Sharing  ..................................................... 31
  89.      Invoking DOS Commands  ............................................ 31
  90.      Screen Saving  .................................................... 32
  91.  
  92.  File Selection Menu  .................................................. 33
  93.      LIST PLUS Display  ................................................ 33
  94.      Movement Keys  .................................................... 34
  95.      Changing Directories  ............................................. 35
  96.  
  97. Contents 1                                             LIST  User's Guide
  98.             T A B L E   O F   C O N T E N T S
  99.  
  100. __________________________________________________________________________
  101.  
  102.      List file  ........................................................ 35
  103.      Copy file  ........................................................ 35
  104.      Delete file  ...................................................... 35
  105.      Edit file  ........................................................ 35
  106.      Invoke file  ...................................................... 36
  107.      Move file  ........................................................ 36
  108.      Path changing  .................................................... 36
  109.      Rename  ........................................................... 36
  110.      Sort filenames  ................................................... 36
  111.      1-6 up display  ................................................... 37
  112.      ViewArc  .......................................................... 37
  113.  
  114.  Command key summary  .................................................. 38
  115.      Cursor keys  ...................................................... 38
  116.      F- function keys  ................................................. 38
  117.      Letter keys  ...................................................... 39
  118.      Control- keys  .................................................... 41
  119.      Alt- keys  ........................................................ 42
  120.  
  121.  Configuring LIST  ..................................................... 44
  122.      Screen Colors  .................................................... 44
  123.      Cloning  .......................................................... 45
  124.      Modifying LIST.COM  ............................................... 47
  125.        Locations of option values  ..................................... 47
  126.        Reassigning keys  ............................................... 49
  127.        Table of Routines  .............................................. 50
  128.  
  129.  Limitations  .......................................................... 54
  130.  
  131.  Copyright/License/Warranty  ........................................... 55
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150. LIST  User's Guide                                            Contents 2
  151. Getting Started
  152. ______________________________________________________________________________
  153.  
  154. Introduction
  155.  
  156.  
  157.     LIST is a user supported program.  It is not public domain.  You may
  158.     use LIST and  give it to your friends,  but you  may not  sell it or
  159.     use it in business without obtaining a license.  See the  last page
  160.     for information about licensing.
  161.  
  162.  
  163.     You use LIST to display files on your monitor, line by line with the
  164.     aid of scrolling, positioning and filtering commands.
  165.  
  166.  
  167.     LIST PLUS has many new  commands which go beyond usual  file viewing
  168.     and browsing.  We will  explain how LIST is  used, and then how  the
  169.     new file management commands are used.
  170.  
  171.  
  172.     Before going  into all  of the  ways in  which LIST  can be  used to
  173.     display files, let's look at  the three different varieties of  LIST
  174.     so that you understand the capabilities of each.  Then, we'll go  on
  175.     and define certain terms  like: redirection, piping, and  filtering.
  176.     In this way, you will better understand how you can use these things
  177.     with LIST.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. Page  1                                                    LIST  User's Guide
  205. Getting Started
  206. ______________________________________________________________________________
  207.  
  208. Introduction
  209.  
  210.  
  211. Installation
  212.  
  213.     There are three varieties of the  LIST program on the disk that  you
  214.     received (or in the file  that you downloaded).  This allows  you to
  215.     pick the version of LIST that is right for you, and to configure  it
  216.     to be exactly the way YOU want it to be.
  217.  
  218.     Decide which of the LIST programs you would like to use and copy the
  219.     .COM file to your working disk, or into a subdirectory on your  hard
  220.     disk.  Selecting a directory that is in your PATH will allow you  to
  221.     use LIST from anywhere on your system.
  222.  
  223.     You may  rename the  program file  to any  convenient name,  such as
  224.     L.COM,  READ.COM,  LST.COM  or  leave  it as LIST.COM.  For example,
  225.     place the distribution disk into drive A and enter the commands:
  226.  
  227.             A:
  228.             COPY LIST.COM C:\L.COM
  229.  
  230.     to copy  the Plus  version to  the root  directory of  your C drive,
  231.     renaming the program to L.COM in the process.
  232.  
  233.  
  234. Printing the manual
  235.  
  236.     To print the documentation, set your printer for six lines per inch,
  237.     and 10 characters per inch.   Then, use the DOS PRINT  command.  For
  238.     example,
  239.  
  240.                         PRINT LIST.DOC
  241.  
  242.     You may also  print out the  documentation by using  redirection and
  243.     entering:
  244.  
  245.                         TYPE LIST.DOC > LPT1
  246.  
  247.     Better yet, use LIST to print the manual.  Enter
  248.  
  249.                         LIST LIST.DOC
  250.  
  251.     then press the Ctrl and P keys at the same time.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258. LIST  User's Guide                                                    Page  2
  259. Getting Started
  260. ______________________________________________________________________________
  261.  
  262. Varieties of LIST.COM
  263.  
  264.  
  265.  
  266.         - LISTS.COM     small version
  267.  
  268.           - runs in about 30k
  269.           - limited to smaller files (around 600kb),
  270.           - excludes the Alt-X (screen saving) function
  271.           - excludes the Alt-G (goto DOS) function
  272.           - the Help screen is minimal.
  273.  
  274.  
  275.  
  276.         - LISTR.COM      regular version
  277.  
  278.           - runs in about 80K
  279.           - handles files up to 16 mb
  280.           - excludes the Alt-V (file selection) function
  281.           - excludes the Alt-I (insert filename) function
  282.           - the Alt-W (windowing function) is minimal, i.e. you get two
  283.             equal sized windows; there is no ability to change window
  284.             dimensions
  285.  
  286.  
  287.  
  288.         - LIST.COM     PLUS version
  289.  
  290.           - plus Alt-V file selection menu
  291.           - plus file management functions like copy and delete
  292.           - plus Alt-I hypertext-like file selection
  293.           - plus a help screen for the file selection Alt-V functions
  294.           - plus a second help screen for regular functions
  295.           - plus the Ctrl-T telephone dialer
  296.  
  297.  
  298.         - LISTE.COM    Enhanced version retail sale only
  299.  
  300.           - plus file tagging for copy, move and delete file operations
  301.           - plus EBCDIC file display
  302.           - enhanced Alt-E screen mode support for EGA and VGA adapters to
  303.             set 96 and 132 column, and other modes
  304.           - plus support of UltraVision screen enhancement utility
  305.           - plus support of files with all fixed length records for greater
  306.             speed and flexibility
  307.           - optional support of Hercules Incolor and RamFont adapters
  308.           - optional support to view files up to 500 mb in size
  309.  
  310.  
  311.  
  312. Page  3                                                    LIST  User's Guide
  313. Getting Started
  314. ______________________________________________________________________________
  315.  
  316. Varieties of LIST.COM
  317.  
  318.  
  319.  
  320.     The documentation file is marked  with | before new and  changed
  321.     lines.  It is marked  with a double asterisk  ** for LIST PLUS
  322.     only features.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346. WARNING:  LIST PLUS (LIST.COM), HAS THE ABILITY TO *DELETE*
  347.                    FILES FROM YOUR SYSTEM!!
  348.  
  349.  
  350. IF YOU ELECT TO USE LIST PLUS, PLEASE READ THE SECTION ON THE FILE SELECTION
  351. MENU FOUND LATER ON IN THIS MANUAL.
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366. LIST  User's Guide                                                    Page  4
  367. Definition of DOS terms
  368. ______________________________________________________________________________
  369.  
  370.  
  371.  
  372. DOS Redirection
  373.  
  374.     The output of a  DOS command can be  "redirected" to a device  other
  375.     than  the  standard  output  device,  which  is  in  most cases, the
  376.     monitor.  This is done simply by entering the command, followed by a
  377.     ">" and then the name of the desired device.  For example.
  378.  
  379.     If you type "DIR > FILE.LST" you will see nothing on your screen and
  380.     then suddenly your  DOS prompt will  reappear.  What happened?   The
  381.     "output" of the DIR command was "redirected" to the file, FILE.LST.
  382.  
  383.     In the same manner, you  could enter the following command  and send
  384.     the contents of FILE.LST to your printer, like so: "TYPE FILE.LST  >
  385.     LPT1"
  386.  
  387.     The ">" symbol stands for  redirection of output to another  device.
  388.     Broken down simply, the following command is saying:
  389.  
  390.                     DIR            >       FILE.LST
  391.           (send output of this)  (TO)   (This device, which is a file)
  392.  
  393.     By the same token, you can also redirect "input" to a DOS command or
  394.     a program like SORT  by using the "<"  symbol.  Here is an  example:
  395.     "SORT  <  FILE.LST"  This  command  would  take  the  information in
  396.     FILE.LST  and  "redirect"  it  into  SORT.   For more information on
  397.     redirection, you  may want  to consult  a DOS  manual or  other such
  398.     reference.
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420. Page  5                                                    LIST  User's Guide
  421. Definition of DOS terms
  422. ______________________________________________________________________________
  423.  
  424.  
  425.  
  426. DOS Filters
  427.  
  428.     FILTERS are  commands, or  programs, that  read data  from an  input
  429.     device, and  then rearranges  or "filters"  the data  before it then
  430.     outputs the  filtered information  to an  output device.   DOS comes
  431.     with several "filters", one of which is SORT.  The following command
  432.     would sort the file in alphabetical order.
  433.  
  434.                                 SORT < FILE.LST
  435.  
  436.     You are redirecting the file,  FILE.LST through the SORT filter  and
  437.     it is rearranging the file.  Taking what you know about  redirection
  438.     and  filters,  you  could  now  send  your  alphabetical list to yet
  439.     another  file  by  entering:  SORT  <  FILE.LIST  > ALPHA.LST, which
  440.     redirects FILE.LST into the SORT "filter" and then redirects the new
  441.     output  to  the  file  ALPHA.LST.   LIST  also has some very helpful
  442.     "filters" built  right into  it and  we'll discuss  these later  on.
  443.     Simply keep in mind that when  you use a "filter" it will  rearrange
  444.     or alter the  information into a  form that is  more presentable, or
  445.     useful, to you.
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474. LIST  User's Guide                                                    Page  6
  475. Definition of DOS terms
  476. ______________________________________________________________________________
  477.  
  478.  
  479.  
  480. DOS Pipes
  481.  
  482.     Pipes are  quite similar,  in some  ways, to  redirection.  They are
  483.     "connections" between two programs or two commands or a command  and
  484.     a program.   Pipes take  data that  is output  from one  program and
  485.     redirect it as input to a second program.  The DOS symbol for a pipe
  486.     is the vertical bar "|".  To redirect the output from one program or
  487.     command to another, you simply type the first command followed by  a
  488.     vertical bar and  then followed by  the second command.   Here is an
  489.     example of piping.
  490.  
  491.                                 DIR | FIND "-88"
  492.  
  493.     This command tells DOS to send the output of the DIR command,  which
  494.     you would normally see on the  screen, and send it through the  FIND
  495.     filter.  FIND  would be  searching each  line for  the string "-88".
  496.     Only the files in the current directory that have a 1988 date  stamp
  497.     would be displayed on the screen!  You can use more than one  "pipe"
  498.     in a command.  Take this final example:
  499.  
  500.                        DIR | FIND "-88" | SORT/+14 > PRN
  501.  
  502.     A "pipe" takes the  output of the DIR  command and converts it  into
  503.     input for the FIND  filter.  Then, a second  "pipe" is used to  send
  504.     the output from FIND as input  to the SORT filter.  As a  last step,
  505.     output from  SORT is  redirected to  the printer!   What would  this
  506.     command do??   It would  take the  DIR of  the current directory and
  507.     pipe it through the FIND filter, looking for files created in  1988.
  508.     Then the next pipe would SORT that information, sorting the files by
  509.     SIZE (the 14th column of each line) and then send the output to  the
  510.     printer.  For  more information  on PIPES,  consult a  DOS manual or
  511.     other reference.
  512.  
  513.     Now that you have  a basic understanding of  redirection, filtering,
  514.     and piping, we will go on to discuss the command line of LIST.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528. Page  7                                                    LIST  User's Guide
  529. Command line
  530. ______________________________________________________________________________
  531.  
  532.  
  533.  
  534. Command line syntax
  535.  
  536.     The command line format is:
  537.  
  538.  
  539.         LIST [filespec...filespec] [/switches]
  540.  
  541.  
  542.     You may supply  one or more  file specifications (filespecs).   LIST
  543.     will display  each file  which has  a filename  matching one  of the
  544.     filespecs.  If you  do not supply  one, LIST will  prompt you for  a
  545.     filespec, or present you with a file selection menu.
  546.  
  547.  
  548.  
  549. Command line switches
  550.  
  551.                 /S       indicates viewing a piped or redirected file
  552.  
  553.                 /J       sets Junk filter on
  554.                 /7       sets 7-bit display
  555.                 /8       sets 8-bit display
  556.                 /*       sets star filter on
  557.  
  558.                 /W       sets Wrap on
  559.                 /H       sets Hex dump mode
  560.                 /L       sets pre-Loading on
  561.  
  562.                 /M       allows use of a mouse for moving the cursor
  563.                 /K       disables mouse for cursor positioning
  564.  
  565.                 /E       begin displaying the file at the end of the file
  566.  
  567.                 /Ftext   tells LIST to Find the 'text' immediately by
  568.                          searching all specified files
  569.  
  570.                 /#nnnn   begins displaying the file at record 'nnnnnn'
  571.  
  572.     The command line switch character is normally a slash, "/", but LIST
  573.     will use whatever  character that is  defined to DOS  as the command
  574.     line switch character, e.g. a  dash, "-".  Depending on your  needs,
  575.     you could load LIST using  any of these command line  switches, such
  576.     as:
  577.  
  578.                LIST MYFILE.TXT /W   which would set Word Wrap ON.
  579.  
  580.                LIST MYFILE.TXT /J   which turns on the JUNK filter
  581.  
  582. LIST  User's Guide                                                    Page  8
  583. How to use LIST
  584. ______________________________________________________________________________
  585.  
  586. Starting LIST
  587.  
  588.     To  start  LIST,  you  type  the  command  LIST,  at the DOS prompt,
  589.     followed by  the name(s)  of the  files that  you want  to see.  For
  590.     example:
  591.  
  592.           C:>LIST CONFIG.SYS        (displays file CONFIG.SYS)
  593.  
  594.           C:>LIST *.DOC    (displays all DOC files in current directory)
  595.  
  596.     The "filename" is optional.  If  omitted, LIST PLUS will bring  up a
  597.     display of ALL  files and subdirectories  in the current  directory.
  598.     You may use  the cursor keys  to highlight the  file that you  would
  599.     like to work  on and press  ENTER.  Or, you  may highlight any  sub-
  600.     directory entry and press ENTER to change to that subdirectory.
  601.  
  602.     You  may  also  use  LIST  to  display piped or redirected files.  A
  603.     discussion of redirection, piping, and filtering is at the beginning
  604.     of this manual.
  605.  
  606.     To display a redirected file, use a < (less than symbol) before  the
  607.     name of the file that was redirected and add the /S parameter to the
  608.     LIST command.
  609.  
  610.     For example, the output of the DIR command can be written to a  file
  611.     called XYZ, and then LIST can be instructed to read that file.
  612.  
  613.                 dir a: >xyz
  614.                 list <xyz /s
  615.  
  616.     To see a piped file, omit the filename, but supply the /S.
  617.  
  618.                 dir a: | list /s
  619.  
  620.     Or, to LIST a file within an ARC archive:
  621.  
  622.                 ARC /p arcname.arc filename.ext | list /s
  623.                                 - or -
  624.                 ARCE arcname filename.ext /p | list /S
  625.  
  626.     Here,  the  ARC   or  ARCE  program   is  invoked  to   extract  the
  627.     'filename.ext' file.   The /P  switch for  these programs  sends the
  628.     output to the  standard output device,  and this output  is piped to
  629.     LIST.  Once the  file is  displayed on your screen,  you may use the
  630.     cursor positioning  keys to  move around  and see different parts of
  631.     the file.  There are  also commands to search for text, print, split
  632.     the screen, display  other  files,  change  colors,  change  the way
  633.     the data is displayed, and many other operations.
  634.  
  635.  
  636. Page  9                                                    LIST  User's Guide
  637. How to use LIST
  638. ______________________________________________________________________________
  639.  
  640. Exiting LIST
  641.  
  642.  
  643.     There are several ways  to exit LIST depending  on how you want  the
  644.     screen to look.
  645.  
  646.     The F10 command returns you to DOS with the DOS prompt on the bottom
  647.     line.  The  last page  that was  displayed by  LIST is  left on  the
  648.     screen.
  649.  
  650.     The ESCape key also returns you to DOS without changing the  screen.
  651.     In LIST PLUS, the ESCape key is also used to cancel an operation, or
  652.     to exit file selection menu.
  653.  
  654.     The X command  returns you to  DOS and clears  the screen.  The  DOS
  655.     prompt is on the top line of the screen.
  656.  
  657.     The Alt-X command uses the screen saving feature.  It returns you to
  658.     DOS and displays the screen that you had before LIST was run.
  659.  
  660.  
  661.   Entering Commands
  662.  
  663.     You enter  commands by  pressing a  single key,  or a combination of
  664.     keys.  There  are often  several ways  to perform  the same function
  665.     with different keys.  For example, D and PgDn both perform a  scroll
  666.     down one page function.   This lets you pick  the keys that you  are
  667.     most accustomed to.
  668.  
  669.     When  you  press  keys,  they  are  entered  into a keyboard buffer.
  670.     Holding down a key can put many copies of that key into the  buffer.
  671.     This means that when you let up  on a key, the program can still  be
  672.     processing input from the keyboard buffer.  For example, by  holding
  673.     down the PgDn key, LIST scrolls down one page for each time the PgDn
  674.     key is placed in the keyboard  buffer.  When you let up on  the key,
  675.     the buffer may not yet be empty and LIST will continue to page down.
  676.     To make  LIST stop  when you  let up  on a  key, you  use the  Alt-K
  677.     key-ahead toggle.
  678.  
  679.     Keyboard enhancement utilities,  such as PCED,  may also change  the
  680.     way that LIST reads the keyboard.  With PCED, for example,  pressing
  681.     the ESCape key at a prompt is different.  You do not see the /  that
  682.     DOS normally sends when you cancel an input line.
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690. LIST  User's Guide                                                    Page  10
  691. How to use LIST
  692. ______________________________________________________________________________
  693.  
  694. Display Format
  695.  
  696.     The monitor  display is  defined in  terms of  lines and columns.  A
  697.     typical  monitor  can  display  25  lines  of 80 columns each.  LIST
  698.     attempts to use the number of lines and columns for the monitor mode
  699.     in use.  For  example, if the  monitor is in  132 column mode,  LIST
  700.     displays 132 characters per line.   If the monitor is set  for other
  701.     than 25 lines, such as 35, 43, or 50 lines, LIST displays that  many
  702.     lines per screen.
  703.  
  704.     If  you  use  the  Alt-E  command  to  change EGA/VGA modes, the EGA
  705.     palette,  cursor,  and  other  settings  are  set to the DOS default
  706.     values.  LIST does not preserve fonts or palettes.
  707.  
  708.     The top line of the display  is called the Status line.  The  bottom
  709.     line is called the Command line.  The remaining lines are called the
  710.     primary display window, and are usually lines two through 24.
  711.  
  712.   Status Line Format
  713.  
  714.     The Status line has two formats. The default format is:
  715.  
  716. ┌──────────────────────────────────────────────────────────────────────┐
  717. │ LIST   lllll nnnnnnn +sss mm/dd/yy hh:mm  - filename                 │
  718. └──────────────────────────────────────────────────────────────────────┘
  719.         where,
  720.  
  721.         'LIST'     is the name of this program
  722.  
  723.         'lllllll'  is the line number of the first line in the primary
  724.                    display window (under the status line)
  725.  
  726.         'nnnnnnn'  is the line number of the last record of the file;
  727.                    if the last record of the file has not been read,
  728.                    this field is blank
  729.  
  730.         '+sss'     if displayed, this is the Scroll amount, in multiples
  731.                    of 10, corresponding to the number of columns that
  732.                    the display has been shifted to the right to view
  733.                    records longer than 80
  734.  
  735.         'mm/dd/yy' is the file's creation date (not today's date)
  736.         'hh:mm'    is the file's creation time (not today's time)
  737.  
  738.         'filename' is the name of the file you are currently viewing
  739.  
  740.  
  741.     Note: The date  and time shown  on the top  line is NOT  the current
  742.     date.  It is the date and time that the file was created.
  743.  
  744. Page  11                                                    LIST  User's Guide
  745. How to use LIST
  746. ______________________________________________________________________________
  747.  
  748. Display Format
  749.  
  750.  
  751.  
  752.     Use the Alt-Z command to change the Command Line to this format:
  753. ┌──────────────────────────────────────────────────────────────────────┐
  754. │ LIST      70  2153  +20    09-02-89 18:12     LIST.DOC               │
  755. └──────────────────────────────────────────────────────────────────────┘
  756.  
  757.  
  758.  
  759.  
  760.     By using the Alt-R ruler toggle, the top status line becomes:
  761.  
  762. ┬┬┬┬┼┬┬┬10┬┬┬┬┼┬┬┬20┬┬┬┬┼┬┬┬30┬┬┬┬┼┬┬┬40┬┬┬┬┼┬┬┬50┬┬┬┬┼┬┬┬60┬┬┬┬┼┬┬┬70┬┬
  763.  
  764.  
  765.  
  766.  
  767.  
  768. or, in Hex Dump (Alt-H) display mode:
  769.  
  770. Offset: 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F ----- DATA -----
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798. LIST  User's Guide                                                    Page  12
  799. How to use LIST
  800. ______________________________________________________________________________
  801.  
  802.   Command Line Format
  803.  
  804.  
  805. The Command line has two formats.  The default format is:
  806.  
  807. ┌──────────────────────────────────────────────────────────────────────┐
  808. │ Command                      Keys: ^v-><- PgUp PgDn F10=exit F1=Help │
  809. └──────────────────────────────────────────────────────────────────────┘
  810.  
  811. and the optional format after using the Alt-Z toggle is:
  812.  
  813. ┌──────────────────────────────────────────────────────────────────────┐
  814. │ Command                       Toggles: h8kMpswTclJ  F10=exit F1=Help │
  815. └──────────────────────────────────────────────────────────────────────┘
  816.  
  817.         where,
  818.  
  819.         'command' indicates the current process:
  820.  
  821.           'Command '   function prompt; you are being asked to enter
  822.                        a command; enter the letter, or press the keys
  823.                        for the action to be performed
  824.  
  825.           'Reading '   the file data is being read
  826.           'Filter  '   the file data is being formatted for display
  827.           'Looking '   the Scan/Find text is being searched for
  828.  
  829.           'Scan    '   you are being asked to enter text to locate
  830.           'Find    '   in the file, up to 31 characters may be entered
  831.  
  832.           '# lines?'   you are being asked to enter a 1 to 5 digit
  833.                        number that is the amount of lines to skip
  834.  
  835.           'Line #? '   you are being asked to enter a 1 to 5 digit
  836.                        line number to which the display is to be
  837.                        positioned
  838.  
  839.           'message' may be one of:
  840.  
  841.           '*** Text not found ***'
  842.            the Scan/Text was not found in the file
  843.  
  844.           '   *** Top of file ***'
  845.            the first line of the file is being displayed
  846.  
  847.           '   *** End-of-file ***'
  848.            the last line of the file is being displayed
  849.  
  850.  
  851.  
  852. Page  13                                                    LIST  User's Guide
  853. How to use LIST
  854. ______________________________________________________________________________
  855.  
  856.   Command Line Format
  857.  
  858.         Toggles: indicate status of toggles, lower case means OFF, upper
  859.         case means the option is ON.
  860.  
  861.         'H'       indicates that the hex Dump display option is in use
  862.         'b'       the 'b' is replaced by a 7, 8, or * depending
  863.                   on which of those options is in effect
  864.         'K'       indicates that the Keyboard flush option is in use
  865.         'M'       indicates that tests for monitor retrace are not made
  866.         'P'       indicates that Print is in use
  867.         'S'       indicates file sharing option is in use
  868.         'W'       indicates that the Wrap mode is in effect
  869.         'T'       indicates that TAB characters are expanded
  870.         'C'       toggles continuous scrolling
  871.         'L'       indicates that the pre-loading option is on
  872.         'J'       indicates that line feeds are added to lone carriage
  873.                   return control characters, and backspaces are handled
  874.  
  875.         A sample Command Line might look like this, after looking for
  876.         a word that was not found:
  877.  
  878. ┌──────────────────────────────────────────────────────────────────────┐
  879. │ Command *** Text not found *** Toggles: h*kMpswTclJ  F10=exit F1=Help│
  880. └──────────────────────────────────────────────────────────────────────┘
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906. LIST  User's Guide                                                    Page  14
  907. How to use LIST
  908. ______________________________________________________________________________
  909.  
  910. Scrolling
  911.  
  912.  
  913.     You view different parts of the file by scrolling.  That is, you use
  914.     the cursor  positioning keys  up, down,  left and  right to move the
  915.     display one  increment in  that direction.   For example,  press the
  916.     down  arrow  key  to  move  the  display  one line in the file, i.e.
  917.     display the next line in the file.
  918.  
  919.  
  920.     The PgDn and PgUp  cursor keys move the  display one full screen  in
  921.     either direction.
  922.  
  923.  
  924.     Rather than press the up and  down keys once for each line,  you may
  925.     use  continuous  scrolling.   Use  the  C  key  to toggle continuous
  926.     scrolling on or off.  The default is off.  When toggled on, pressing
  927.     the up or down arrow keys results in a moving display.  For example,
  928.     when  you  press  the  down  arrow,  the  next  line  of the file is
  929.     displayed automatically  every second,  or so.   It is  like holding
  930.     down the arrow key.  To stop the continuous scroll, press the  space
  931.     bar.
  932.  
  933.  
  934.     The speed of the continuous scroll can be adjusted by pressing the +
  935.     (plus) or - (minus) key while  the display is moving.  The plus  key
  936.     makes  the  display  move  faster,  and  the minus key makes it move
  937.     slower.  You can save the  speed value by using the  cloning command
  938.     (see Configuring LIST, Cloning, later on in this documentation.
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960. Page  15                                                    LIST  User's Guide
  961. How to use LIST
  962. ______________________________________________________________________________
  963.  
  964. Scrolling
  965.  
  966.  
  967.         Summary of scrolling commands:
  968.  
  969.  
  970.             right arrow - move display right 10 columns
  971.             left arrow  - move display left 10 columns
  972.  
  973.             down arrow  - display next line of file
  974.             up arrow    - display previous line of file
  975.  
  976.             PgUp key    - display previous "page", 23 (or 41) lines back
  977.             PgDn key    - display next "page", 23 (or 41) lines ahead
  978.  
  979.             C key       - turns continuous scrolling on or off
  980.  
  981.             spacebar    - or any key, interrupts continuous scrolling
  982.  
  983.             + (plus)    - makes continuous scroll incrementally faster
  984.             - (minus)   - makes continuous scroll slower
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014. LIST  User's Guide                                                    Page  16
  1015. How to use LIST
  1016. ______________________________________________________________________________
  1017.  
  1018. Positioning to Lines
  1019.  
  1020.  
  1021.     Each displayable line  of the file  is assigned a  line number.  The
  1022.     first line is  assigned line number  1.  The highest  allowable line
  1023.     number is 16 million.
  1024.  
  1025.     In order to  determine the last  line number of  a file, the  entire
  1026.     file must be  read.  For this  reason, the first  time that the  END
  1027.     (bottom) command is issued, it will take longer to process.  This is
  1028.     not necessary if  the file has  been completely read  (see the Alt-L
  1029.     preloading option).
  1030.  
  1031.     If the Wrap option is in  effect, there is one line number  required
  1032.     for each 80 bytes of the file's records.  Thus, the line number does
  1033.     not represent the actual number of lines in the file.
  1034.  
  1035.     If  the  hex  dump  option  is  in  effect, there is one line number
  1036.     required for  each 16  bytes of  the file.   For example, an 80-byte
  1037.     line will be displayed as 5 lines.
  1038.  
  1039.     You may position to a  specific line number by using  the Ctrl-Home,
  1040.     or the # key.  When Ctrl-Home  is entered, you are prompted for  the
  1041.     line number.   Enter the  line number.   The display  will now begin
  1042.     with that line number at the top of the screen.
  1043.  
  1044.     To position  forward or  backward, you  may use  the +  (plus), or -
  1045.     (minus) keys.  You are prompted to  enter the number of lines to  be
  1046.     skipped.  The display  resumes at the  line number shown  on the top
  1047.     (status) line, plus or minus the number of lines that you specified.
  1048.  
  1049.     When you change  a filter option,  such as Wrap,  the line numbering
  1050.     changes.  An attempt is made  to retain the same file  position, but
  1051.     the file may be repositioned at the top.
  1052.  
  1053.     You may also reposition to the last "active" line by using the Alt-Y
  1054.     bookmark command.   The last  active line  is one  displayed after a
  1055.     Scan or Find command, or marked using the  Alt-M or  Alt-B commands,
  1056.     or the line set by the Ctrl-Y bookmark command.  Up to ten book mark
  1057.     lines may be saved by Ctrl-Y and recalled by Alt-Y
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068. Page  17                                                    LIST  User's Guide
  1069. How to use LIST
  1070. ______________________________________________________________________________
  1071.  
  1072. Positioning to Lines
  1073.  
  1074.  
  1075.     Summary of positioning commands:
  1076.  
  1077.  
  1078.         Ctrl-HOME, or #  - Prompts for exact line number to display
  1079.  
  1080.         + (plus)         - Prompts for the number of lines to skip
  1081.                            for positioning further ahead in the file
  1082.  
  1083.         - (minus)        - Prompts for the number of lines to skip
  1084.                            for positioning to an earlier line
  1085.  
  1086.         Alt-Y            - Reposition to the last bookmark
  1087.  
  1088.         Ctrl-Y           - Set new bookmark line number
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. LIST  User's Guide                                                    Page  18
  1123. How to use LIST
  1124. ______________________________________________________________________________
  1125.  
  1126. Filtering
  1127.  
  1128.  
  1129.     Filtering is the term used to describe the process that LIST uses to
  1130.     format file data  for displaying on  a monitor.  After  data is read
  1131.     from a file, it is  filtered.  The method of filtering  depends upon
  1132.     the options in effect.   LIST is fastest with no filter options set.
  1133.  
  1134.     For a typical  ASCII text file,  the filter removes  carriage return
  1135.     and line feed characters, and expands TAB characters.
  1136.  
  1137.     Because files  contain different  kinds of  data, there  are several
  1138.     commands to  tell LIST  how to  display the  data.  The process that
  1139.     LIST uses to make the  file data readable is called  filtering.  The
  1140.     filters in LIST can:
  1141.  
  1142.             o  replace non-text and control characters with blanks
  1143.             o  expand TAB characters
  1144.             o  display line drawing characters
  1145.             o  change 8-bit (W*) data to readable 7-bit text **
  1146.             o  display the hexadecimal values for each character
  1147.             o  remove "junk", such as control codes and backspaces
  1148.  
  1149.            **  W* is an abbreviation for WordStar (tm) formatted files
  1150.                which contain 'high-bit' characters. Using the '*' filter
  1151.                makes these files easier to read.
  1152.  
  1153.     LIST was designed primarily to display ASCII files;  that is,  files
  1154.     which  contain  text,  and  not  binary  or  control  codes.    Text
  1155.     characters, like A-Z and 0-9,  are in the 7-bit range.  Binary files
  1156.     like .COM and .EXE files, contain the full range of 8-bit characters
  1157.     and the  Alt-H (hex dump display)  command is available  for viewing
  1158.     them.
  1159.  
  1160.     Characters  above  127  (the  8-bit  range)  may  be  valid  graphic
  1161.     characters, and may  be displayed if  the '8' command  is in effect.
  1162.     To insure that characters above  ASCII value 127 are NOT  displayed,
  1163.     use the '7' command to limit the display to characters in the  7-bit
  1164.     range.
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176. Page  19                                                    LIST  User's Guide
  1177. How to use LIST
  1178. ______________________________________________________________________________
  1179.  
  1180. Filtering
  1181.  
  1182.  
  1183.   Wrap Filter
  1184.  
  1185.     The file is displayed with one logical record on each display  line:
  1186.     usually 80 characters.  A logical record ends in a linefeed and  may
  1187.     be up to 2048 characters long.   If a record  exceeds 80 characters,
  1188.     you may view the portion beyond  the 80 columns by using the  scroll
  1189.     right command, or by using  the Wrap feature.  The Wrap  (W) command
  1190.     toggles ON or OFF the  wrapping of lines longer than  80 characters.
  1191.     With Wrap on, lines are  displayed in their entirety, 80  characters
  1192.     per  display  line.   The  scroll  left  (arrow)  and  right (arrow)
  1193.     functions are disabled when Wrap is ON.
  1194.  
  1195.  
  1196.   Hi-bit Filter
  1197.  
  1198.     The 7,  8, and  * (asterisk)  commands determine  whether characters
  1199.     above  ASCII-127  are  displayed.   If  the  hi-bit option is off (7
  1200.     command), the filter strips the high order bit from each  character.
  1201.     If the hi-bit  option is on  (8 command), all  characters, including
  1202.     graphic characters above ASCII-127, are displayed.
  1203.  
  1204.  
  1205.   Star Filter
  1206.  
  1207.     The  star  (*  or  asterisk)  command displays only ASCII characters
  1208.     below 128 (x'80'), but treats the special characters x'8A' and x'8D'
  1209.     as  line-feed  and  carriage-return  control  characters.  Any other
  1210.     characters above 127 are treated as spaces, and control codes  below
  1211.     ASCII-26 are replaced by blanks.
  1212.  
  1213.  
  1214.   Junk Filter
  1215.  
  1216.     The  Alt-J  command  toggles  the  "junk"  filter which insures that
  1217.     carriage  returns  in  the  file  also  result in a new line.  Also,
  1218.     backspace  characters  result  in  "backing  up"  the display by one
  1219.     position.   This   allows  more   readability  of   files  that  use
  1220.     backspacing to emphasize, or over-write, characters.
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230. LIST  User's Guide                                                    Page  20
  1231. How to use LIST
  1232. ______________________________________________________________________________
  1233.  
  1234. Filtering
  1235.  
  1236.  
  1237.   Hex Format Filter
  1238.  
  1239.     The hex  dump option  (Alt-H) causes  the filtering  to reformat the
  1240.     file data into a DEBUG-like  display format.  The largest file  that
  1241.     can be displayed in Hex is 4 million bytes.
  1242.  
  1243.     An attempt is made to  retain the file position when  switching from
  1244.     normal to  hex-dump display,  but due  to filtering  changing record
  1245.     lengths, the hex display may begin before the current record.
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.     Summary of filtering commands:
  1252.  
  1253.         8       show all characters as-is
  1254.         7       strip the hi-bit from each character
  1255.         *       use the star filter to remove control characters
  1256.                 and some special word processor characters
  1257.  
  1258.         Alt-J   use the "junk" filter
  1259.         Alt-H   use the "hex" filter to display in hex dump format
  1260.         Alt-T   expand TAB control characters
  1261.         Alt-W   wrap long lines to fit on screen
  1262.  
  1263.         Ctrl-I  define TAB interval
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284. Page  21                                                    LIST  User's Guide
  1285. How to use LIST
  1286. ______________________________________________________________________________
  1287.  
  1288. Scanning for text
  1289.  
  1290.  
  1291.     There are three ways  to initiate a search  for text.  First is  the
  1292.     Find (\ or F) command.  Use this command to search for text  without
  1293.     regard to the case (upper or  lower) of the letters.  Second is  the
  1294.     Scan (/ or S) command.  Use  this command to search an exact  match.
  1295.     That is, the search is case sensitive.
  1296.  
  1297.     The third way to initiate a  search for text is with the  /F command
  1298.     line switch.  With it, you supply  the text to search for, and  LIST
  1299.     begins the search before displaying the file, and before asking  for
  1300.     commands.  The search continues  through all selected files  until a
  1301.     match is found, or the last file has been searched.  This search  is
  1302.     case sensitive.
  1303.  
  1304.     Each search begins at  the line displayed on  the top of the  screen
  1305.     and proceeds in a forward direction until the end of file.  You  may
  1306.     start a search that goes backwards rather than forwards by using the
  1307.     ` (left quote) key instead of Find (\), or by using ' (right  quote)
  1308.     instead of Scan (/).
  1309.  
  1310.     To enter the Scan search text, type a slash (/) followed by up to 31
  1311.     characters.  The Scan  text is displayed  on the command  line.  The
  1312.     Scan is  case sensitive.   That is,  lower case  Scan text will only
  1313.     match lower case file text.
  1314.  
  1315.     While the program is searching for the text, the bottom display line
  1316.     is changed to say "Looking".   Pressing ANY key while the  search is
  1317.     in progress will terminate the search and display the message  'Text
  1318.     not found' on the bottom line.
  1319.  
  1320.     If the  text is  found, the  line containing  it is  displayed as  a
  1321.     high-intensity line (bright color) in  the middle of the screen. The
  1322.     search text is displayed in reverse video colors on the  highlighted
  1323.     line.  The line where the  found text  is displayed  depends on  the
  1324.     setting of the "Find Row" (see Configuration section).
  1325.  
  1326.     The display is scrolled left or right, as needed, so that the  found
  1327.     text is visible.
  1328.  
  1329.     If the text is  NOT found, the command  line is changed to  say '***
  1330.     Text not found ***', and the rest of the display remains unchanged.
  1331.  
  1332.     To  find  the  next  occurrence  of  the  same  text, use the A)gain
  1333.     command, or press the  F3 key.  If you  wish to continue the  search
  1334.     through all of the remaining files, use the Alt-A command.  To  find
  1335.     the previous occurrence, press the F9 key.
  1336.  
  1337.  
  1338. LIST  User's Guide                                                    Page  22
  1339. How to use LIST
  1340. ______________________________________________________________________________
  1341.  
  1342. Scanning for text
  1343.  
  1344.     If the a keyboard enhancement  program, such as PCED, is  installed,
  1345.     the up/down cursor  keys may be  used to recall  and edit previously
  1346.     entered Scan/Find text.
  1347.  
  1348.     In  a  shared  file  environment,  if  the  file changes while being
  1349.     listed, the file position may become invalid.  Use the HOME  command
  1350.     to  insure  proper  file  synchronization,  or  use the Alt-S (share
  1351.     files) command again.
  1352.  
  1353.  
  1354.  
  1355.     Summary of scanning commands:
  1356.  
  1357.  
  1358.                 / or S     Scan for text with exact match
  1359.  
  1360.                 v or '     Scan for text going backwards
  1361.  
  1362.  
  1363.                 \ or F     Find text with case insensitive search
  1364.  
  1365.                 ^ or `     Find case insensitive text going backwards
  1366.  
  1367.  
  1368.                 F3 or A    Find next occurrence of text
  1369.  
  1370.                 F9         Find previous occurrence of text
  1371.  
  1372.  
  1373.  
  1374.                 Alt-A      Scan for next occurrence of the text, and continue
  1375.                            on to the next file until the text is found
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392. Page  23                                                    LIST  User's Guide
  1393. How to use LIST
  1394. ______________________________________________________________________________
  1395.  
  1396. Marking and Extracting Lines
  1397.  
  1398.  
  1399.     There are two ways that lines can be extracted from a file:
  1400.  
  1401.  
  1402.               o  with the P (print) and Alt-P (print marked) commands,
  1403.               o  with the Alt-D (dump data) and Alt-O commands.
  1404.  
  1405.  
  1406.     The  lines  to  be  extracted  are  either  the current lines on the
  1407.     screen,  or  lines  that  you  have  marked with the Alt-M and Alt-B
  1408.     commands.
  1409.  
  1410.  
  1411.     To mark  lines, you  use either  the Alt-M  or Alt-B  commands.  The
  1412.     Alt-M command marks the top line on the screen, and Alt-B marks  the
  1413.     bottom line on the screen.  You  can use either or both commands  to
  1414.     mark the  starting and  ending lines  (in the  range of  lines to be
  1415.     extracted).  The marked lines are displayed in reverse video.
  1416.  
  1417.  
  1418.     After you have marked  a range of lines,  you use the Alt-P  (print)
  1419.     command to print all of the marked lines.  Or, you can use the Alt-D
  1420.     (dump  data)  command  to  write  those  lines to a file.  The Alt-D
  1421.     command asks you for a file name.  If the file does not exist, a new
  1422.     one is created.  If the file already exists, the extracted lines are
  1423.     added (appended) to the file.
  1424.  
  1425.  
  1426.     For example, you would like to have LIST filter out all of the  junk
  1427.     in a file, and then write a  new file.  To do this, you might  enter
  1428.     the following sequence of commands:
  1429.  
  1430.  
  1431.                 list TESTDATA           ... display your TESTDATA file
  1432.                 Alt-J                   ... filters out the junk
  1433.                 Alt-M                   ... marks line 1 (top line)
  1434.                 END                     ... positions to end of file
  1435.                 Alt-B                   ... marks the bottom line
  1436.                                                      (last line)
  1437.                 Alt-D                   ... dumps data to a file
  1438.                 TESTDATE.NEW            ... you enter the new file name
  1439.                 Alt-X                   ... quit and return to DOS
  1440.  
  1441.  
  1442.     Once you have marked  a range of lines,  use of Alt-M or  Alt-B does
  1443.     not reset the entire line range.  The first or last marked line  may
  1444.     change,  but  both  do  not  change.   Using  Alt-M again expands or
  1445.  
  1446. LIST  User's Guide                                                    Page  24
  1447. How to use LIST
  1448. ______________________________________________________________________________
  1449.  
  1450. Marking and Extracting Lines
  1451.  
  1452.     contracts the range appropriately.  If the new line for  Alt-M/Alt-B
  1453.     is before the top mark, the top  mark is moved.  If the new line  is
  1454.     after the bottom mark, the bottom mark is changed.  If the new  line
  1455.     is within  the currently  marked range,  Alt-M moves  the top mark -
  1456.     contracts the range - and Alt-B moves the bottom mark.
  1457.  
  1458.  
  1459.     If no lines are marked, but there is a "found" line on the screen as
  1460.     the result of a search by Scan or Find, Alt-D  and Alt-O  will write
  1461.     the found line to the file.
  1462.  
  1463.  
  1464.     Use the Alt-U command to unmark lines, especially after Alt-D (dump)
  1465.     to be sure.
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500. Page  25                                                    LIST  User's Guide
  1501. How to use LIST
  1502. ______________________________________________________________________________
  1503.  
  1504. Printing
  1505.  
  1506.  
  1507.     The file may be PRINTed as it is displayed, in its entirety, or from
  1508.     a range of lines that you  mark.  If the printer is not  online, you
  1509.     will receive an error message, and nothing will be printed.
  1510.  
  1511.  
  1512.     The P command  toggles the printer  on or off.   When first entered,
  1513.     the P command causes the current screen to be printed.  As new lines
  1514.     are displayed, they too are printed.  For example, pressing the down
  1515.     arrow will display and print the next line of the file.
  1516.  
  1517.  
  1518.     Printing may be  stopped by entering  another P command.   The PrtSc
  1519.     key may also be used, but the title and prompt lines will be printed
  1520.     with the lines of the file.  Empty lines cause a line to be  skipped
  1521.     on the  printer.  The  capital letter  P is  displayed on the status
  1522.     line while printing if the bottom line is set to show TOGGLES.
  1523.  
  1524.  
  1525.     The Ctrl-P command prints the file in its entirety.
  1526.  
  1527.  
  1528.     The Ctrl-F command  sends a form  feed to the  printer.  The printer
  1529.     may be the LPT1 or PRN device.
  1530.  
  1531.  
  1532.     The Alt-P command prints only lines that have been marked.
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554. LIST  User's Guide                                                    Page  26
  1555. How to use LIST
  1556. ______________________________________________________________________________
  1557.  
  1558. Displaying multiple files
  1559.  
  1560.  
  1561.     You can display more than one  file at a time.  LIST keeps  track of
  1562.     up to 32 files at a  time.  You supply the filenames in  the command
  1563.     line,  through  the  Alt-F  (get  new filespec) command, through the
  1564.     Alt-I  (insert  filespec)  command,  and  through  the  Alt-V   file
  1565.     selection menu.
  1566.  
  1567.     You  can  specify  up  to  16  filespecs  on the command line.  Each
  1568.     filespec can contain wildcards.  Thus, several files can be selected
  1569.     via the command line.  For example,
  1570.  
  1571.                           LIST *.DOC  *.TXT
  1572.  
  1573.     will display all files with an extension of DOC and TXT.
  1574.  
  1575.     To display the next file, you use the Q or Ctrl-PgDn command.   When
  1576.     the last file has been displayed, you can exit LIST by using the  X,
  1577.     F10, ESCape, or Alt-X commands, depending on how you want the screen
  1578.     to look when LIST ends.
  1579.  
  1580.     To display  the previous  file,  you use the Z or Ctrl-PgUp (control
  1581.     and PgUp keys together).  The 1 command  restarts the  displaying of
  1582.     files  with the first file.  LIST  can keep  track of up to 32 files
  1583.     at one time.  The line number for each file is remembered.
  1584.  
  1585.  
  1586.     The Alt-F asks you for a new  file name, and you may enter a  simple
  1587.     file name, or  one that includes  wild cards.  These  new file names
  1588.     are added to the table of filenames that LIST keeps.  Thus, you  can
  1589.     use Alt-F for several different filenames, and use the Ctrl-PgDn and
  1590.     Ctrl-PgUp commands to move among them.
  1591.  
  1592.     The Alt-I command  allows you to  select a filespec  that is in  the
  1593.     file you are  viewing.  You position  the cursor to  the filespec on
  1594.     the  screen,  and  press  enter  to  add  it to the list of files to
  1595.     display.
  1596.  
  1597.     The Alt-V command displays a list of file in the current  directory.
  1598.     You move the cursor  to a file that  you want to display,  and press
  1599.     enter to add that file to the list.
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608. Page  27                                                    LIST  User's Guide
  1609. How to use LIST
  1610. ______________________________________________________________________________
  1611.  
  1612. Displaying multiple files
  1613.  
  1614.  
  1615.     Summary of file review commands:
  1616.  
  1617.         Q               - display next file, if any
  1618.         Z               - display previous file
  1619.  
  1620.         Ctrl-PgUp       - display previous file
  1621.  
  1622.         Ctrl-PgDn       - display next file
  1623.  
  1624.         1               - restart displaying with first file
  1625.  
  1626.         Alt-F           - prompt for new filename or filespec to display
  1627.  
  1628.         Alt-I           - insert a filespec that is displayed
  1629.  
  1630.         Alt-V           - select a file from a menu
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662. LIST  User's Guide                                                    Page  28
  1663. How to use LIST
  1664. ______________________________________________________________________________
  1665.  
  1666. Windows
  1667.  
  1668.  
  1669.     LIST can  display data  in one  or two  parts of  the screen  called
  1670.     windows.   The  Alt-W  command  toggles  this  split  screen   mode.
  1671.     Entering Alt-W while the screen  is split restores the display  to a
  1672.     single, full sized display.
  1673.  
  1674.  
  1675.     In the regular version, the screen is split in the middle.  The  top
  1676.     half of the screen remains the same, and the bottom half becomes the
  1677.     part of the screen where files are displayed.  Thus, the top  window
  1678.     becomes a scratch pad.
  1679.  
  1680.  
  1681.     In the LIST PLUS version, you are allowed to split the screen at any
  1682.     point.  After entering Alt-W, you  are asked to position the  cursor
  1683.     to the spot where the screen  will be split.  By placing the  cursor
  1684.     in column 1, you can adjust how  many lines will be used by the  top
  1685.     and bottom windows.  This would  be a vertical, or one  window above
  1686.     the other, split.
  1687.  
  1688.     By positioning the cursor to the top line with the HOME key, you can
  1689.     then use the left  and right arrow keys  to adjust how wide  each of
  1690.     the windows is to be.   This would be a horizontal,  or side-by-side
  1691.     split.
  1692.  
  1693.     You may display  a different file  in each window,  and move between
  1694.     them.  You use the Ctrl-V command  to switch from one window to  the
  1695.     other.  You may also use the Review commands to display a  different
  1696.     file in the second window.
  1697.  
  1698.     Each window uses different colors.   You can use the color  commands
  1699.     to set the colors that you  like, and then use the Alt-C  command to
  1700.     save them.
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716. Page  29                                                    LIST  User's Guide
  1717. How to use LIST
  1718. ______________________________________________________________________________
  1719.  
  1720. Telephone dialer
  1721.  
  1722.  
  1723.     LIST has a simple telephone dialer function.  It allows you to point
  1724.     to a telephone number that is  displayed on the screen, and to  send
  1725.     dialing commands to your modem on COM1.
  1726.  
  1727.  
  1728.     You use the  Ctrl-T command to  start the dialer.   You position the
  1729.     cursor, with the arrow  keys, to the start  of the phone number  and
  1730.     press enter.  The phone number  may contain any character, but  must
  1731.     end with a blank.
  1732.  
  1733.  
  1734.     If the phone rings, you may pick up your telephone.  Otherwise,  you
  1735.     may press <enter> to return to viewing the file, <spacebar> to  dial
  1736.     the number again, or ESCape to hang up and stop dialing.
  1737.  
  1738.  
  1739.     The Ctrl-H command hangs up the telephone.
  1740.  
  1741.  
  1742.     If you are using a communications  port other than  COM1:,  see  the
  1743.     file DIALER.PAT for  information on  changing LIST  to use  COM2: or
  1744.     another COM port.
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770. LIST  User's Guide                                                    Page  30
  1771. DOS considerations
  1772. ______________________________________________________________________________
  1773.  
  1774.  
  1775. File Sharing
  1776.  
  1777.     LIST uses two techniques for allowing you to share files with  other
  1778.     processes, such as programs running under multi-tasking systems,  in
  1779.     other windows, or on networks.
  1780.  
  1781.     The first technique is called  "file closing" and is enabled  by the
  1782.     Alt-S commands.  This forces LIST to close the viewed file unless it
  1783.     needs to  read from  the file.   If enough  memory is available, the
  1784.     entire file  may be  loaded once  and thus  leave the  file free for
  1785.     exclusive access by other processes.
  1786.  
  1787.     The second technique is called "file sharing".  It is a function  of
  1788.     DOS and requires  DOS version 3.0  or later.  LIST  opens the viewed
  1789.     files with a DENY NONE request.  This allows other processes to read
  1790.     and write to the  file if they do  not request exclusive use  of the
  1791.     file.  If a file  is not available to  LIST because it is  locked by
  1792.     another process, you will receive the error message "File not found"
  1793.     or "Access denied".  There is  no command to enable or  disable this
  1794.     method of file sharing.  It is implicit with the use of DOS  version
  1795.     3 and later.
  1796.  
  1797.  
  1798.  
  1799. Invoking DOS Commands
  1800.  
  1801.     If the "goto DOS" option is enabled, you may invoke DOS commands  by
  1802.     using the Alt-G command.  LIST reserves about 60k of memory for  its
  1803.     own use.  This increases LIST's memory requirements to approximately
  1804.     96k when using Alt-G.  The remaining memory is available to the  DOS
  1805.     commands.  Alt-G  clears  the  screen and  invokes  the  DOS command
  1806.     processor.
  1807.  
  1808.     After you  have finished  entering DOS  commands, use  the DOS  EXIT
  1809.     command to return to LIST.
  1810.  
  1811.     To disable the "goto DOS" function, you must use DEBUG to alter  the
  1812.     option  byte  described  in  the  section  about  cloning.   With it
  1813.     disabled, LIST requires less memory, about 66K.
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824. Page  31                                                    LIST  User's Guide
  1825. DOS considerations
  1826. ______________________________________________________________________________
  1827.  
  1828.  
  1829.  
  1830. Screen Saving
  1831.  
  1832.     If the screen saving option  is enabled, LIST saves the  contents of
  1833.     the current  display screen  when it  starts.  You  can restore  the
  1834.     original screen by exiting LIST with the Alt-X command.
  1835.  
  1836.     Screen  saving  requires  approximately  10k  more  memory.  This is
  1837.     sufficient to save  60 lines of  80 characters (EGA  8x6 mode).  See
  1838.     the section about Configuring LIST and cloning for information about
  1839.     enabling and disabling the screen saving feature.
  1840.  
  1841.     The  Alt-N command toggles the screen saving feature.  Its status is
  1842.     not displayed on the bottom Line.  The small version is the only one
  1843.     which defaults to disabling screen saving.
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878. LIST  User's Guide                                                    Page  32
  1879. File Selection Menu
  1880. ______________________________________________________________________________
  1881.  
  1882. LIST PLUS Display
  1883.  
  1884.  
  1885.     LIST PLUS has several new functions that greatly enhance the  things
  1886.     that you can do.  If you load the file  LIST.COM (LIST PLUS) with no
  1887.     file specification, you would see something like this:
  1888.  
  1889.  
  1890. ┌──────────────────────────────────────────────────────────────────────┐
  1891. │ LIST - File Selection        1 of 40      Path: C:\*.*               │
  1892. └──────────────────────────────────────────────────────────────────────┘
  1893.  ^..         ░            ░
  1894.  vWPW        ░WPSMALL .DRS░
  1895.  vMAIN       ░            ░
  1896.  vWORK       ░            ░
  1897.  CONVERT .EXE░WPWSTAR .HLP░
  1898.  STANDARD.PRS░WP}WP{  .TV1░
  1899.  WP      .EXE░STORY   .DOC░
  1900.  WP      .FIL░FINDER  .LTR░
  1901.  WP      .MRS░            ░
  1902. ┌──────────────────────────────────────────────────────────────────────┐
  1903. │ List  Copy  Del Edit  Move  Path  Ren Sort Viewarc  1-6 up  F10=Exit │
  1904. └──────────────────────────────────────────────────────────────────────┘
  1905.  
  1906.  
  1907.     Note that the Command Line contains the following choices:
  1908.  
  1909.        LIST, COPY, DEL, EDIT, MOVE, PATH, RENAME, VIEWARC, SORT, 1-6 up
  1910.  
  1911.     Each of these commands may be executed from within LIST PLUS and are
  1912.     described below.
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932. Page  33                                                    LIST  User's Guide
  1933. File Selection Menu
  1934. ______________________________________________________________________________
  1935.  
  1936. LIST PLUS Display
  1937.  
  1938.  
  1939.  
  1940. Movement Keys
  1941.  
  1942.     Use the arrow keys to move  the cursor to a filename.  The  filename
  1943.     at  the  cursor  is  highlighted.   The  other  cursor  and filename
  1944.     selection keys are:
  1945.  
  1946.                 PgDn            - displays the next page of files
  1947.                 PgUp            - displays the previous page of files
  1948.  
  1949.                 HOME            - positions to the first filename
  1950.                                   on the screen
  1951.                 END             - positions to the last filename
  1952.                                   on the screen
  1953.  
  1954.                 Ctrl-HOME       - positions to the first filename
  1955.                 Ctrl-END        - positions to the last filename
  1956.  
  1957.                 F1              - displays a Help screen
  1958.                 F10             - exits to DOS in new directory
  1959.                 ESCape          - exits to DOS in the original directory
  1960.                 Q               - returns to viewing the last file, or
  1961.                                   exits to DOS if no files were selected
  1962.                 X               - exits to DOS in the new directory
  1963.                 Alt-C           - save settings (clone LIST.COM)
  1964.                 Alt-X           - exits to DOS and displays the screen as
  1965.                                   it was before LIST was used
  1966.                 Alt-Z           - toggles bottom line display from a menu
  1967.                                   command line (above) to a statistics line:
  1968.  
  1969. ┌───────────────────────────────────────────────────────────────────────┐
  1970. │ Files: 59   Used: 2367312   Free 1616912  F2=Menu F1=Help F10=Exit │
  1971. └───────────────────────────────────────────────────────────────────────┘
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986. LIST  User's Guide                                                    Page  34
  1987. File Selection Menu
  1988. ______________________________________________________________________________
  1989.  
  1990. LIST PLUS Display
  1991.  
  1992.  
  1993. Changing Directories
  1994.  
  1995.     Any subdirectories contained  in the current  directory will have  a
  1996.     down arrow  next to  them.  If  you highlight  one of  these and hit
  1997.     Enter you will go to that directory.  If the directory that you  are
  1998.     in  is  a  subdirectory  itself,  there  will  be an up arrow .. and
  1999.     selecting this will take you  up.  Thus, you can easily  move around
  2000.     your hard disk from within LIST!
  2001.  
  2002.  
  2003. List file
  2004.  
  2005.     This invokes LIST just as  you would from DOS. Simply  highlight the
  2006.     file that you wish to view, enter a carriage return, and you will be
  2007.     in LIST looking  at the selected  file.  When you  are finished, you
  2008.     may escape back to the original screen, with all of its options.
  2009.  
  2010.     You may also open  a window and then,  using the Alt-V command,  get
  2011.     another  file  directory  and  select  another  file to view.  Using
  2012.     Alt-W, you can load more than two files.
  2013.  
  2014.  
  2015. Copy file
  2016.  
  2017.     This  function  allows  you  to  copy  the  selected  file  to a new
  2018.     subdirectory.  Highlight the file you want to copy and press  ENTER.
  2019.     You will be  prompted  for the  new  path to  which you want to copy
  2020.     the selected file.  Enter  the path,  press ENTER,  and the  file is
  2021.     copied to the directory you indicated.
  2022.  
  2023.  
  2024. Delete file
  2025.  
  2026.     Allows  you  to  delete  any  file  in  the current directory.  Just
  2027.     highlight the  file you  want to  delete and  press ENTER.  You will
  2028.     then be prompted  to make sure  that you want  to delete this  file.
  2029.     Enter Y if you do, and N if you do not.
  2030.  
  2031.  
  2032. Edit file
  2033.  
  2034.     Invokes the EDIT program for the selected file.  If you do not have
  2035.     an editor called  EDIT,  create a batch file called EDIT.BAT  which
  2036.     calls your editor with the parameters that you like. For example,
  2037.  
  2038.                    peii %1 /pc:\pe2.pro /q
  2039.  
  2040. Page  35                                                    LIST  User's Guide
  2041. File Selection Menu
  2042. ______________________________________________________________________________
  2043.  
  2044. LIST PLUS Display
  2045.  
  2046.  
  2047. Invoke file
  2048.  
  2049.     Executes the selected file if it has an extension of .BAT, .COM, or
  2050.     .EXE.  LIST reserves about 80k of memory and leaves the rest for use
  2051.     by the executed program. The I command is not listed on the menu.
  2052.  
  2053.  
  2054. Move file
  2055.  
  2056.     Move  any  file  in  the  current  directory to any other directory.
  2057.     Select the file that you want to move by highlighting it and hitting
  2058.     ENTER.  You will then  be prompted for a  new path.  Enter the  path
  2059.     and the file is moved to it's new location.
  2060.  
  2061.  
  2062. Path changing
  2063.  
  2064.     This function allows  you to switch  to ANY other  directory on your
  2065.     system without having to exit LIST!  Enter 'P' for Path, and type in
  2066.     the full path of the directory that you would like to change to, for
  2067.     example: C:\DNLD.  You will find yourself in the selected  directory
  2068.     and still within LIST.
  2069.  
  2070.  
  2071. Rename
  2072.  
  2073.     Using  this  function  you  can  rename  any  file  in  the  current
  2074.     directory.  Highlight the  file that you  want to rename.   You will
  2075.     then be prompted for  the new file name.   After you have entered  a
  2076.     new file name,  you will be  prompted to make  sure that you  really
  2077.     want to rename this file.  If so, then respond with a 'Y'; if you've
  2078.     changed  your  mind,  just  answer  with  an  'N'  and  the renaming
  2079.     procedure will be abandoned.
  2080.  
  2081.  
  2082. Sort filenames
  2083.  
  2084.     Allows you to sort the files in the current directory by file  name,
  2085.     extension, date, or size.  Once you have completed the operation you
  2086.     will find yourself back at the menu screen of LIST.
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094. LIST  User's Guide                                                    Page  36
  2095. File Selection Menu
  2096. ______________________________________________________________________________
  2097.  
  2098. LIST PLUS Display
  2099.  
  2100.  
  2101. 1-6 up display
  2102.  
  2103.     This function lets you set the display to anywhere from 1 to 6  file
  2104.     names per line.   In subdirectories with  few numbers of  files, you
  2105.     will begin to see not only file name, but file size, date, time, and
  2106.     attributes as well.  You can customize this to suit your tastes.
  2107.  
  2108.  
  2109. ViewArc
  2110.  
  2111.     This function will let you  view the directory of an  archive (.ARC,
  2112.     .ZIP, etc.) file, or self-extracting .COM and .EXE archive files.
  2113.  
  2114.     After you have viewed the desired file's directory, press ESCape  to
  2115.     return to the  file selection menu,  or use the  Alt-I (insert file)
  2116.     command to display a file within the archive file.
  2117.  
  2118.     The directory listing is written to a temporary file in  the current
  2119.     directory and is called  FVFVFVFV.FV$.  You may  tell LIST  to place
  2120.     the  temporary  file elsewhere  by setting  an  environment variable
  2121.     called LIST.  For example, to place all ViewArc and  Alt-I extracted
  2122.     temporary files on drive D in the subdirectory called TEMP,  use the
  2123.     DOS SET command prior to invoking LIST:
  2124.  
  2125.                      SET LIST=D:\TEMP
  2126.  
  2127.             To view  archive directories,  the program  FV.COM is
  2128.             required.  It must be located in a directory included
  2129.             in your PATH.
  2130.  
  2131.  
  2132.             To display files within an ARChive file, the  program
  2133.             ARCE.COM is required.  It must be in your PATH.   For
  2134.             ZIP files, the program PKUNZIP  must  be in your PATH.
  2135.  
  2136.             Files with a .COM or .EXE extension are assumed to be
  2137.             self-extracting LHARC (.LZH) files.
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148. Page  37                                                    LIST  User's Guide
  2149. Command key summary
  2150. ______________________________________________________________________________
  2151.  
  2152. Cursor keys
  2153.  
  2154.  
  2155.         Cursor key      Function
  2156.         -----------     -----------------------------------------------
  2157.  
  2158.         left arrow      scroll left 10 columns
  2159.         right arrow     scroll right 10 columns
  2160.  
  2161.         up arrow        up one (previous) line
  2162.         down arrow      down one (next) line
  2163.  
  2164.         Enter           continue to next page
  2165.  
  2166.         END             position to end of file (bottom)
  2167.  
  2168.         ESCape          Exit program unconditionally
  2169.  
  2170.         HOME            restart from first line (top)
  2171.  
  2172.         PgUp            scroll up one page, 23 lines
  2173.         PgDn            scroll down one page, 23 lines
  2174.  
  2175.  
  2176. F- function keys
  2177.  
  2178.         Function key    Function
  2179.         ------------    ---------------------------------------------------
  2180.  
  2181.          F1             Displays the HELP screen
  2182.  
  2183.          F3             Find NEXT occurrence of text after Scan or Find
  2184.  
  2185.          F9             FInd the PREVIOUS occurrence of text
  2186.  
  2187.          F10            Exit to DOS
  2188.  
  2189.          For changing display colors:
  2190.  
  2191.          F2             Change background color for Find/Scan text
  2192.          F4             Change foreground color for Find/Scan text
  2193.  
  2194.          F5             Change background color for main body of display
  2195.          F6             Change foreground color for main body of display
  2196.  
  2197.          F7             Change background color for top and bottom lines
  2198.          F8             Change foreground color for top and bottom lines
  2199.  
  2200.  
  2201.  
  2202. LIST  User's Guide                                                    Page  38
  2203. Command key summary
  2204. ______________________________________________________________________________
  2205.  
  2206. Letter keys
  2207.  
  2208.  
  2209.     The Letter key commands are  mnemonic.  That is, the letter  in some
  2210.     way, indicates what the command does.
  2211.  
  2212.         Letter(s)      Function
  2213.         ---------     -----------------------------------------------
  2214.  
  2215.         A            Find next occurrence of 'text' (Again)
  2216.  
  2217.         B            Skip to end of file (Bottom)
  2218.  
  2219.         C            Toggles Continuous scrolling
  2220.  
  2221.         D            Scroll Down one page
  2222.  
  2223.         F            Find 'text' regardless of case
  2224.  
  2225.         G            Get new filename/filespec (also Alt-F)
  2226.  
  2227.         H            Display the Help screen.
  2228.  
  2229.         K            Toggles keyboard key-ahead.
  2230.  
  2231.         L            Scroll LEFT 10 columns
  2232.  
  2233.         M            Toggles Monitor retrace testing to eliminate snow
  2234.  
  2235.         N            Down one (Next) line
  2236.  
  2237.         P            Toggles the printing of displayed lines.
  2238.  
  2239.         Q            Quits current file and displays next file, if any
  2240.  
  2241.         R            Scroll Right 10 columns. command,  the  'R' command
  2242.  
  2243.         S            Scan for exact text match, case dependent
  2244.  
  2245.         T            Restart from first line (Top)
  2246.  
  2247.         U            Scroll Up one page (23 lines)
  2248.  
  2249.         W            Toggles the Wrap option for displaying long lines
  2250.  
  2251.         X            Terminate, clear screen and eXit to DOS
  2252.  
  2253.         Z            Display the previous file.
  2254.  
  2255.  
  2256. Page  39                                                    LIST  User's Guide
  2257. Command key summary
  2258. ______________________________________________________________________________
  2259.  
  2260. Letter keys
  2261.  
  2262.         7            Toggles the 7-bit filter
  2263.  
  2264.         8            Toggles the 8-bit filter
  2265.  
  2266.         *            Toggles the star filter
  2267.  
  2268.         +            Position a given number of lines forward
  2269.  
  2270.         -            Position a given number of lines backward
  2271.  
  2272.         ?            Displays the Help screen
  2273.  
  2274.         space        Scrolls down one page
  2275.  
  2276.         \text        Find any case 'text' going forward
  2277.  
  2278.         /text        Scan exact case 'text' going forward
  2279.  
  2280.         ` or ^       Find any case 'text' going backward
  2281.  
  2282.         ' or v       Find exact case 'text' going backward
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310. LIST  User's Guide                                                    Page  40
  2311. Command key summary
  2312. ______________________________________________________________________________
  2313.  
  2314. Control- keys
  2315.  
  2316.     The Ctrl- key commands are entered  by pressing the Ctrl key at  the
  2317.     same time as you press one of the following letter keys:
  2318.  
  2319.         Control key     Function
  2320.         -----------     ---------------------------------------------------
  2321.  
  2322.         Ctrl-HOME       Position to a specific line by number
  2323.  
  2324.         Ctrl-PgDn       Display next file
  2325.  
  2326.         Ctrl-PgUp       Display previous file
  2327.  
  2328.         Ctrl-left       Reset display to column 1, i.e. scroll full left
  2329.  
  2330.         Ctrl-right      Scroll full right (to the end of the current line)
  2331.  
  2332.         Ctrl-A          Scroll full left
  2333.  
  2334.         Ctrl-C          Display next page, scroll down
  2335.  
  2336.         Ctrl-D          Scroll right 10 columns
  2337.  
  2338.         Ctrl-E          Display previous line, scroll up 1 line
  2339.  
  2340.         Ctrl-F          Send a formfeed control character to the printer
  2341.  
  2342.         Ctrl-H    **    Hang up the telephone
  2343.  
  2344.         Ctrl-N          Display previous file
  2345.  
  2346.         Ctrl-P          Print the entire file
  2347.  
  2348.         Ctrl-R          Display previous page, scroll up
  2349.  
  2350.         Ctrl-S          Scroll left 10 columns
  2351.  
  2352.         Ctrl-T    **    Dial a telephone number
  2353.  
  2354.         Ctrl-U          Display previous file
  2355.  
  2356.         Ctrl-V    **    Switch display windows
  2357.  
  2358.         Ctrl-W          Display previous line, scroll up one line
  2359.  
  2360.         Ctrl-Y    **    Save current line number as bookmark line for Alt-Y
  2361.  
  2362.         Ctrl-X          Display next line, scroll down one line
  2363.  
  2364. Page  41                                                    LIST  User's Guide
  2365. Command key summary
  2366. ______________________________________________________________________________
  2367.  
  2368. Alt- keys
  2369.  
  2370.     The Alt- key  commands are entered  by pressing the  Alt key at  the
  2371.     same time as you press one of the following letter keys:
  2372.  
  2373.     Alt- letter      Function
  2374.     -----------      ---------------------------------------------------
  2375.  
  2376.      Alt-A           Search for next occurrence of text, continue to next
  2377.                      file until found
  2378.  
  2379.      Alt-B           Mark bottom line of display
  2380.  
  2381.      Alt-C           Copy options and setting to LIST.COM
  2382.  
  2383.      Alt-D           Write marked lines, or found line, to a file
  2384.  
  2385.      Alt-E           Toggle 25 or 43/50 line display with EGA or VGA
  2386.  
  2387.      Alt-F           Enter additional filenames to display
  2388.  
  2389.      Alt-G           Goto DOS temporarily to enter DOS commands
  2390.  
  2391.      Alt-I    **     Insert a filespec from the screen display
  2392.  
  2393.      Alt-H           Toggle Hex display mode
  2394.  
  2395.      Alt-J           Toggle the "junk" filter
  2396.  
  2397.      Alt-L           Toggle preloading of files
  2398.  
  2399.      Alt-M           Mark the line at the top of the display
  2400.  
  2401.      Alt-N           Toggle the Alt-X screen saving feature
  2402.  
  2403.      Alt-O           Write marked lines, or found line, to the same file
  2404.                      used by Alt-D
  2405.  
  2406.      Alt-R           Toggle the display of a ruler line on top line
  2407.  
  2408.      Alt-S           Toggle the file Sharing option
  2409.  
  2410.      Alt-T           Toggle the TAB control character filer
  2411.  
  2412.      Alt-U           Unmark lines marked by Alt-M and Alt-B
  2413.  
  2414.      Alt-V    **     Invoke the File Selection Menu
  2415.  
  2416.      Alt-W           Toggle split screen
  2417.  
  2418. LIST  User's Guide                                                    Page  42
  2419. Command key summary
  2420. ______________________________________________________________________________
  2421.  
  2422. Alt- keys
  2423.  
  2424.  
  2425.      Alt-X           Exit  to DOS  and display  the original screen
  2426.  
  2427.      Alt-Y           Reposition to the last "active" line (bookmark)
  2428.  
  2429.      Alt-Z           Toggles the command line in the bottom line.  The
  2430.                      default is to display the cursor key usage.   Using
  2431.                      Alt-Z changes  the bottom  line to  show the option
  2432.                      switches "Toggles:" settings.
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472. Page  43                                                    LIST  User's Guide
  2473. Configuring LIST
  2474. ______________________________________________________________________________
  2475.  
  2476. Screen Colors
  2477.  
  2478.  
  2479.     The screen's lines may be in one of three different colors:
  2480.  
  2481.                 o  the 'special' color for the top status line and the
  2482.                    bottom command line
  2483.                 o  the 'normal' color for the file's text windows
  2484.                 o  the 'bright' color for lines with Find/Scan text,
  2485.                    and for the upside-down question mark in 7-bit mode
  2486.  
  2487.     There is a pair  of function keys assigned  to each color.  You  use
  2488.     these  function  keys  at  any  time  to  change  the background and
  2489.     foreground colors temporarily, or  use the Alt-C cloning  command to
  2490.     make the colors permanent.  Alt-C requires that the LIST.COM program
  2491.     file be on the current drive and in the current directory unless you
  2492.     are using DOS version 3.3 or later.  With DOS 3.3, the program  file
  2493.     may have any name and may reside in any subdirectory.
  2494.  
  2495.     The border  is not  changed.  The  foreground color  applies to  the
  2496.     color of the characters.
  2497.  
  2498.     You may clone a  second set of text  colors for the second,  and any
  2499.     other windows that you may create.
  2500.  
  2501.     The color attributes may be changed by using these function keys:
  2502.  
  2503.           For the main body of text:
  2504.  
  2505.                 F5 - background color
  2506.                 F6 - foreground color
  2507.  
  2508.           For the top and bottom lines:
  2509.  
  2510.                 F7 - background color
  2511.                 F8 - foreground color
  2512.  
  2513.           For the line with Find/Scan text:
  2514.  
  2515.                 F2 - background color
  2516.                 F4 - foreground
  2517.  
  2518.     Once you have decided upon the colors, use the Alt-C key combination
  2519.     to  change  the  LIST.COM  program  file.  This process is described
  2520.     below.
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526. LIST  User's Guide                                                    Page  44
  2527. Configuring LIST
  2528. ______________________________________________________________________________
  2529.  
  2530. Cloning
  2531.  
  2532.  
  2533.     The screen colors, the display retrace testing (M), the file sharing
  2534.     (S), ruler (Alt-R), and other options may be permanently set in  the
  2535.     program COM file by using the Alt-C cloning function.
  2536.  
  2537.     For cloning to  take effect, the  program should be  called LIST.COM
  2538.     and on the current drive and in the current directory.
  2539.  
  2540.     There  are  THREE  versions  of  the  LIST program file.  One is the
  2541.     normal full program, which is LISTR.COM. The other, which is  called
  2542.     LISTS.COM, is a slightly smaller file that excludes the Help screen.
  2543.     The third is LIST PLUS,  found as LIST.COM.  You may use any of  the
  2544.     three  COM  files  for  cloning.   After  cloning,  you may continue
  2545.     viewing  the  file.   Several  of  the  command  toggles  are   also
  2546.     'clonable'.
  2547.  
  2548.     The values and toggles that are cloned are:
  2549.  
  2550.              M      =  Mono monitor, affects retrace testing. If you see
  2551.                        "snow" on your color monitor, turn off this option
  2552.  
  2553.              Alt-S  =  file(s) are shared
  2554.  
  2555.              W      =  Wrap long lines
  2556.  
  2557.              8/7/*  =  display all 256 values, or 7-bit, or special case
  2558.  
  2559.              K      =  flush Keyboard each time a command is read
  2560.  
  2561.              Alt-H  =  hex dump display, like the DEBUG format
  2562.  
  2563.              Alt-J  =  toggle "junk" filter, add LF to CR, fix backspaces
  2564.  
  2565.              Alt-L  =  set on to force preloading (reading) of the entire
  2566.                        file before any lines are displayed, Default is OFF.
  2567.  
  2568.              Alt-N  =  toggles screen saving (see Alt-X) feature
  2569.  
  2570.              Alt-R  =  toggle columnar ruler on top line
  2571.  
  2572.              Alt-T  =  toggle expansion of TAB characters (also Ctrl-I)
  2573.  
  2574.              Alt-V  =  number of filenames per line (up value) and sort method
  2575.  
  2576.              F2     =  change background color for Find/Scan text
  2577.              F4     =  change foreground color for Find/Scan text
  2578.  
  2579.  
  2580. Page  45                                                    LIST  User's Guide
  2581. Configuring LIST
  2582. ______________________________________________________________________________
  2583.  
  2584. Cloning
  2585.  
  2586.              F5     =  change background color for main body of display
  2587.              F6     =  change foreground color for main body of display
  2588.  
  2589.              F7     =  change background color for top and bottom lines
  2590.              F8     =  change foreground color for top and bottom lines
  2591.  
  2592.     Note:  Be  sure  you  have  no  other  copies  of LIST.COM which are
  2593.     accessible (because  of an APPEND   type  of utility).   If you  are
  2594.     familiar with the DOS utility DEBUG, you may want to modify LIST  in
  2595.     that way.  This is described in the next section.
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634. LIST  User's Guide                                                    Page  46
  2635. Configuring LIST
  2636. ______________________________________________________________________________
  2637.  
  2638. Modifying LIST.COM
  2639.  
  2640.  
  2641.   Locations of option values
  2642.  
  2643.     This information is offered to those of you who wish to modify  LIST
  2644.     in special ways.  You do not need this information to use LIST.   An
  2645.     alternative to cloning  is to use  DEBUG to make  permanent changes.
  2646.     Here is a list of key items and their addresses:
  2647.  
  2648.            0132 - special lines 1 and 25 colors, default is 70 (reverse).
  2649.                   Refer to a technical reference guide for the
  2650.                   attribute values for the colors that you want.
  2651.  
  2652.            0134 - normal lines 2 thru 24 colors, default is 07 (white)
  2653.  
  2654.            0136 - bright color for Find/Scan, default is 0F (bright white)
  2655.  
  2656.            0138 - color used for text for first window, default is 07 (white)
  2657.            0139 - color used for second window, default is 0F (bright white)
  2658.  
  2659.            013A - clonable options;
  2660.                MRSJ WHK*  M = mono, retrace testing if off, x'01'
  2661.                           R = ruler, x'02'
  2662.                           S = shared, x'04'
  2663.                           J = add LF to lone CR, process backspaces,
  2664.                               if on, x'08'; default is off
  2665.                           W = wrap mode, x'10'
  2666.                           H = hi-bit on, x'20'
  2667.                           K = kybd flush, x'40'
  2668.                           * = special document filtering, x'80'
  2669.  
  2670.            013B - more clonable options, not all are indicated:
  2671.                .PAT DGV.  P = Preload file if on, x'02', default is off
  2672.                           A = Apxcore if on, TV/DD/DV if off, x'04,
  2673.                               default is for Topview/Double DOS use
  2674.                           T = if on (default), expand TABs, x'08'
  2675.                           D = hex display mode if on, x'10'
  2676.                           G = if on, Alt-G goto DOS is Disabled, x'20'
  2677.                           V = if on, screen save/restore is Disabled
  2678.                               and 9K less memory is used/required, x'40'
  2679.  
  2680.     By specifying the bit value, the option is enabled.  For example, to
  2681.     enable Shared and Retrace, specify a hex value of the sum, or  01+04
  2682.     = 05.
  2683.  
  2684.            013C - row less one at which found text is displayed,  1 byte
  2685.                   the default is 08 which displays found text on line  9
  2686.  
  2687.  
  2688. Page  47                                                    LIST  User's Guide
  2689. Configuring LIST
  2690. ______________________________________________________________________________
  2691.  
  2692. Modifying LIST.COM
  2693.  
  2694.  
  2695.  
  2696.     When the  Find/Scan command  is used,  the next  line which contains
  2697.     that text is highlighted using the 'bright' color, and is placed  in
  2698.     row 9 of the screen.  You can change the row by Altering the byte at
  2699.     location 12F which is normally '08', one less than the row.
  2700.  
  2701.            013E - scroll offset value,  default is 10 (x'0A'),  one byte
  2702.  
  2703.            0140 - scroll starting value, default is 0 (x'00'), one byte
  2704.  
  2705.            0142 - tab increment, default is 8
  2706.  
  2707.            0144 - tab mask, subtract tab incr from FFFFh,default is FFF8
  2708.  
  2709.            0146 - beep tone, default is 200 (hex C800)
  2710.  
  2711.            0148 - key rate, one byte, default is FF (255)
  2712.  
  2713.            0149 - page overlap, one word, default is 0000
  2714.  
  2715.            014B - search wildcard escape character, default is & (ampersand)
  2716.  
  2717.            014C - Alt-V filenames per line, one byte, default is 5-up
  2718.  
  2719.            014E - 'COM:' eye-catcher for dialer values
  2720.            0152 - COM port address, default is F803 for COM1:
  2721.            0154 - Alt-V menu sort key: 00=filename, 08=ext, 0C=date, 10=size
  2722.            0157 - 30-byte modem initialization string
  2723.            0175 - 8-byte name of EDITor program
  2724.            017E - 9-byte modem disconnect command string
  2725.            0187 - 4-byte environment variable name for temporary files path
  2726.  
  2727.            038F - WHAT eye-catcher
  2728.            0393 - WHAT keys/function table (see below)
  2729.  
  2730.            0498 - WHERE eye-catcher
  2731.            049D - WHERE routines table
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742. LIST  User's Guide                                                    Page  48
  2743. Configuring LIST
  2744. ______________________________________________________________________________
  2745.  
  2746. Modifying LIST.COM
  2747.  
  2748.  
  2749.   Reassigning keys
  2750.     LIST performs a function for every character that can be entered  at
  2751.     the command line prompt.  There  are 128 regular characters and  131
  2752.     extended characters.  The regular characters are numbered from 0  to
  2753.     127, and  they include  the letters  A-Z, a-z,  the numbers, and the
  2754.     rest of  the usual  single characters  found on  your keyboard.  The
  2755.     extended characters represent special function keys and combinations
  2756.     of keys, such as F1, Alt-X, Ctrl-A, and the cursor positioning keys.
  2757.  
  2758.     The  WHAT  table  in  LIST  has  a  one  byte  entry for each of the
  2759.     characters.  This byte is a number from 0 to 57 that represents  the
  2760.     identification of a routine that performs a function.
  2761.  
  2762.         For example,
  2763.  
  2764.           - the ESCape key has a value  of 27 (hex 1B) and its value  in
  2765.             the WHAT table is 16 (10 hex).  Routine number 16 is  called
  2766.             "Done".  The "Done" routine exits to DOS.
  2767.  
  2768.           - the Q key has a value of 81 (51 hex) with a routine value of
  2769.             15  for  the  "Close"  routine.   The  "Close"  routine ends
  2770.             viewing of the  current file and  tries to display  the next
  2771.             file, i.e. wildcards used for the filename.  There is also a
  2772.             lower case letter q, so be sure to change both entries.
  2773.  
  2774.     To change the function that a command character performs, you change
  2775.     the  value  in  the  WHAT  table  for the routine that the character
  2776.     invokes.
  2777.  
  2778.     For example, to  change the ESCape  key to act  like the Q  key, you
  2779.     change the routine  value for ESCape  from 16 (10  hex) to a  15 (0F
  2780.     hex).
  2781.  
  2782.     To find the location of the  routine value in the WHAT table,  first
  2783.     determine the value of the  character, e.g.  ESCape is 27  (1B hex),
  2784.     and then add that to the  location of the WHAT table (36C  hex); or,
  2785.     1B + 36C = 387 hex.  Finally,  use DEBUG to change the byte at  that
  2786.     location (387 hex) from a 10 hex to a 0F hex.
  2787.  
  2788.     For example,
  2789.  
  2790.           debug list.com                ; use appropriate file name
  2791.           -e 387 0f                     ; change ESC to routine 15
  2792.           -w                            ; old data is 10
  2793.           -q
  2794.  
  2795.  
  2796. Page  49                                                    LIST  User's Guide
  2797. Configuring LIST
  2798. ______________________________________________________________________________
  2799.  
  2800.   Table of Routines
  2801.  
  2802.  
  2803.     Value Key(s)               Description of function performed
  2804.     ----- ---------            ------------------------------------------
  2805.       0                        Error, undefined command
  2806.  
  2807.       2   Alt-E                Toggle EGA 43-line mode
  2808.  
  2809.       3   Alt-F, G             Get new filespec
  2810.  
  2811.       4   Alt-J                Toggle Junk filter
  2812.  
  2813.       5   Alt-L                Toggle pre-Load
  2814.  
  2815.       6   Alt-T                Toggle TABs expansion
  2816.  
  2817.       7   Alt-W                Toggle Split windows
  2818.  
  2819.       8   Alt-X                Exit to DOS, restore screen
  2820.  
  2821.       9   U/up                 Position to previous line
  2822.  
  2823.      10   END, B               Position to end of file
  2824.  
  2825.      11   F5                   Change top/bottom line background color
  2826.  
  2827.      12   F6                   Change top/bottom line foreground color
  2828.  
  2829.      13   Ctrl-HOME            Position to specified line number
  2830.  
  2831.      14   Alt-C                Rewrite LIST.COM with new options
  2832.  
  2833.      15   Q, Ctrl-PgDn         Quit current file, display next file
  2834.  
  2835.      16   ESC, F10             Exit to DOS
  2836.  
  2837.      17   N, down              Position to next line
  2838.  
  2839.      18   X                    Exit to DOS, clear screen
  2840.  
  2841.      19   Alt-H                Toggle Hex display mode
  2842.  
  2843.      20   8                    Leave hi-bit
  2844.  
  2845.      21   \, F                 Search for text, any case matches
  2846.  
  2847.      22   F2                   Change Find/Scan background color
  2848.  
  2849.  
  2850. LIST  User's Guide                                                    Page  50
  2851. Configuring LIST
  2852. ______________________________________________________________________________
  2853.  
  2854.   Table of Routines
  2855.  
  2856.     Value Key(s)              Description of function performed
  2857.     ----- ---------           ------------------------------------------
  2858.      23   F4                  Change Find/Scan foreground color
  2859.  
  2860.      24   Alt-M               Toggle monitor rescan testing
  2861.  
  2862.      25   K, Alt-K            Toggle keyboard flush (type ahead)
  2863.  
  2864.      26   Alt-G               Invoke DOS command (shell)
  2865.  
  2866.      27   L, left             Scroll left 10 columns
  2867.  
  2868.      28   -                   Position back by number of lines
  2869.  
  2870.      29   enter               Display next page
  2871.  
  2872.      30   +                   Position forward by number of lines
  2873.  
  2874.      31   P                   Print current screen or marked lines
  2875.  
  2876.      32   F1 H ?              Display Help screen
  2877.  
  2878.      33   F3, A               Search for next occurrence of text
  2879.  
  2880.      34   R right             Scroll display right 10 columns
  2881.  
  2882.      35   Alt-R               Display ruler marks on top line
  2883.  
  2884.      36   /, S                Search for text, same case
  2885.  
  2886.      37   F9                  Search for previous occurrence of text
  2887.  
  2888.      38   Ctrl-left           Reset scroll to column 1, full left
  2889.  
  2890.      39   F7                  Change normal line background color
  2891.  
  2892.      40   F8                  Change normal line foreground color
  2893.  
  2894.      41   7                   Strip hi-bit
  2895.  
  2896.      42   Alt-S               Toggle closing of files
  2897.  
  2898.      43   *                   Toggle special * filter
  2899.  
  2900.      44   Home, T             Position to top of file
  2901.  
  2902.  
  2903.  
  2904. Page  51                                                    LIST  User's Guide
  2905. Configuring LIST
  2906. ______________________________________________________________________________
  2907.  
  2908.   Table of Routines
  2909.  
  2910.     Value Key(s)              Description of function performed
  2911.     ----- ---------           ------------------------------------------
  2912.  
  2913.      45   B, up               Position back one line
  2914.  
  2915.      46   W                   Toggle display of wide lines
  2916.  
  2917.      47   Alt-D               Write marked lines, or found line, to a file
  2918.  
  2919.      48   Alt-M               Mark top line of display
  2920.  
  2921.      49   Alt-U               Unmark lines
  2922.  
  2923.      50   Alt-B               Mark bottom line of display
  2924.  
  2925.      51   Ctrl-pgup           Display previous file
  2926.  
  2927.      52   ^                   Like Find but initiates search backwards
  2928.  
  2929.      53   v                   Like Scan but initiates search backwards
  2930.  
  2931.      54   Alt-N               Toggle screen saving (Alt-X) function
  2932.  
  2933.      55   C                   Toggle continuous scrolling
  2934.  
  2935.      56   Alt-Y               Bookmark, reposition to last "active" line
  2936.  
  2937.      57   Alt-O               Write marked lines to previous Alt-D file
  2938.  
  2939.      58   Ctrl-F              Sends a formfeed control character to printer
  2940.  
  2941.      59   Alt-A               Continues text search across files
  2942.  
  2943.      60   Ctrl-P              Print the entire file
  2944.  
  2945.      61   Alt-I               Grab a filespec from the display
  2946.  
  2947.      62   Alt-V               File selection menu
  2948.  
  2949.      63   ESCape              Exit from Alt-V file menu
  2950.  
  2951.      64   Alt-Z               Toggle line 25 command line display format
  2952.  
  2953.      65   Ctrl-V              Switch display window
  2954.  
  2955.      66   Ctrl-T              Grab a telephone number and dial the modem
  2956.  
  2957.  
  2958. LIST  User's Guide                                                    Page  52
  2959. Configuring LIST
  2960. ______________________________________________________________________________
  2961.  
  2962.   Table of Routines
  2963.  
  2964.      67   Ctrl-H              Disconnect modem (hang up)
  2965.  
  2966.      68   Ctrl-I              Redefine Tab stop interval
  2967.  
  2968.      69   Ctrl-Y              Set new bookmark line number for recall
  2969.  
  2970.      70   1                   Restart displaying files with the first file
  2971.  
  2972.      71   E                   ASCII or EBCDIC display mode (Enhanced version)
  2973.  
  2974.      72   Ctrl-K              Toggle display of line numbers on each line
  2975.  
  2976.      73   Ctrl-B              Set logical record size for fixed length records
  2977.  
  2978.      74   Ctrl-right          Scroll full right, to the end of the current line
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012. Page  53                                                    LIST  User's Guide
  3013. Limitations
  3014. ______________________________________________________________________________
  3015.  
  3016.  
  3017.  
  3018.      o  The LIST.COM  program requires about  64K  of memory.   If  more
  3019.         memory is available,  it is used  to store more  of the file  in
  3020.         memory.  At least 80K is required  to use the DOS shell, and  9K
  3021.         more is required if the screen saving option (on by default)  is
  3022.         enabled.
  3023.  
  3024.  
  3025.      o  The line number is currently limited to 16 million.
  3026.  
  3027.  
  3028.      o  The file size is limited to 16 million bytes for ASCII  files,
  3029.         and 4 million bytes for hex-dump files.  Versions for larger
  3030.         files are available to licensed users.
  3031.  
  3032.      o  The review limit is 32 files for the regular and Plus versions.
  3033.         The bookmark limit is 10 entries.
  3034.  
  3035.      o  PC DOS Version 2.0 or  later is required.  DOS version 3.0  or
  3036.         later is required for file sharing.
  3037.  
  3038.  
  3039.      o  ANSI.SYS is NOT required.
  3040.  
  3041.  
  3042.  
  3043.         APX Core, DesqView, TopView, Double  DOS, PCED, and IBM are  all
  3044.         copyrighted, trademarked, and all that.
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.     For use by  corporations and other  institutions, please contact  me
  3054.     for a licensing  arrangement.  More information  is supplied in  the
  3055.     file  LICENSE. Customizing and other special licensing are available
  3056.     upon request.  Purchase orders  and invoicing are acceptable.
  3057.  
  3058.  
  3059.                       Vernon D. Buerg
  3060.                       139 White Oak Circle
  3061.                       Petaluma, CA  94952
  3062.  
  3063.  
  3064.  
  3065.  
  3066. LIST  User's Guide                                                    Page  54
  3067. Copyright/License/Warranty
  3068. ______________________________________________________________________________
  3069.  
  3070.  
  3071.     This  document  and  the  program  files  LIST.COM,  LISTS.COM,  and
  3072.     LISTR.COM  ("the  software")  are  copyrighted  by  the author.  The
  3073.     copyright owner hereby licenses you to use the software given  these
  3074.     restrictions:
  3075.  
  3076.           o  the program shall  be supplied in its  original, unmodified
  3077.              form, which includes this documentation;
  3078.  
  3079.  
  3080.           o  for-profit use without a license is prohibited;
  3081.  
  3082.           o  the program may not be  included - or bundled - with  other
  3083.              goods or services.  Exceptions may be granted upon  written
  3084.              request only.
  3085.  
  3086.           o  no  fee  is  charged;  an  exception is  granted to not for
  3087.              profit user's groups, which are permitted to charge a small
  3088.              fee (not  to exceed  $5) for  materials, handling, postage,
  3089.              and general overhead.   No other organization  is permitted
  3090.              to  charge  any  amount  for  distribution of copies of the
  3091.              software  or  documentation,  or  to  include copies of the
  3092.              software or documentation with sales of their own products.
  3093.  
  3094.  
  3095.     There is no warranty  of any kind.  The  copyright owner may not  be
  3096.     held liable  for any  damages, including  any lost  profits or other
  3097.     incidental or consequential damages  arising out of or  inability to
  3098.     use the software.  By using the software, you agree to this.
  3099.  
  3100.  
  3101.     The software and documentation are:
  3102.  
  3103.                 Copyright (C) 1983-1990 by
  3104.                    Vernon D. Buerg
  3105.                    139 White Oak Circle
  3106.                    Petaluma, CA  94952
  3107.  
  3108.                 Data:   (707) 778-8944    VOR 24-hour bulletin board
  3109.                 - or -  (707) 778-8841    MB  24-hour bulletin board
  3110.                 - or -  (415) 994-2944    VOR South 24-hour bulletin board
  3111.                 FAX:    (707) 778-8728    For orders only
  3112.                 Compuserve: 70007,1212    Go IBMSYS
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120. Page  55                                                    LIST  User's Guide
  3121. LIST  User's Guide                                                 Index-1
  3122. __________________________________________________________________________
  3123.  
  3124.  
  3125.  
  3126.   /*,command line,star filter .. 8, 45
  3127.   /7,command line,7-bit option . 8, 45
  3128.   /8,command line,8-bit option . 8
  3129.   /H,command line,hex option ... 8
  3130.   /J,command line,junk filter .. 8
  3131.   /L,command line,preload option 8
  3132.   /S,command line,piping option  8, 9
  3133.   /W,command line,wrap option .. 8
  3134.   1-6 up,directory display ..... 33, 37
  3135.   Alt-A,find text again ........ 22, 23, 42, 52
  3136.   Alt-B,mark bottom line ....... 17, 24, 25, 42, 52
  3137.   Alt-C,clone new LIST.COM ..... 29, 34, 42, 44, 45, 50
  3138.   Alt-D,Write marked lines ..... 24, 25, 42, 52
  3139.   Alt-E,toggle 25/43 lines ..... 3, 11, 42, 50
  3140.   Alt-F,enter new filename ..... 27, 28, 39, 42, 50
  3141.   Alt-G,go to DOS .............. 3, 31, 42, 47, 51
  3142.   Alt-H,toggle hex display ..... 12, 19, 21, 42, 45, 50
  3143.   Alt-I,insert filename ........ 3, 27, 28, 37, 42, 52
  3144.   Alt-J,toggle junk filter ..... 20, 21, 24, 42, 45, 50
  3145.   Alt-K,toggle key ahead ....... 10, 51
  3146.   Alt-L,toggle file preloading . 17, 42, 45, 50
  3147.   Alt-M,mark top line .......... 17, 24, 25, 42, 51, 52
  3148.   Alt-N,toggle screen saving ... 32, 42, 45, 52
  3149.   Alt-O,write marked lines ..... 24, 25, 42, 52
  3150.   Alt-P,print marked lines ..... 24, 26
  3151.   Alt-R,toggle ruler display ... 12, 42, 45, 51
  3152.   Alt-S,toggle file sharing .... 23, 31, 42, 45, 51
  3153.   Alt-T,toggle TAB expansion ... 21, 42, 45, 50
  3154.   Alt-U,unmark lines ........... 25, 42, 52
  3155.   Alt-V,Change Directories ..... 3, 27, 28, 35, 42, 45, 48, 52
  3156.   Alt-W,freeze top window ...... 3, 21, 29, 35, 42, 50
  3157.   Alt-X,exit to DOS ............ 3, 10, 24, 27, 32, 34, 42, 43, 45, 49, 50
  3158.                                  52
  3159.   Alt-Y,reposition to last line  17, 18, 41, 43, 52
  3160.   Alt-Z,Toggle command line .... 12, 13, 34, 43, 52
  3161.   archive,files ................ 37
  3162.   Bookmark,recall position ..... 17, 18, 41, 43, 52, 53, 54
  3163.   bulletin board,support ....... 55
  3164.   Changing Directories ......... 35
  3165.   Cloning ...................... 15, 31, 32, 44, 45, 47
  3166.   Colors ....................... 9, 22, 29, 44, 45, 47
  3167.   Command line syntax .......... 8
  3168.   Command line,option switches . 7, 8, 11, 12, 13, 14, 27, 33, 34, 43, 44
  3169.                                  49, 52
  3170.  
  3171. Index-2                                                LIST  User's Guide
  3172. __________________________________________________________________________
  3173.  
  3174.  
  3175.  
  3176.   Configuring LIST ............. 15, 32
  3177.   Continuous,scrolling ......... 14, 15, 16, 39, 52
  3178.   Copy file .................... 35
  3179.   Ctrl-A,Full left scroll ...... 41, 49
  3180.   Ctrl-C,Next page ............. 41
  3181.   Ctrl-D,Scroll right .......... 41
  3182.   Ctrl-E,Previous line ......... 41
  3183.   Ctrl-F,Send printer formfeed . 26, 41, 52
  3184.   Ctrl-HOME,Position to a line . 17, 18, 34, 41, 50
  3185.   Ctrl-H,Hang up phone ......... 30, 41, 53
  3186.   Ctrl-I,Define TAB interval ... 21, 45, 53
  3187.   Ctrl-left,Position to column 1 41, 51
  3188.   Ctrl-N,Next file ............. 41
  3189.   Ctrl-PgDn,Show next file ..... 27, 28, 41, 50
  3190.   Ctrl-PgUp,Show previous file . 27, 28, 41, 52
  3191.   Ctrl-P,Print entire file ..... 26, 41, 52
  3192.   Ctrl-right,Scroll full right . 41, 53
  3193.   Ctrl-R,Previous page ......... 41
  3194.   Ctrl-S,Scroll left ........... 41
  3195.   Ctrl-T,Dial telephone ........ 3, 30, 41, 52
  3196.   Ctrl-U,Previous file ......... 41
  3197.   Ctrl-V,Switch windows ........ 29, 41, 52
  3198.   Ctrl-W,Previous line ......... 41
  3199.   Ctrl-X,Next line ............. 41
  3200.   Ctrl-Y,Set bookmark .......... 17, 18, 41, 53
  3201.   DEBUG,changing options ....... 21, 31, 45, 46, 47, 49
  3202.   Delete file .................. 35
  3203.   DOS Filters .................. 6
  3204.   DOS Pipes .................... 7
  3205.   DOS Redirection .............. 5
  3206.   Edit file .................... 35
  3207.   Entering Commands ............ 10
  3208.   Environment,DOS .............. 23, 37, 48
  3209.   Exit to DOS .................. 38, 39, 50
  3210.   F- function keys ............. 38
  3211.   F10,Exit to DOS .............. 10, 27, 34, 38, 50
  3212.   F1,Display Help .............. 34, 38, 49, 51
  3213.   F2,Find background color ..... 38, 44, 45, 50
  3214.   F3,Find next ................. 22, 23, 38, 51
  3215.   F4,Find foreground color ..... 38, 44, 45, 51
  3216.   F5,Text background color ..... 38, 44, 46, 50
  3217.   F6,Text foreground color ..... 38, 44, 46, 50
  3218.   F7,Status background color ... 38, 44, 46, 51
  3219.   F8,Status foreground color ... 38, 44, 46, 48, 51
  3220.  
  3221. LIST  User's Guide                                                 Index-3
  3222. __________________________________________________________________________
  3223.  
  3224.  
  3225.  
  3226.   F9,Find previous ............. 22, 23, 38, 51
  3227.   File Sharing ................. 31, 42, 45, 54
  3228.   Filtering .................... 1, 7, 9, 19, 21, 47
  3229.   Find,text .................... 7, 8, 13, 17, 22, 23, 25, 36, 38, 39, 40
  3230.                                  44, 45, 47, 48, 49, 50, 51, 52, 54
  3231.   Hex dump,display mode ........ 8, 12, 14, 19, 21, 45
  3232.   Hi-bit,filter usage .......... 20, 21, 47, 50, 51
  3233.   Installation ................. 2
  3234.   Invoke file .................. 36
  3235.   Invoking DOS Commands ........ 31
  3236.   Junk,filter usage ............ 8, 19, 20, 21, 24, 42, 45, 50
  3237.   License,information .......... 54, 55
  3238.   List file .................... 35
  3239.   Locations of option values ... 47
  3240.   Mouse,cursor control ......... 8
  3241.   Move file .................... 36
  3242.   Movement Keys ................ 34
  3243.   Path changing ................ 36
  3244.   Piped,files .................. 8, 9
  3245.   Piping ....................... 1, 7, 9
  3246.   Printing the manual .......... 2
  3247.   Print,files or lines ......... 2, 9, 14, 24, 26, 41, 51, 52
  3248.   Reassigning keys ............. 49
  3249.   Redirection .................. 1, 2, 5, 6, 7, 9
  3250.   Rename ....................... 36
  3251.   Scan,for text ................ 13, 17, 22, 23, 25, 38, 39, 40, 44, 45, 47
  3252.                                  48, 50, 51, 52
  3253.   Screen saving,option ......... 3, 10, 32, 42, 45, 52, 54
  3254.   Scrolling .................... 15, 16, 39, 52
  3255.   Shell,to DOS ................. 51, 54
  3256.   Sort filenames ............... 36
  3257.   Star,filter usage ............ 8, 19, 20, 21, 33, 40
  3258.   Status Line Format ........... 11
  3259.   Switches,command line ........ 8, 43
  3260.   TAB,control character ........ 14, 19, 21, 42, 45, 48, 53
  3261.   ViewArc ...................... 37
  3262.   Wrap,filter .................. 8, 14, 17, 20, 21, 39, 45, 47
  3263.