home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / LF37-OS2.ZIP / LF.DOC next >
Text File  |  1988-05-17  |  12KB  |  343 lines
  1. LF - Directory lister for humans.
  2.         
  3.         by: Windspear Software Systems
  4.             P.O. Box 612108
  5.             San Jose, California  95161-2108
  6.  
  7. Copyright 1985, 1986, 1987, 1988 by Windspear Software Systems 
  8.  
  9. All commercial rights reserved. May be freely copied and used for 
  10. private use only -- not for resale. May be distributed on public access 
  11. remote computer bulletin boards.
  12.  
  13. REGISTRATION OF ALL USERS IS REQUIRED before use of this product.
  14. To become a registered user send the form listed below to Windspear
  15. Software Systems.  There are NO REGISTRATION FEES, this is just a
  16. method to track the number of users.
  17.  
  18. LF is supplied as a user supported package. Private individuals are 
  19. encouraged to copy and share this package with others. If you are using 
  20. this program and finding it of value, your contribution ($10 suggested) 
  21. will be appreciated. Regardless of whether you make a contribution, you 
  22. are encouraged to copy and share this program.
  23.  
  24. Please send any comments/problems to Windspear Software Systems. If you 
  25. want a response include a self addressed stamped envelope.  Your comments
  26. help to improve the product, so please send your comments.
  27.  
  28. Please make the user supported software concept work by sending in your 
  29. $10 contribution.
  30.  
  31.                                            Jordan Archer
  32.                                            Windspear Software Systems
  33.                                            P.O. Box 612108
  34.                                            San Jose, California  95161-2108
  35.  
  36.  
  37. This and other goodies can be found on:
  38.  
  39.     The Micro Foundry BBS  (408) 258-3484
  40.  
  41. a support board for LF and other products by Windspear.  Also products
  42. from Clockwork Software (i.e. BEGIN).
  43.  
  44.  
  45. - cut ------------------------- staple or tape closed ---------------------
  46.  
  47.     LF OS/2 Version 3.7 Registration Form          
  48.  
  49.     Name: ________________________________
  50.  
  51.     Address: ________________________________
  52.  
  53.     City: ____________________       State: ____    Zip: __________
  54.  
  55.  
  56.     Where product was obtained (if from a BBS please include the name
  57.  
  58.     and phone number): _________________________________________________
  59.  
  60.     _____________________________________________________________________
  61.  
  62.  
  63.     Comments: ___________________________________________________________
  64.  
  65.     _____________________________________________________________________
  66.  
  67.     _____________________________________________________________________
  68.  
  69.     _____________________________________________________________________
  70.  
  71.  
  72.  
  73.  
  74. - fold --------------------------------------------------------------------
  75.  
  76.                                                                  stamp
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.                           Windspear Software Systems
  90.                           P.O. Box 612108
  91.                           San Jose, CA     95161-2108
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103. - cut ---------------------------------------------------------------------
  104.  
  105. LF - Directory lister for humans.
  106.  
  107.  
  108.         LF is a multi-featured directory program for people who don't like
  109.     to see an endless mix of files and directories.  LF also has some very
  110.     handy batch file generation capabilities.
  111.  
  112.         This version of LF is also compatible with OS/2, for you techies
  113.     this means that LF is a bimodal, family API program.
  114.  
  115. Usage: LF [pattern] ["format"] {prefix[n]option}
  116.  
  117. Pattern:
  118.  
  119.     [!][drive:][path][file] { [!][file] }
  120.  
  121.     Drive: a - z.
  122.     Path: Any PC-DOS path ending in a '\'.
  123.     File: Normal file name with wild cards.
  124.  
  125.     The '!' means exclude all the files from the previous files list
  126.     that match the file wild card. This is done in a left to right 
  127.     manner. For example:
  128.  
  129.         lf !*.bat               Means list all files that are not .bat
  130.  
  131.         lf *.b* !*.?a? *.bat    Is processed as:
  132.                                     1 ) List all *.b* files.
  133.                                     2 ) From that list remove all *.?a? files.
  134.                                     3 ) From that list add all *.bat files.
  135.  
  136. Prefixes:
  137.  
  138.    '-' or '/' if not disabled.
  139.  
  140.  
  141. LF - Directory lister for humans.
  142.  
  143.  
  144. Format:  '' or ""
  145.  
  146.     LF can be used to generate batch files with a combination of the format
  147.     strings and redirection. When a format string is used all other options
  148.     are turned off allowing easy generation of batch files. For each file 
  149.     normally output by LF the format string is scanned and the substitution
  150.     commands are replaced with the proper values.  Valid substitution
  151.     commands are:
  152.  
  153.         *f - File name. Not including the extension and period.
  154.         *e - File extension. Not including the period.
  155.         ** - For a '*' character.
  156.         *n - New line. Same a carriage return.
  157.         *t - Tab character.
  158.         *' - The ' character.
  159.         *" - The " character.
  160.  
  161.     The command:
  162.  
  163.         lf *.c "del *f.obj*n"
  164.  
  165.     would cause the following output:
  166.  
  167.         del lf.obj
  168.         del lflib.obj
  169.         del lib.obj
  170.  
  171.     If the above LF command were redirected to a file, it could be used
  172.     as a batch file to delete the 'obj' files for all of the '.c' files.
  173.     ( i.e. 'lf *.c "del *f.obj*n" >x.bat' )
  174.  
  175.     Warning:
  176.         If you use a format string and want each file line on a separate
  177.         line you must include '*n' as part of your string.
  178.  
  179.  
  180. LF - Directory lister for humans.
  181.  
  182.  
  183. Options:
  184.  
  185.     a - File attribute pattern match. (off)
  186.         The '-a' option controls if the attributes are listed and the
  187.         pattern of attributes that the listed files must match.  The
  188.         optional attribute patterns are 'a' archive, 'r' read only,
  189.         'h' hidden and 's' system. Any pattern character can be prefixed
  190.         with a '!' for exclusion of that attribute. For examples:
  191.  
  192.             -ah     - Lists files with the hidden attribute.
  193.  
  194.             -a!a    - Lists files without the archive attribute.
  195.  
  196.             -ar!h!s - Lists files that are read only but not hidden or system.
  197.  
  198.             -a      - Sets no limits on the attributes so lists all files,
  199.                       including hidden and system.
  200.  
  201.             -aarhs  - Same as '-a'.
  202.  
  203.         Note: The 'a' attribute means the file's archive bit is
  204.               cleared (has been archived).
  205.  
  206.     c - Combine files and directories. (off)
  207.         When this is on 'LF' is similar to other file listers,
  208.         with directories and files mixed.
  209.  
  210.     d - List directories. (on)
  211.         By using the '-nd' option you will get only the files.
  212.  
  213.     e - Add 'exit' to end of file. (off)
  214.         This is specialized for piping directly to command.com which
  215.         requires 'exit' at the end of the piped file.
  216.  
  217.     f - List files. (on)
  218.         By using the '-nf' option you will get only the directories.
  219.  
  220.     h - Controls printing of headers.
  221.         1 - Banner header. (on)
  222.         2 - Volume label and path header. (on)
  223.         3 - File type labels. (on)
  224.         no options controls all three at once.
  225.  
  226.     l - List date/time stamps. (off)
  227.  
  228.     s - Sizes of files. (off)
  229.  
  230.     sc - Size of files and directory sizes in clusters. (off)
  231.         Optional cluster size. (i.e. '-sc512' gives size for clusters
  232.         of 512 bytes). This gives the disk space taken by each of
  233.         the sub directories.
  234.  
  235.     sw - Size Wasted.
  236.         Same format as 'sc' but size allocated but not used by the file.
  237.  
  238.     t - List total file space and free disk space. (on)
  239.  
  240.  
  241. LF - Directory lister for humans.
  242.  
  243.  
  244. Options (cont):
  245.  
  246.     p - Pause, printer formfeed, file '^Z' terminate. (on)
  247.         The effect of the '-p' option varies depending on where the
  248.         output of the LF command is directed.
  249.         When the output is directed to the screen (the normal case),
  250.         '-p' causes LF to pause every 25 lines.
  251.         When output is redirected to the printer, ( i.e. 'LF *.c >PRN' )
  252.         '-p' causes a formfeed at the end of the output.
  253.         When output is redirected to a file, the '-p' option 
  254.         causes LF to write an end-of-file marker '^Z', and '-np' (the default)
  255.         causes LF to fill the last file record with zeros.
  256.  
  257.     o,r - Order/Reverse for sorting files. ('-on')
  258.         r - Reverse order sort. Yes you can use '-rr' as '-o'.
  259.             s - Size sort.
  260.             n - Name sort. This is the default for '-o'
  261.             d,t,l - Date/time sort.
  262.             e,x - Extension sort.
  263.             u - Unsorted. Order is the same as the DIR command.
  264.                 Same as '-no' no order, '-nr' is a reverse unsorted.
  265.  
  266.         Note: Specifying a sort order turns on the item you are sorting
  267.             the file list on.
  268.  
  269.     z - Everything option. (off)
  270.         This controls the following options all at once:
  271.             a, l, s, t.        
  272.  
  273.     1,2,3,4,5,6,7,8 - Set maximum number of columns.  (8)
  274.  
  275.     '-', '/' - Set/Disable the option prefix character(s). (on)
  276.         This allows you to disable one or both of the options prefix
  277.         characters, which are '-' and '/'. (e.g., '-n-' disables the
  278.         '-' prefix so that a following '-no' is considered a file name
  279.         instead of an option.)
  280.  
  281.     '.' - Assume the '.' in the following file patterns. (off) 
  282.         When turned on any patterns will assume that there is an implied
  283.         '.' in the pattern.  When turned on a pattern of 'FILE' means 'FILE.'
  284.         where and when turned off means 'FILE.*' like the DIR command.
  285.  
  286.         Note: The option affect only patterns after it on the command line,
  287.             so it can be switch between pattern. ( ie "lf afiles -. bfiles" )
  288.             would expand as "lf afiles.* bfiles".
  289.  
  290.     All options can be prefixed with a 'n' to turn them off.
  291.  
  292. Environment variable:
  293.  
  294.     The environment variable 'LF' is searched for options
  295.     before the command line. By setting 'LF' you can set
  296.     your own default settings for all options.  For example typing
  297.  
  298.         SET LF= -NH -T
  299.  
  300.     at the DOS prompt will set the default value for the header to off
  301.     and the default for disk space totals to on. 
  302.  
  303.  
  304. LF - Directory lister for humans.
  305.  
  306.  
  307. Revision history:
  308.  
  309.     3.42 - Fix a the default for piping to disk files on the
  310.            '-p' option.  Should be '-np' for default because
  311.            MS-DOS likes it that way.
  312.  
  313.     3.43 - Fix bug added in 3.43 in sorting by file size.
  314.            Did not sort files greater than 32K correctly.
  315.  
  316.  
  317.     3.43t - Converted code to Turbo C and fixed a possible
  318.            bug in size in clusters with the changing of the
  319.            DTA for directories.
  320.  
  321.     3.5  - Add the '-.' option and set the default operation to be similar
  322.            to DIR (for Eric Wedel) .  Also fixed a possible bug in the main
  323.            DTA allocation crossing a 64K boundary.
  324.  
  325.     3.5a - Bug fixes, and speedup.  Fixed bug created when converting to 
  326.            Turbo C in the user specified cluster size, also add error message
  327.            about invalid cluster size.  Also made code smaller.
  328.  
  329.     3.6  - Added the '-e' option, fixed problems with '-c' and '-nf'
  330.            interaction, and made '-o' turn on what is selected to sort
  331.            on.  Also moved to California.
  332.  
  333.     3.7 - Added the '-sw' option.  Created version for OS/2.
  334.  
  335.                                                     Jordan Archer
  336.                                                     May 16, 1988
  337.  
  338.  
  339.                 Copyright 1985, 1986, 1987, 1988
  340.                 Windspear Software Systems
  341.                 P.O. Box 612108
  342.                 San Jose, CA   95161-2108
  343.