home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DIR / FILEL20.ZIP / FILEL.HLP < prev    next >
Encoding:
Text File  |  1991-11-21  |  15.9 KB  |  432 lines

  1.  
  2.                                                                         o o
  3.                                                                       ____oo_
  4.                                F I L E L i s t               1991    /||    |\
  5.                                  Version 2.0                  BNV     ||    |
  6.                              for Dos, Unix & Vms            MARMITA   `.___.'
  7.  
  8.  
  9. ███████▓▓▓▓▓▓▓▒▒▒▒▒▒▒░░░░░░░   T Z A P A W A R E   ░░░░░░░▒▒▒▒▒▒▒▓▓▓▓▓▓▓███████
  10.  
  11.  
  12.                  Author.........Bill N. Vlachoudis
  13.                  Address........Eirinis 4
  14.                                 TK555 35 Pilea
  15.                                 Thessaloniki Greece
  16.                  Computer addr..cdaz0201@Grtheun1.EARN
  17.                                 vlachoudis::olymp.grtheun.our.edu [192.104.147.1]
  18.                  Telephone......(31) 322-805
  19.                  Date...........Nov-1991
  20.  
  21.  
  22.  
  23. This program is NOT a copyrighted software. However, all the files may be
  24. copied and shared with others, so long as no charge is made, and it is
  25. unmodified copied in its entirety.
  26.  
  27.  
  28.  
  29.  
  30.  
  31. What is FILEL?
  32. ==============
  33.  
  34. FILEList is a usefull utility found on IBM VM/CMS systems, it is basically
  35. a shell, but not so high level as all the other shells, so its closer to
  36. the opperating system. When FILEL is invoked it displays a list of the files
  37. like as DIR does, but in a full screen editing environment where you can
  38. issue DOS commands (or from the host operating system) against the files
  39. directly from the displayed list.
  40.  
  41.  
  42.  
  43. Install and Run filel
  44. =====================
  45. There is no any kind of installation for FILEL. Just copy FILEL.EXE,
  46. PROFILE.FLL and FILEL.HLP to a directory you have with various tools.
  47. To run filel, simply type FILEL in the command line, or FILEL <pattern>
  48. where the pattern is used if you want display some specific files. For
  49. information about the pattern see below and also see the CD command (below).
  50.  
  51.  
  52.  
  53. Pattern
  54. =======
  55. Filel V2.0 has now smart pattern matching for the files. It uses the
  56. same wild characters as dor does and some more
  57.     *        for 'all'
  58.     ?        for one character  (see DOS)
  59.     + or &   for 'and'
  60.     ^ or !   for 'except'
  61.  
  62. ie.   *.com + *.exe         Display all .COM and all .EXE files
  63.       *.com + *.exe ^as*n.* Display all .COM and all .EXE files
  64.                             except all those that begin with "as" and
  65.                             end in "n"
  66.  
  67.  
  68.  
  69. Issuing Commands From the List
  70. ==============================
  71.  
  72. On its full screen display, you can issue commands for a file directly
  73. from the line on which a file is displayed.  You do this by moving the
  74. cursor to the line that describes the file, typing the command in
  75. the space provided to the left of the file name, and then pressing
  76. the ENTER key to execute the command.
  77.  
  78. When you press the ENTER key, all commands typed on one screen are
  79. executed, and the screen is restored to its previous state.
  80. However, the list is updated to reflect the current status of the
  81. files.
  82.  
  83. Symbols can be used to represent operands in the command to be
  84. executed.
  85.  
  86.  
  87.  
  88. The following symbols can be used:
  89. ==================================
  90.  
  91.     /    if the slash "/ " is followed with a space then it is
  92.          substituted to the complete fileid
  93.                  [drive]:[path\]filename.ext
  94.  
  95.  If "slashoption" is ON (see below) then after slash "/" you can
  96.  enter one or more of the following special symbols.
  97.  If "slashoption" is OFF, slash "/" if it is followed with a blank
  98.  character " " will be interpreted as the complete name
  99.  (drive:\directory\name.ext), otherwise it will not affect the
  100.  line entered. ie "COPY /b / + HAHA.TXT BINGO.TXT" will be translated
  101.  as "COPY /b NAME.EXT + HAHA.TXT BINGO.TXT"
  102.  
  103.     /n   means the file name displayed on the line. (substituted)
  104.  
  105.     /t   or
  106.     /e   means the file extension displayed on the line. ie ".COM"
  107.  
  108.     /d   means the directory path name for the file.
  109.          With an ending backslash.  ie "PASCAL\PROGS\"
  110.  
  111.     /any any other character "x" will cause the same character
  112.          to be displayed on the line. Usefull when you want
  113.          to pass an option to the command.
  114.          ie.  COPY //b / +assign.com outfile.*
  115.              is interpreted as
  116.               "COPY /b c:\dos\filname.ext +assign.com outfile.*"
  117.  
  118.     Any combinations of the above symbols can be used.  For example:
  119.  
  120.     /ne    means: file name followed by file extension.
  121.  
  122.     /dne   means: file path, name, and extension type,
  123.            and it is equivalent to "/ " alone.
  124.  
  125.     /en    means: file extension followed by file name.
  126.  
  127.     /nne   means file name followed by file name and file extension.
  128.  
  129.     /      a simple slash in front of a file will cause the file
  130.            to be executed. Usefull to run programs
  131.  
  132.  
  133. Special Symbols Used Alone:
  134. ===========================
  135.  
  136.     The following special symbols can be typed alone on the lines of
  137.     the FILELIST display.  They have the following meanings:
  138.  
  139.     =    means execute the previous command for this file.  Commands
  140.          are executed starting at the top of the screen.  For example,
  141.          suppose you enter the ERASE command on the top line.  You
  142.          can then type an equal sign on any other line(s).  Those
  143.          files preceded by equal signs are erased, by pressing the
  144.          RETURN key.
  145.  
  146.     ?    means display the last command executed.  The command is
  147.          displayed on the line in which the ? is entered.
  148.  
  149.  
  150.  
  151. Full Screen Editing:
  152. ====================
  153.  
  154. A sample of FILEList screen
  155.  
  156.  
  157.  Path = C:\DOS\*.*           *Header*                FILEL20 (c) BNV 1991
  158.  Cmd           Name      Ext      Size     Time        Date
  159.                ..          < DIR >       12:32:56   1-Jan-1990
  160.   *Cmd Area*   APPEND    EXE      5825   12:32:56   1-Jan-1990
  161.                ASSIGN    COM      1561   12:32:56   1-Jan-1990
  162.                ATTRIB                      :32:56   1-Jan-1990
  163.                BACKUP     * File area *    :32:56   1-Jan-1990
  164.                CGA                         :32:56   1-Jan-1990
  165.   _ *Cursor*   CHKDSK    COM      9850   12:32:56   1-Jan-1990
  166.                COMP      COM      4214   12:32:56   1-Jan-1990
  167.  
  168.  
  169.  
  170.   F1          F2 Refresh  F3 ....etc...     *Reserved lines*
  171.   F5 ...etc...
  172.   ====>   *CmdLine*
  173.   Overstrike      Line = 1  *Status* iles = 8    Total Size = 32467
  174.  
  175.  
  176.  
  177.  
  178. When FILEL is invoked, it searches for a  file PROFILE.FLL  in the current
  179. directory and in the directory from where the FILEL.EXE was found. Profile
  180. can have commands like those that are entered in the cmdline.
  181.  
  182.  
  183.  
  184. Commands that can be entered from cmdline are:
  185. ==============================================
  186.  
  187. * blabla         Anything that starts with * is ignored as a comment
  188. =                Executes the last command
  189. CMS  cmd         Executes a host command
  190. DCL  cmd              -//-
  191. DOS  cmd              -//-
  192. HOST cmd              -//-
  193. VMS  cmd              -//-
  194.  
  195. BOTTOM           Goes to the bottom of the file
  196. BOT                   -//-
  197. CD               Change directory, and searching pattern  (see below)
  198. COLOR            Changes screen colors (see below)
  199. DEF              Defines a key (see below)
  200. INT2E ON|OFF     (++For DOS only++) Interrupt 2E the back door of COMMAND.COM.
  201.                  If you specify "INT2E ON", filelist will execute very fast
  202.                  the commands! (Default value if OFF)
  203.                  *Warning! It is possible that FILEL wont work well with
  204.                  INT2E set on, since INT 2E is an undocument function of
  205.                  COMMAND.COM
  206. KEYBOARD101 ON|OFF   (++For DOS only++) if it set to ON then F11 and F12
  207.                  keys will be recognized. (Default is OFF)
  208. GLOBAL ON|OFF    If global is ON, FILEL will search for commands in the
  209.                  entire list of files. If global is OFF then searching
  210.                  will take place only in the currect screen (DEFAULT=OFF)
  211. QUIT             Quit from filel
  212. QUERY [key]      Query for key, (wildchars can be used ie: *F*)
  213. REFRESH          Updates the list with the new files in the directory
  214. RESERVED1 str    Displays the 'str' to the reserved line 1.
  215. RESERVED2 str          -//-
  216. REVERSE          Reverse (up side down) the list of files (can be used
  217.                  with sorting to reverse the order of files)
  218. SLASHOPTION ON|OFF  Slash option controls whether the characters after
  219.                  slash "/" that you've typed on a file, will be
  220.                  handled as special characters (see above).
  221.                  For example if you type on the file HAHA.BLA the command
  222.                         TYPE /N.*
  223.                  with slashoption ON it will be interpreted as "TYPE HAHA.*"
  224.                  with slashoption OFF it will be intrpreted as
  225.                  "TYPE /N.* HAHA.BLA"
  226.                  Default value is ON. Since that special characters are
  227.                  not used very often it is good idea to set it to OFF.
  228. SNAME            Sorts the files by the name.
  229. STYPE            Sorts the files by the file type
  230. SEXT                  -//-
  231. SSIZE            Sorts the files by the size
  232. SDATE            Sorts the files by the date/time
  233. STIME                 -//-
  234. TOP              Goes to the top of the list
  235. TRANSLATE ON|OFF If translate is ON,files will be displayed in lower case
  236.                  and directories in uppercase. (DEFAULT=OFF)
  237.                  (Has no effect in UNIX)
  238. :nnn             Goes to the line 'nnn'
  239. /[pattern]       Searches for the pattern from current line till end of list
  240. [+/-]nnn         Moves UP/DOWN nnn lines
  241. cmd              Anything that is not recognized as a command from the FILEL
  242.                  is passed to the host system.
  243.  
  244.  
  245.  
  246. Change Directory:
  247. ==================
  248.  
  249. (* For DOS users *)
  250.  
  251.    CD {{drive:}|newdir\}{pattern}
  252.  
  253.    CD command in cmdline changes the drive, directory and pattern.
  254.    To change the pattern just enter "CD newpattern"
  255.    ie. CD *.EXE    to display all the .EXE files in the current directory
  256.    To change the working directory enter "CD newdir\"
  257.    note that a backslash "\" must be at the end of the new directory
  258.    ie. CD ..\      or    CD   A:\   or   CD C:
  259.    Or you can combine the above two together
  260.    ie. CD \LANGUAGE\PROGS\FILELIST\*.?
  261.  
  262.  
  263. (* For VAX/VMS users *)
  264.  
  265.    CD  {logicalname or disk:}{[directory]}{pattern}{;version}
  266.  
  267.    CD for VAX/VMS follows the syntax of the SET DEFAULT command, except
  268.    that pattern can be added after the directory.
  269.    ie.
  270.            CD STA1:[CACZ.VLACHOUDIS.FILELIST]*.C
  271.    will display all versions of the C programs in the STA1 subdirectory
  272.            CD STA1:[CACZ.VLACHOUDIS.FILELIST]*.C;
  273.    only the latest version of each .C file.
  274.            CD [-]
  275.    will go up one directory
  276.            CD SYS$EXAMPLES:
  277.    will go to the direcotry specified by the logical name SYS$EXAMPLES
  278.  
  279.  
  280.  
  281. Colors
  282. ======
  283.  
  284.    COLOR  area color
  285.  
  286.      where 'area' can be one of the following:
  287.        ARROW          arrow '====>' in the cmdline
  288.        CMDLINE        cmdline color
  289.        CURSORMODE     Cursors mode Insert/Overwrite msg at status line
  290.        FILEAREA       The area with the list of files
  291.        HEADER         Header
  292.        RESERVED       The reserved lines
  293.        STATUS         The status line at the bottom of the screen
  294.        WORKING        The blinking working msg
  295.  
  296.  
  297.  (* For DOS users *)
  298.  
  299.      and 'color' can be one of the following:
  300.        BLACK          DARKGRAY
  301.        BLUE           LIGHTBLUE
  302.        GREEN          LIGHTGREEN
  303.        CYAN           LIGHTCYAN
  304.        RED            LIGHTRED
  305.        MAGENTA        LIGHTMAGENTA
  306.        BROWN          YELLOW
  307.        LIGHTGRAY      WHITE
  308.  
  309.     Note: The background color can not be changed
  310.  
  311.  
  312.   (* For VAX/VMS users *)
  313.  
  314.     since colors aren't exist on our VT420 terminals, the COLOR command in
  315.     filelist can only change the attributes of the specified field
  316.  
  317.           NORMAL                    UNDERLINE
  318.           BOLD                      BOLD_UNDERLINE
  319.           BLINK                     BLINK_UNDERLINE
  320.           BOLD_BLINK                BOLD_BLINK_UNDERLINE
  321.           REVERSE                   REVERSE_UNDERLINE
  322.           BOLD_REVERSE              BOLD_REVERSE_UNDERLINE
  323.           BLINK_REVERSE             BLINK_REVERSE_UNDERLINE
  324.           BOLD_BLINK_REVERSE        BOLD_BLINK_REVERSE_UNDERLINE
  325.  
  326.  
  327.  
  328. Key definitions:
  329. ================
  330.  
  331. DEF key command
  332.  
  333.     Valid keys are:
  334.     ===============
  335.        BKSP             HOME
  336.        ENTER            END
  337.        ESCAPE           PGUP
  338.        TAB              PGDN
  339.        F1 - F12         LEFT
  340.        INSERT           UP
  341.        DEL              RIGHT
  342.        S_TAB            DOWN
  343.  
  344.        `0123456789-=[];'./\
  345.  
  346.        Use the prefix
  347.           S_    for Shift
  348.           C_    for Control         (can take and all keys from A to Z
  349.           A_    for Alt key         (can take and all keys from A to Z
  350.  
  351.     Or even the code of the key 'nnn'. For extended codes add 256
  352.  
  353.     (* For VAX users *)
  354.     prefixes S_ and A_ are not recognized, and there are also the
  355.     keys
  356.        HELP, DO,  FIND,  INSERT,  REMOVE,  SELECT,  PREV, NEXT
  357.        F1  - F20
  358.        PF1 - PF4
  359.        E0  - E9  from the numeric keypad
  360.  
  361.  
  362.     Command can be:
  363.     ===============
  364.  
  365.         CURSORUP          Move cursor UP
  366.         CURSORDOWN        Move cursor DOWN
  367.         CURSORRIGHT       Move cursor RIGHT
  368.         CURSORLEFT        Move cursor LEFT
  369.         END               Moves cursor to the last char in line
  370.         HOME              Move cursor to the first column in line
  371.         TAB               Move cursor to next tab
  372.         BACKTAB           Move cursor to previous tab
  373.  
  374.         CURSORHOME        Move cursor to HOME and cmdline
  375.         CURSORFLIP        Flip from cmdline and last possition in file
  376.         CURSORTOGGLE      Insert/Overwrite
  377.  
  378.         BACKSPACE         Backspace on character
  379.         CLREOL            Clear from cursor position to end of line
  380.         DELETE            Delete one character
  381.         RESETLINE         Resets the line where cursor is on
  382.         RETRIEVE          Retrieve last executed commands
  383.  
  384.         BOTTOM            Go to the bottom of the list
  385.         TOP               Go to the top of the list
  386.         ONELINEUP         Scroll one line up
  387.         ONELINEDOWN       Scroll one line down
  388.         PAGEDOWN          Go one page down
  389.         PAGEUP            Go one page up
  390.  
  391.         QUIT              Leave the filelist
  392.         EXECUTE           Executes the commands that are entered in th
  393.         CMND       cmd    Executes a command as if it was entered from
  394.         EXEC     hostcmd  Executes a host command on the file the curs
  395.                           pointing  ie DEF S_F10 EXEC print / (UP
  396.         EXEC/FILEL  -//-  Same as above, except that if the specified
  397.                           is a directory, filelist invokes that direct
  398.                           like CD dirname\
  399.                           ie. DEF F10 EXEC/FILEL XEDIT
  400.  
  401.         REFRESH           Refresh the list
  402.         REVERSE           Reverse the list
  403.         SNAME             Sort by name
  404.         SNAMEEXT          Sort by name/extension (flips its function)
  405.         SEXT              Sort by extension
  406.         STYPE             -//-
  407.         SSIZE             Sort by size
  408.         SDATE             Sort by date
  409.         STIME             -//-
  410.  
  411.         NULL              Restores the function of the key
  412.  
  413.  
  414.  
  415. Any comments or ideas about the program,
  416. WILL BE REJECTED!!   :-)
  417.  
  418.  
  419.  
  420.  
  421. DISCLAIMER
  422.  
  423.  THE SOFTWARE  REFERENCED MAY BE  FREELY DISTRIBUTED  BY NON-COMMERCIAL
  424.  SYSTEMS AND NON-PROFIT ORGANIZATIONS, AS LONG AS THE DISTRIBUTION FILE
  425.  IS NOT ALTERED, AND NO MORE  THAN A REASONABLE COST-OF-DUPLICATION FEE
  426.  IS CHARGED.
  427.  
  428.  THE SOFTWARE  REFERENCED  IS MADE  AVAILABLE AS - IS. THE AUTHOR MAKES
  429.  NO WARRANTY ABOUT THE  SOFTWARE AND ITS CONFORMITY TO ANY APPLICATION.
  430.  THE AUTHOR IS NOT RESPONSIBLE FOR ANY DAMAGE, LOSS OF DATA, OF LOSS OF
  431.  MONEY CAUSED BY THIS PROGRAM.
  432.