


















								       fLIST
						      The Power User's Shell
	  ------------------------------------------------------------------
								User's Guide













						       Copyright (c) 1985-89
							 All rights reserved



								CodeCrafters
							Post Office Box 1317
							     Londonderry, NH
								  03053-1317
								      U.S.A.






	   fLIST and PC-FLIST are trademarks of CodeCrafters.
	CompuServe is a registered trademark of CompuServe, Inc.
     DESQview and DESQview/386 are trademarks of Quarterdeck Office
				Systems.
     IBM, PC/AT and PS/2 are registered trademarks of International
		     Business Machines Corporation.
   MS-DOS, MS-Windows, MS-OS/2 and XENIX are registered trademarks of
			 Microsoft Corporation.
	  SCO is a trademark of The Santa Cruz Operation, Inc.
   Sprint: The Professional Word Processor is a registered trademark
		     of Borland International, Inc.
       Unix is a registered trademark of AT&T Bell Laboratories.
	     Wang is a trademark of Wang Laboratories, Inc.



			 Copyright (c) 1985-89.
			  All rights reserved.
			 Printed in the U.S.A.



      This manual was produced with Sprint: The Professional Word
			       Processor.












				    Contents



	       Introduction					      3

	       Chapter 1  Getting Started			      5
		  About fLIST  . . . . . . . . . . . . . . . . . . .  5
		  Installing fLIST . . . . . . . . . . . . . . . . .  6
		  Environment Setup  . . . . . . . . . . . . . . . .  8

	       Chapter 2  A Tutorial				     11
		  Loading fLIST  . . . . . . . . . . . . . . . . . . 11
		  Moving The Cursor  . . . . . . . . . . . . . . . . 12
		  Sorting the List . . . . . . . . . . . . . . . . . 13
		  Executing DOS Commands . . . . . . . . . . . . . . 14
		  Manipulating Filenames . . . . . . . . . . . . . . 14
		  Getting Help . . . . . . . . . . . . . . . . . . . 15
		  Expanding the List . . . . . . . . . . . . . . . . 17
		  Creating Another List  . . . . . . . . . . . . . . 17
		  Quiting a List . . . . . . . . . . . . . . . . . . 18

	       Chapter 3  Command Line Reference		     19
		  Running fLIST  . . . . . . . . . . . . . . . . . . 19
		  Selecting Files  . . . . . . . . . . . . . . . . . 20

	       Chapter 4  Command Reference			     23
		  Summary of Commands  . . . . . . . . . . . . . . . 23
		  /A (Add) . . . . . . . . . . . . . . . . . . . . . 24
		  /B (Bottom)  . . . . . . . . . . . . . . . . . . . 24
		  /C (Cancel)  . . . . . . . . . . . . . . . . . . . 25
		  /F (Find)  . . . . . . . . . . . . . . . . . . . . 25
		  /H (Help)  . . . . . . . . . . . . . . . . . . . . 26
		  /K (Keys)  . . . . . . . . . . . . . . . . . . . . 26
		  /L (List)  . . . . . . . . . . . . . . . . . . . . 27
		  /M (Marked)  . . . . . . . . . . . . . . . . . . . 28
		  /O (Omit)  . . . . . . . . . . . . . . . . . . . . 28
		  /Q (Quit)  . . . . . . . . . . . . . . . . . . . . 29
		  /R (Replace) . . . . . . . . . . . . . . . . . . . 29
		  /S (Sort)  . . . . . . . . . . . . . . . . . . . . 30
		  /T (Top) . . . . . . . . . . . . . . . . . . . . . 31
		  /U (Update)  . . . . . . . . . . . . . . . . . . . 31
		  /X (eXecute) . . . . . . . . . . . . . . . . . . . 32
		  / (Goto) . . . . . . . . . . . . . . . . . . . . . 32
		  ? (Recall) . . . . . . . . . . . . . . . . . . . . 33
		  = (Repeat) . . . . . . . . . . . . . . . . . . . . 33





					  i






	Chapter 5  Variable Reference			      35
	   Summary of Variables  . . . . . . . . . . . . . .  35
	   / (DRIVE:\PATH\NAME.EXT)  . . . . . . . . . . . .  35
	   /D (DRIVE:) . . . . . . . . . . . . . . . . . . .  36
	   /E (.EXT) . . . . . . . . . . . . . . . . . . . .  36
	   /N (NAME) . . . . . . . . . . . . . . . . . . . .  37
	   /P (\PATH\) . . . . . . . . . . . . . . . . . . .  37

	Appendix A  fLIST Messages			      39

	Appendix B  Default Key Assignments		      43

	Index						      47












































				   ii












				     Figures


	       Figure 2.1: The fLIST Display . . . . . . . . . . . . 12
	       Figure 2.2: The fLIST Help Window . . . . . . . . . . 16
	       Figure 2.3: The fLIST Keys Window . . . . . . . . . . 17













































					 iii































































				   iv












				     Tables


	       Table 1: Schedule of Fees . . . . . . . . . . . . . . .4















































					  v































































   2						   fLIST User's Guide












				     Introduction


	  fLIST is a  commercial  software product marketed through a unique
	  method of  distribution  known  as  Shareware.  This	distribution
	  method allows you an	opportunity  to  evaluate  the product for a
	  period of  30  days  prior  to  making  an investment. Use of this
	  product beyond the evaluation period without	obtaining  a license
	  is prohibited and constitutes theft.

	  The programs and documentation contained in the Evaluation Package
	  are complete and unabridged. The  Licensed  User  Package includes
	  the latest  version  of  the	programs  and  printed documentation
	  contained in the Evaluation  Package	as  well as additional files
	  and printed documentation  which enable the complete customization
	  of fLIST.

	  You  may  distribute	copies	of  the Evaluation Package  for  the
	  purpose  of evaluation only, provided it  is	distributed  in  its
	  original, unmodified form and  without  charge,  beyond reasonable
	  media, shipping and/or handling fees.

	  fLIST may be licensed for  both private, noncommercial use as well
	  as by companies  and/or  institutions.  To  license  fLIST, simply
	  complete the fLIST License Agreement provided with  the Evaluation
	  Package and mail it, along with a check  or  money  order  for the
	  appropriate fee(s), as shown in Table 1, to:

				     CodeCrafters
				 Post Office Box 1317
			     Londonderry, NH  03053-1317
					U.S.A.

	  Product support and  information  is	provided  to  licensed users
	  only. Support or information is available through:

	      *  CompuServe   Information   Service   electronic   mail   at
		 73647,1011.

	      *  U.S. Mail at the address listed above.

	  Please include a complete problem description as well as a daytime
	  telephone number.








	  Introduction							   3






		       Table 1: Schedule of Fees


   MS-DOS Licenses
				  1
   Individual (noncommercial) User  (1 CPU) .............. $  35 (US)
				  1
   Individual User Version Upgrade  ...................... $  20 (US)
		     2
   Institutional User  (1-10 CPUs) ....................... $  75 (US)
		     3
   Institutional User  (11-50 CPUs) ...................... $ 150 (US)
		     4
   Institutional User  (Over 50 CPUs) .................... $ 300 (US)
				     5
   Institutional User Version Upgrade  .................... No Charge



   MS-DOS Supplies
			      6
   fLIST Distribution Diskette	.......................... $   5 (US)
				   6
   fLIST Diskette Labels (50 count)  ..................... $   5 (US)
		     6
   fLIST User's Guide  ................................... $  10 (US)
			    6
   fLIST Customization Guide  ............................ $  10 (US)









   __________________________________________________________________

   1. Includes 1 fLIST Distribution Diskette,  1  fLIST  User's Guide
      and 1 fLIST Customization Guide.

   2. Includes 1 fLIST Distribution Diskette and 9 additional labels,
      1 fLIST User's Guide and 1 fLIST Customization Guide.

   3. Includes 2  fLIST  Distribution  Diskettes  and  48  additional
      labels, 2 fLIST User's Guides and 2 fLIST Customization Guides.

   4. Includes 3  fLIST  Distribution  Diskettes  and  97  additional
      labels, 3 fLIST User's Guides and 3 fLIST Customization Guides.

   5. Includes 1 fLIST Distribution Diskette and additional labels.

   6. Available to licensed users only



   4						   fLIST User's Guide












				      Chapter 1

				   Getting Started


	  Thank you for taking the time  to  evaluate fLIST. We are sure you
	  will find it to be a valuable and time saving product. Please take
	  the time to read this User's Guide to obtain a  good understanding
	  of how you may put fLIST to  work  for  you.	We  hope  that after
	  evaluating  fLIST  you  will become one of its many licensed users
	  and staunch advocates.



	  About fLIST


	  fLIST is a powerful shell  program which can greatly increase your
	  productivity	when used to its full  potential.  It  can  simplify
	  complex tasks such as  program  development  while  making tedious
	  tasks such as file management seem enjoyable. fLIST enables you to
	  create lists of files  and/or  directories  which can be scrolled,
	  sorted and/or processed with DOS commands or batch files.

	  fLIST provides a wide variety  of features to enhance your current
	  environment, for instance:

	      *  A DOS command line for every file within the list

	      *  Built-in  filename  manipulation  to reduce filename typing
		 errors

	      *  Different groups of files may	be  combined  into  a single
		 list

	      *  An unlimited number of separate and distinct file lists

	      *  Enhanced pattern matching enabling precise file selection

	      *  File marking to simplify processing of related files

	      *  Extensive customization options to suit your preferences

	      *  International	date  and  time  support   and	multilingual
		 messages






	  Chapter 1,  Getting Started					   5






   fLIST was inspired  by  a  utility  of  the same name from the IBM
   VM/CMS mainframe environment which provided some of these features
   to grateful users with many tasks to accomplish.

   fLIST was  developed in the MS-DOS environment where attention was
   focused on creating	an  interface which closely resembled that of
   the original IBM utility and  worked well in MS-DOS, MS-OS/2, UNIX
   and XENIX environments. fLIST is currently  available  for MS-DOS,
   UNIX and XENIX systems  which  meet	or  exceed the minimum system
   configurations outlined below.

   Minimum MS-DOS configuration is:

       *  MS-DOS (or PC-DOS) Version 2.10 or later

       *  Any of the following video systems:

	      -  IBM MDA/CGA/EGA/MCGA/VGA memory mapped video

	      -  IBM PC/AT/PS BIOS compatible video via INT 10H

	      -  ANSI 3.64-1979 compatible video via MS-DOS stdout

       *  Any of the following keyboard systems:

	      -  IBM PC/AT/PS BIOS compatible keyboard via INT 16H

	      -  IBM PC/AT/PS compatible keyboard via MS-DOS stdin

	      -  Wang PC/APC compatible keyboard via MS-DOS stdin

       *  128K of available memory

   Minimum UNIX/XENIX configuration is:

       *  UNIX System V Release  2  (SCO XENIX System V Release 2) or
	  later

       *  TERMINFO Curses terminal I/O package

       *  TERMINFO terminal attributes database

   For	information  about  licensing  fLIST  for  use	on UNIX/XENIX
   systems, please contact us at the address shown on page 3.



   Installing fLIST


   The fLIST Evaluation Package  includes  this  User's Guide and the
   Evaluation Diskette, which contains the following files:

   FLIST.EXE	   Main fLIST program



   6						   fLIST User's Guide






	  FLIST.HLP	  Help file displayed with /H command

	  FLIST.PRO	  Sample customization Profile

	  GUIDE 	  ASCII version of this User's Guide

	  LICENSE	  fLIST License Agreement

	  README	  Latest information about fLIST

	  The fLIST  Licensed  User  Package,  provided  to  licensed users,
	  includes the Customization Guide  and  the  Distribution Diskette,
	  which  contains  the	latest versions of  all  the  files  on  the
	  Evaluation Diskette as well as the following files:

	  FLHELP.EXE	  fLIST Help File Generator

	  HELPTEXT	  Help file source text

	  The version of the fLIST  program contained on the Evaluation Disk
	  is  complete and fully-functional, only information and  utilities
	  used in  customizing fLIST have been withheld. By withholding this
	  information,	those  who  would continue to use  fLIST  after  the
	  evaluation period without obtaining a license,  which  is illegal,
	  cannot access its true power.  We apologize for these methods, but
	  it has been our experience  in several years of Shareware software
	  marketing that fewer	than  10%  of  those  who use a product on a
	  regular basis ever obtain a license.

	  To install fLIST, simply follow the procedure outlined below:

	     1.  Type CD C:\ and press Enter to go to the root directory.

	     2.  Type MD FLIST and  press  Enter  to  create a new directory
		 called FLIST.

	     3.  Move into the new directory by typing CD FLIST and pressing
		 Enter.

	     4.  Insert in Drive A either:

		    a.	the Distribution Disk, if you are a licensed user of
			fLIST.

		    b.	the Evaluation Disk, if you are evaluating fLIST.

	     5.  Type COPY A:*.* Enter.

	     6.  Review the latest information about  fLIST  by  typing TYPE
		 README | MORE and pressing Enter.







	  Chapter 1,  Getting Started					   7






   Environment Setup


   fLIST utilizes the following environment variables to locate files
   and indicate which features can be used on your system:

   PATH 	   This variable is used  by  DOS  to  identify which
		   directories are to be  searched  when  looking for
		   commands  to run. You should include the  C:\FLIST
		   directory in your PATH.  Define  this  variable by
		   typing PATH C:\FLIST  followed by the remainder of
		   your current PATH, if any, and pressing Enter. You
		   should also add  this command to your AUTOEXEC.BAT
		   file  to  define  PATH  each  time  you  boot your
		   system.

   FLIST	   This variable is used to identify the directory in
		   which fLIST resides. Although this variable is not
		   required, as fLIST will search the PATH  to locate
		   its files, using  this variable can eliminate this
		   time   consuming   search   process.  Define  this
		   variable by typing SET FLIST=C:\FLIST and pressing
		   Enter. You should also add  this  command  to your
		   AUTOEXEC.BAT file to define	FLIST  each  time you
		   boot your system.

   TERM 	   This variable is used to identify the video system
		   used on your system. If you are not	using  a 100%
		   IBM	 compatible   this  variable   is   required,
		   otherwise  it may be used to  select  any  of  the
		   enhanced   video   modes    available    on	 true
		   compatibles.  You may select any of the  following
		   values for this variable:

		   ibm-pc      100% IBM compatible with an  MDA, CGA,
			       EGA, MCGA or VGA  video	system	to be
			       used  in 25-line text mode. This  mode
			       is the default if this variable is not
			       defined.

		   ega-pc      100% IBM compatible with an  EGA video
			       system  to be  used  in	43-line  text
			       mode.

		   vga-pc      100%  IBM compatible with a VGA	video
			       system  to be  used  in	50-line  text
			       mode.

		   bios-pc     MS-DOS system with IBM compatible BIOS
			       video and keyboard interfaces.

		   ansi-pc     MS-DOS  system  with  monochrome  ANSI
			       3.64-1979 compatible video  system via




   8						   fLIST User's Guide






				      stdout.  Standard  IBM  keyboard codes
				      must be available via stdin.

			  c_ansi-pc   MS-DOS   system	with	color	ANSI
				      3.64-1979 compatible video  system via
				      stdout.  Standard  IBM  keyboard codes
				      must be available via stdin.

			  wang-pc     Wang  PC/APC  system  with  monochrome
				      ANSI 3.64-1979 compatible video system
				      via stdout. Wang PC/APC keyboard codes
				      must be available via stdin.

			  Define this variable	by typing SET TERM= followed
			  by your  selection,  in  lower-case,	and pressing
			  Enter. You should also add  this  command  to your
			  AUTOEXEC.BAT	file  to  define  TERM each time you
			  boot your system.

			  When using operating environments such as DESQview
			  or Microsoft	Windows,  you  should  select either
			  bios-pc, ansi-pc or c_ansi-pc  to  allow  fLIST to
			  run  inside	a   window.   If   you	 are   using
			  DESQview/386, any of the IBM compatible selections
			  may be used as the video memory can be virtualized
			  using the  memory  remapping	capabilities  of the
			  80386 processor.






























	  Chapter 1,  Getting Started					   9































































   10						   fLIST User's Guide












				      Chapter 2

				      A Tutorial


	  This tutorial is designed to quickly	illustrate  the fundamentals
	  of fLIST which will be expanded upon throughout  the	remainder of
	  this guide. While you study this chapter, please bear in mind that
	  fLIST may be fully  tailored	to  your preferences. The keystrokes
	  described here represent the default configuration of  the product
	  as distributed. Also remember that when a keystroke such as Ctrl-X
	  is described, Ctrl should be held down while X is pressed.



	  Loading fLIST


	  Let's begin by creating a list of files in the  C:\FLIST directory
	  by following this procedure:

	     1.  Move  into  the  FLIST directory by typing  CD  \FLIST  and
		 pressing Enter.

	     2.  Load fLIST by typing FLIST and pressing Enter.

	  Your screen should now look similar to the display shown in Figure
	  2.1.























	  Chapter 2,  A Tutorial					  11






   +----------------------------------------------------------------+
   | fLIST Version 3.00 - Copyright/ /rafters. All rights reserved. |
   | 1 List =======================\ \============================= |
   | C1 C:\FLIST\*		   / /	(Group Area)	     8/142K |
   | ==============================\ \============================= |
   | C1 .	    |_		   / /	    |<DIR>   12-29-88 14:11 |
   | C1 ..	    |		   \ \	    |<DIR>   12-29-88 14:11 |
   | C1 FLIST.EXE   |		   / /	    |  58282  5-15-89  3:00 |
   | C1 FLIST.HLP   |		   \ \	    |	9313  5-15-89  3:00 |
   | C1 FLIST.PRO   |		   / /	    |	 187  5-15-89  3:00 |
   | C1 GUIDE	    |		   \ \	    |  73978  5-15-89  3:00 |
   | C1 LICENSE     |		   / /	    |	2631  5-15-89  3:00 |
   | C1 README	    |		   \ \	    |	 658  5-15-89  3:00 |
   |		    |		   / /	    |			    |
   |		    |		   \ \	    |			    |
   |   (Name Area)  |	    (Input / /Area) |	  (Info Area)	    |
   |		    |		   \ \	    |			    |
   |		    |		   / /	    |			    |
   |		    |		   \ \	    |			    |
   | ==============================/ /============================= |
   |	     Press <Ctrl-F> for Hel\ \ss <Ctrl-K> for Keys	    |
   +----------------------------------------------------------------+

		     Figure 2.1: The fLIST Display

   The fLIST display is divided  into several areas which contain the
   following information:

   Group Area	   This   area	shows  which  groups  of  files   are
		   contained in the list.  Each  line  identifies the
		   selection pattern used to  create  the  group, the
		   number of files selected and thier total size.

   Name Area	   This area identifies each file in the list as well
		   as its relationship to a  group  within  the Group
		   Area.

   Input Area	   This  area  contains  individual DOS command lines
		   for each file in the list.

   Info Area	   This  area  relates	statistical information about
		   individual files in the list.



   Moving The Cursor


   Movement within the list is accomplished using the standard keypad
   cursor and page keys as follows:

   Up		   Move the cursor up one line, scrolling the list as
		   required.




   12						   fLIST User's Guide






	  Down		  Move the cursor down one line, scrolling  the list
			  as required.

	  Left		  Move the cursor left one column, if possible.

	  Right 	  Move the cursor right one column, if possible.

	  Enter 	  Move the cursor to  column  one  of the next line,
			  scrolling the list as required.

	  Tab		  Move the cursor to the  start of the next word, if
			  possible.

	  Shift-Tab	  Move the cursor to the start of the previous word,
			  if possible.

	  Ins		  Switch between Insert and Overwrite modes.

	  Del		  Delete the character above the cursor.

	  Backspace	  Delete the character to the left of the cursor.

	  Home		  Move the cursor to column one.

	  End		  Move the cursor past	the  last  character  on the
			  line.

	  PgUp		  Scroll the list up one page, if possible.

	  PgDn		  Scroll the list down one page, if possible.

	  Ctrl-Left	  Delete the characters to the left of the cursor.

	  Ctrl-Right	  Delete the characters to the right of the cursor.

	  Ctrl-Home	  Move the cursor to the top line on the screen.

	  Ctrl-End	  Move the cursor to the bottom line on the screen.

	  Ctrl-PgUp	  Scroll to the first page of the list.

	  Ctrl-PgDn	  Scroll to the last page of the list.



	  Sorting the List


	  fLIST provides several methods of sorting the list, such as:

	      *  Date/Time in descending sequence by pressing Ctrl-D

	      *  Extension and Name in ascending sequence by pressing Ctrl-E




	  Chapter 2,  A Tutorial					  13






       *  Group, Name and Extension in ascending sequence by pressing
	  Ctrl-G

       *  Name and Extension in ascending sequence by pressing Ctrl-N

       *  Size in descending sequence by pressing Ctrl-S



   Executing DOS Commands


   To illustrate just  how  easy  it  is to execute DOS commands from
   fLIST, let's display the README file again following these steps:

      1.  Move the cursor to the  README command line by pressing the
	  Down or Up as many times as required.

      2.  View README by typing TYPE and pressing Ctrl-X.

      3.  After viewing  the file, press any key when the Holding ...
	  message appears in  the  lower right corner of your screen.
	  This	message  tells	you that fLIST is  holding  its  next
	  display to allow you time to read what is currently  on the
	  screen.

   Multiple commands can be executed  by  pressing  Ctrl-X  with more
   than one command line entered.  In fact, every command line within
   the	list  could  contain a command. Multiple commands can also be
   executed using a  single  file by delimiting them with semicolons.
   For example, TYPE;ERASE would  display  a  file  and then erase it
   when Ctrl-X was pressed.

   fLIST uses a special command character, / (ASCII  47)  by default,
   to identify commands and variable references. If you  need  to use
   this character literally  in  a DOS command, specify the character
   twice. For example, DIR /P would become DIR \FLIST\ after variable
   substitution, described  in	the  next  section,  whereas  DIR //P
   achieves the desired result DIR /P.

   After each command line is executed, it is changed to a comment by
   inserting the fLIST comment character, * (ASCII 42) by default, at
   the beginning of the line. Should you wish to execute  the command
   again, simply delete  the  comment character and press Ctrl-X. You
   may also use the comment character to prevent fLIST from executing
   command lines you do not want executed at this time.



   Manipulating Filenames


   fLIST helps you eliminate typing  errors by providing a variety of
   filename  manipulation  variables.  Normally,  fLIST  appends  the



   14						   fLIST User's Guide






	  filename to the end of your command before it is executed. This is
	  why TYPE on  the  README command line becomes TYPE C:\FLIST\README
	  when	executed  by  DOS. You can, however, control the handling of
	  filenames  to  meet	your  requirements.  Suppose  the  following
	  commands were entered on the same README command line:

	  ERASE 	  Becomes  ERASE  C:\FLIST\README, the	filename  is
			  appended to the command by default.

	  COPY / A:	  Becomes COPY C:\FLIST\README A:, the / is replaced
			  by the complete filename.

	  DIR /D	  Becomes DIR C:, the  /D  is  replaced by the drive
			  portion of the filename.

	  DIR /P*.EXE	  Becomes DIR \FLIST\*.EXE, the  /P  is  replaced by
			  the path portion of the filename.

	  TYPE /N	  Becomes TYPE README, the  /N	is  replaced  by the
			  name portion of the filename.

	  DIR /E	  Becomes DIR, the /E is replaced  by  the extension
			  portion of the filename (null in this case).

	  /O COMMAND	  Becomes COMMAND, the /O prevents the filename from
			  being appended to the command.



	  Getting Help


	  Now let's take a look at fLISTs Help file by pressing Ctrl-F. This
	  pop-up  window,  shown  in Figure 2.2, may be scrolled by pressing
	  the keys shown along the bottom window border. When you  have seen
	  enough, press Esc to exit the Help file.





















	  Chapter 2,  A Tutorial					  15






   +----------------------------------------------------------------+
   | fLIST Version 3.00 - Copyright/ /rafters. All rights reserved. |
   | 1 List =======================\ \============================= |
   | C1 +========================= / /=========================+42K |
   | ===|			   \ \			       |=== |
   | C1 | 1. The On-line Help Windo/ /			       |:11 |
   | C1 | =========================\ \			       |:11 |
   | C1 | fLIST presently supports / /navigation keys;	       |:00 |
   | C1 |			   \ \			       |:00 |
   | C1 |     "D" or Down Arrow   -/ /ine                      |:00 |
   | C1 |     "U" or Up Arrow     -\ \line                     |:00 |
   | C1 |     "Ctrl-D" or PgDn    -/ /age                      |:00 |
   | C1 |     "Ctrl-U" or PgUp    -\ \page                     |:00 |
   |	|     "Esc"               -/ /indow                    |    |
   |	|			   \ \			       |    |
   |	|			   / /			       |    |
   |	| 2. Basic Fundamentals    \ \			       |    |
   |	| =====================    / /			      _|    |
   |	+====  <D>=Down  <Ctrl-D>=P\ \=PgUp  <Esc>=Exit  ======+    |
   | ==============================/ /============================= |
   |	     Press <Ctrl-F> for Hel\ \ss <Ctrl-K> for Keys	    |
   +----------------------------------------------------------------+

		   Figure 2.2: The fLIST Help Window

   One	of the best features of fLIST is its ability to adapt to your
   personal preferences. For instance, you can	redefine  the meaning
   of  all  keyboard  keys which fLIST recognizes. To see the current
   key definitions, press Ctrl-K. This pop-up window, shown in Figure
   2.3,  scrolls exactly like the  Help  window and is also exited by
   pressing Esc.


























   16						   fLIST User's Guide






	  +----------------------------------------------------------------+
	  | fLIST Version 3.00 - Copyright/ /rafters. All rights reserved. |
	  | 1 List =======================\ \============================= |
	  | C1 +=======================  f/ / ========================+42K |
	  | ===| Ctrl-A 	 Add to Li\ \			      |=== |
	  | C1 | Ctrl-B 	 Last Page/ /			      |:11 |
	  | C1 | Ctrl-C 	 Return to\ \			      |:11 |
	  | C1 | Ctrl-D 	 Sort by D/ /			      |:00 |
	  | C1 | Ctrl-E 	 Sort by E\ \			      |:00 |
	  | C1 | Ctrl-F 	 View Help/ /			      |:00 |
	  | C1 | Ctrl-G 	 Sort by G\ \			      |:00 |
	  | C1 | Backspace	 Delete Pr/ /			      |:00 |
	  | C1 | Tab		 Tab Next \ \			      |:00 |
	  |    | Ctrl-K 	 View Key / /			      |    |
	  |    | Ctrl-L 	 Next List\ \			      |    |
	  |    | Enter		 Next Line/ /			      |    |
	  |    | Ctrl-N 	 Sort by N\ \			      |    |
	  |    | Ctrl-O 	 Unmark Fi/ /			     _|    |
	  |    +====  <D>=Down	<Ctrl-D>=P\ \=PgUp  <Esc>=Exit	======+    |
	  | ==============================/ /============================= |
	  |	    Press <Ctrl-F> for Hel\ \ss <Ctrl-K> for Keys	   |
	  +----------------------------------------------------------------+

			  Figure 2.3: The fLIST Keys Window



	  Expanding the List


	  Suppose you wish to include files from the root directory  in this
	  list. You would:

	     1.  Move  the  cursor  to	the  beginning of a command line  by
		 pressing Home.

	     2.  Erase any remaining  characters  on  the  line  by pressing
		 Ctrl-Right.

	     3.  Add  the  root  directory files by typing /A \ and pressing
		 Ctrl-X.



	  Creating Another List


	  And now, you wish to	create	a  seperate  list  of  files  from a
	  directory within the root directory. To accomplished this:

	     1.  Move the cursor to  a	command  line  for a directory other
		 than . or .. by pressing Enter as often as required. Notice
		 that fLIST will scroll the list as you attempt to  move the
		 cursor past the last file on the screen.



	  Chapter 2,  A Tutorial					  17






      2.  Erase any remaining  characters  on  the  line  by pressing
	  Ctrl-Right.

      3.  Create a new	list  for  the	directory  by  typing  /L and
	  pressing Ctrl-X.

      4.  Switch back to the first list by pressing Ctrl-L.

      5.  Switch back to the new list by pressing  Ctrl-L  again. The
	  lists are arranged in a circular ring which can be traveled
	  in either direction.



   Quiting a List


   You can terminate a list by pressing Esc. If you wish to terminate
   all lists and exit to DOS,  you  could  press Esc as many times as
   required to terminate each list,  or simply press Ctrl-C to cancel
   all	lists  immediately.  In either case, when all lists have been
   terminated, fLIST will exit to DOS.



































   18						   fLIST User's Guide












				      Chapter 3

				Command Line Reference


	  This chapter describes how to execute fLIST from  the  DOS command
	  line.  The  various  command line options are discussed as well as
	  how  to  select  files  using  fLISTs  advanced  pattern  matching
	  features.



	  Running fLIST


	  fLIST is executed from the DOS command line in the same  manner as
	  other commands. The easiest way to start fLIST is:

	       FLIST  Enter

	  This will create  a  list  consisting  of all files in the current
	  directory,  as was the case in the  tutorial.  You  may,  however,
	  specify up to nine (9) patterns on the command line to  select the
	  files for the list. For example, the command:

	       FLIST  A:  *.H  \*.{COM,EXE,BAT}  Enter

	  This will create  a  list  consisting  of all files in the current
	  directory  from  drive  A,  all  C  header  files in	the  current
	  directory and all executable files  in the root directory. You may
	  be puzzled by the  last  selection  pattern  in the example above,
	  this	illustrates  one  of the many types  of  selection  patterns
	  supported  by  fLIST.  The  specifics  of  selection	patterns are
	  described in the next section.

	  Several options may also be  included on the command line enabling
	  you to choose alternate Error, Help and/or Profile  files  as well
	  as temporarily change the TERM environment  variable.  Options may
	  appear anywhere within the command  line. The options which may be
	  included on the command line are as follows:

	  /Efile	  Use an alternate fLIST Error file

	  /Hfile	  Use an alternate fLIST Help file

	  /Pfile	  Use an alternate fLIST Profile

	  /TA		  Use TERM=ansi-pc temporarily



	  Chapter 3,  Command Line Reference				  19






   /TB		   Use TERM=bios-pc temporarily

   /TC		   Use TERM=c_ansi-pc temporarily

   /TE		   Use TERM=ega-pc temporarily

   /TI		   Use TERM=ibm-pc temporarily

   /TV		   Use TERM=vga-pc temporarily

   /TW		   Use TERM=wang-pc temporarily

   For example, if you have included the command  SET  TERM=ibm-pc in
   your AUTOEXEC.BAT, but  you	would like to occaisionally run fLIST
   in 50-line mode using your VGA video system, specify the following
   command line option:

	FLIST  /TV  Enter



   Selecting Files


   fLIST allows you to select files using a  pattern  matching scheme
   inspired by the UNIX  shell	programs  (Bourne, C-Shell and Korn).
   Patterns  offer  greater  control  over  file  selection  than DOS
   wildcard characters. Any  of  the following constructs may be used
   in fLIST selection patterns:

   *		   Matches zero or more occurances of any character.

   ?		   Matches one occurance of any character.

   [AB-F]	   Matches one occurance  of any character within the
		   brackets.   Consectutive    characters    may   be
		   represented	as the lowest and highest  characters
		   of the range seperated by a hyphen.

   [!AB-F]	   Matches one occurance  of any character not within
		   the	brackets.  Consectutive  characters  may   be
		   represented	as the lowest and highest  characters
		   of the range seperated by a hyphen.

   {A,BC,DEF}	   Matches  one  occurance  of	any string within the
		   braces.

   These constructs may be combined  as  required  to  form selection
   patterns which are quite specific. For example:

	*[F][!L]*.{COM,EXE,BAT}






   20						   fLIST User's Guide






	  This will select all which contain an F in the  filename, provided
	  the F is not immediately followed by an L, and have  extensions of
	  either COM, EXE or BAT.

	  It  is important to point out the  one  difference  between  fLIST
	  pattern  matching  and  DOS wildcards. When DOS  expands  the  *.*
	  wildcard, files both with  and  without  extensions  are selected.
	  When fLIST expands the same  *.*  pattern,  files  with extensions
	  only are  selected. Because fLIST treats characters of the pattern
	  literally, a dot (.) must appear within the filename in  order for
	  it to be  selected.  To  achieve  the  same results as the DOS *.*
	  wildcard, specify the pattern  *.  This  inconsistency  is trivial
	  when compared  to  the  additional  flexibility  offered  by fLIST
	  pattern matching.











































	  Chapter 3,  Command Line Reference				  21































































   22						   fLIST User's Guide












				      Chapter 4

				  Command Reference


	  fLIST supports  a  variety  of  commands  which  may be typed on a
	  command line then executed via Ctrl-X or assigned to keystrokes as
	  described  in  the  Customization   Guide.   fLIST   commands  are
	  identified by the  fLIST  command character appearing as the first
	  character of the command text.



	  Summary of Commands


	  /A		  Add a group of files to the current list

	  /B		  Display the last page of the current list

	  /C		  Discard all lists and return to DOS

	  /F		  Locate a file within the current list

	  /H		  View the fLIST Help file in a pop-up window

	  /K		  View the fLIST Key Definitions in a pop-up window

	  /L		  Create a new list  or  select  a different list to
			  view

	  /M		  Execute a  DOS command for all marked files in the
			  current list

	  /O		  Omit the file specification from a DOS command

	  /Q		  Discard the current list

	  /R		  Replace the current list with a new list

	  /S		  Sort the current list

	  /T		  Display the first page of the current list

	  /U		  Update the current list from disk

	  /X		  Execute all command lines in the current list




	  Chapter 4,  Command Reference 				  23






   /		   Display a different portion of the current list

   ?		   Recall the last DOS command executed

   =		   Repeat the last DOS command executed



   /A (Add)


   Function	   Adds files to the current list.

   Syntax	   /A  [ pattern ]

   How To	   To  add  all files contained  within  a  directory
		   currently in the list, type /A on the command line
		   associated  with that directory and press  Ctrl-X.
		   fLIST will append the filename of the directory to
		   the command when it is executed.

		   To add files not  currently	in  the list, type /A
		   followed  by  a  selection  pattern on any command
		   line and press Ctrl-X.

   Examples	   /A  \
		   Add all files in the root directory.

		   /A  \SRC\*.C
		   Add all C files in the \SRC directory.

   Keystrokes	   Ctrl-A performs a /A command.

   Remarks	   Each time this command is executed, a new group of
		   files is included in  the  current  list.  A given
		   file may appear more than once in the  list	if it
		   exists in more  than  one group. A maximum of nine
		   (9) groups can be included in a single list.



   /B (Bottom)


   Function	   Displays the last full page of the current list.

   Syntax	   /B

   How To	   To display the last page of the current list, type
		   /B on any command line and press Ctrl-X.

   Examples	   /B
		   Display the last page of the current list.




   24						   fLIST User's Guide






	  Keystrokes	  Ctrl-B  and  Ctrl-PgDn  perform  a  LAST  keyboard
			  function.

	  Remarks	  This	command  is  provided for compatibility with
			  the original IBM  utility. The preferred method of
			  displaying  the  last  page  of  the	list  is  by
			  pressing  Ctrl-PgDn, which is defined as the	LAST
			  keyboard function.



	  /C (Cancel)


	  Function	  Discards all lists and exits to DOS.

	  Syntax	  /C

	  How To	  To discard all lists and exit to DOS,  type  /C on
			  any command line and press Ctrl-X.

	  Examples	  /C
			  Discard all lists and exit to DOS.

	  Keystrokes	  Ctrl-C performs a /C command.

	  Remarks	  This	 command  performs  the  same  function   as
			  executing /Q for each list in the list ring.



	  /F (Find)


	  Function	  Finds a file in the current list.

	  Syntax	  /F  [ pattern ]

			  /F+  [ pattern ]

			  /F-  [ pattern ]

	  How To	  To locate the next file with the same extension as
			  the current file, type /F  */E (or /F+    */E)  on
			  the command line  associated with the current file
			  press  Ctrl-X. fLIST	will  append  the  extension
			  portion  of  the  current  filename to the command
			  when it is executed.

			  To  continue the search throughout the list,	type
			  /F (or /F+) on any command line and press Ctrl-X.

			  To search the list backward, substitute /F- for /F
			  (or /F+) as described above.



	  Chapter 4,  Command Reference 				  25






   Examples	   /F  *.C
		   Locate the next C source file in the list.

		   /F-	*.H
		   Locate the next  C  header file towards the top of
		   the list.

		   /F-
		   Continue  the  previously  executed	/F   command,
		   toward the top of the list.

   Keystrokes	   Ctrl-F performs a /F+ command.

   Remarks	   This command searches  the current list in memory,
		   not the directories on disk.



   /H (Help)


   Function	   Display the Help file.

   Syntax	   /H

   How To	   To display the fLIST Help  file,  type  /H  on any
		   command line and press Ctrl-X.

   Examples	   /H
		   Display the Help file in a pop-up window.

   Keystrokes	   Ctrl-F performs a /H command.

   Remarks	   The contents of the Help file may be customized to
		   your liking with the  fLIST	Help  File Generator.
		   This  utility, along with the fLIST	Customization
		   Guide which describes  how to customize fLIST, are
		   provided to licensed fLIST users.



   /K (Keys)


   Function	   Display the current key definitions.

   Syntax	   /K

   How To	   To display the current key definitions, type /K on
		   any command line and press Ctrl-X.

   Examples	   /K
		   Display the key definitions in a pop-up window.




   26						   fLIST User's Guide






	  Keystrokes	  Ctrl-K performs a /K command.

	  Remarks	  The  key  definitions may be	customized  to	your
			  liking in  the  customization  Profile.  The fLIST
			  Customization   Guide   which   describes  how  to
			  customize fLIST,  is	provided  to  licensed fLIST
			  users.



	  /L (List)


	  Function	  Creates a new list or selects another list.

	  Syntax	  /L  [ pattern ]

			  /L+  [ num | 1 ]

			  /L-  [ num | 1 ]

	  How To	  To create a  list  of all files contained within a
			  directory currently in the list,  type  /L  on the
			  command  line  associated  with that directory and
			  press Ctrl-X. fLIST will  append  the  filename of
			  the directory to the command when it is executed.

			  To create a list of  files  not  currently  in the
			  list, type /L followed by a  selection  pattern on
			  any command line and press Ctrl-X.

			  To  select  a  list  which was created previously,
			  type	/L+  (forward  in  the	list  ring)  or  /L-
			  (backward in the list ring)  on  any	command line
			  and press Ctrl-X.

	  Examples	  /L  \
			  Create a list of all files in the root directory

			  /L  \HDR\*.H
			  Create  a  list  of all C header files in the \HDR
			  directory

			  /L-  2
			  Select the second previous list in the list ring

	  Keystrokes	  Ctrl-L performs a /L- command.

	  Remarks	  Lists are arranged in a circular ring which can be
			  traveled in either direction. When a	new  list is
			  created, it is inserted  at  the  current position
			  within the list ring. When a list is discarded, it
			  is deleted from the list ring. Any number of lists
			  may  be  created,  although  as  available  memory



	  Chapter 4,  Command Reference 				  27






		   becomes limited some performance degradation  will
		   be apparent when selecting lists.



   /M (Marked)


   Function	   Executes a DOS command for all marked files in the
		   current list.

   Syntax	   /M  command

   How To	   To execute a  DOS  command for all marked files in
		   the current list, type /M followed by  the command
		   to be  executed  on	any  command  line  and press
		   Ctrl-X.

   Examples	   /M  COPY / \
		   Copy all marked files to the root directory.

   Keystrokes	   None.

   Remarks	   The marked  status  of  files  may  be  toggled by
		   pressing Ctrl-P.



   /O (Omit)


   Function	   Omits the filename from a command line.

   Syntax	   /O  command

   How To	   To prevent the filename from being  appended  to a
		   command line, type /O followed by the  DOS command
		   to be  executed  on	any  command  line  and press
		   Ctrl-X.

   Examples	   /O  COMMAND
		   Shell  to  a  second  copy  of  the	 DOS  Command
		   Processor from within fLIST.

   Keystrokes	   None.

   Remarks	   This command is only required when no portion of a
		   filename is	to be included in the DOS command. If
		   any filename variable (/, /D, /E, /N and/or /P) is
		   specified within the  command line, fLIST will not
		   append the filename to the command line.






   28						   fLIST User's Guide






	  /Q (Quit)


	  Function	  Discards the current list.

	  Syntax	  /Q  [ num | 1 ]

	  How To	  To  discard  the  current  list,  type  /Q  on any
			  command line and press Ctrl-X.

	  Examples	  /Q
			  Discard the current list.

			  /Q  999
			  Discard  a large number of lists, effectively  the
			  same as the /C command.

	  Keystrokes	  Esc performs a /Q command.

	  Remarks	  If this command is executed when only one (1) list
			  exists, fLIST will exit  to  DOS  after discarding
			  the list.



	  /R (Replace)


	  Function	  Replaces the current list.

	  Syntax	  /R  [ pattern ]

	  How To	  To  replace  the   current  list  with  one  which
			  consists of all files contained within a directory
			  currently in the list, type /R on the command line
			  associated  with that directory and press  Ctrl-X.
			  fLIST will append the filename of the directory to
			  the command when it is executed.

			  To  replace  the   current  list  with  one  which
			  consists of files not currently in the  list, type
			  /R followed by a selection pattern on  any command
			  line and press Ctrl-X.

	  Examples	  /R  \
			  Replace the current list with one consiting of all
			  files in the root directory.

			  /R  \SRC\*.C
			  Replace  the current list with one which  consists
			  of all C files in the \SRC directory.

	  Keystrokes	  None.




	  Chapter 4,  Command Reference 				  29






   Remarks	   This command functions as if the  /L  command were
		   executed to create a  new  list  and  the previous
		   list were discarded using the /Q command.  The new
		   list  will  contain	only  a  single  group	until
		   subsequent /A commands are executed.



   /S (Sort)


   Function	   Sort the current list.

   Syntax	   /SD

		   /SE

		   /SG

		   /SN

		   /SS

   How To	   To sort the list in descending Date/Time sequence,
		   type /SD on any command line and press Ctrl-X.

		   To sort the list in ascending  Extension  and Name
		   sequence, type /SE on any command  line  and press
		   Ctrl-X.

		   To sort the	list  in  ascending  Group,  Name and
		   Extension  sequence, type /SG on any command  line
		   and press Ctrl-X.

		   To sort the list in ascending  Name	and Extension
		   sequence, type /SN on any command  line  and press
		   Ctrl-X.

		   To sort the list in descending Size sequence, type
		   /SS on any command line and press Ctrl-X.

   Examples	   /SN
		   Sort  the  current  list  by  ascending  Name  and
		   Extension.

		   /SS
		   Sort the current list by descending Size.

   Keystrokes	   Ctrl-D performs a /SD command.

		   Ctrl-E performs a /SE command.

		   Ctrl-G performs a /SG command.




   30						   fLIST User's Guide






			  Ctrl-N performs a /SN command.

			  Ctrl-S performs a /SS command.

	  Remarks	  The  sort sequence is preserved across  executions
			  of the /A, /R  and  /U  commands. The default sort
			  sequence may be customized to your  liking  in the
			  customization  Profile.  The	fLIST  Customization
			  Guide  which describes how to customize fLIST,  is
			  provided to licensed fLIST users.



	  /T (Top)


	  Function	  Displays the first full page of the current list.

	  Syntax	  /T

	  How To	  To display the first	page  of  the  current list,
			  type /T and press Ctrl-X.

	  Examples	  /T
			  Display the first page of the current list

	  Keystrokes	  Ctrl-T  and Ctrl-PgUp  perform  a  FIRST  keyboard
			  function.

	  Remarks	  This	command  is  provided for compatibility with
			  the original IBM  utility. The preferred method of
			  displaying  the  first  page	of  the  list  is by
			  pressing Ctrl-PgUp, which  is defined as the FIRST
			  keyboard function.



	  /U (Update)


	  Function	  Update the current list from disk.

	  Syntax	  /U

	  How To	  To update the list,  type  /U  on any command line
			  and press Ctrl-X.

	  Examples	  /U
			  Update the current list from disk.
			  with	one  consiting	of  all  files	in  the root
			  directory.

	  Keystrokes	  Ctrl-U performs a /U command.




	  Chapter 4,  Command Reference 				  31






   Remarks	   This  command  will	recreate  the current list by
		   reselecting files from the disk  directories using
		   the selection patterns for each group in the list.
		   This  process is necessary when files are  copied,
		   renamed or erased on disk.



   /X (eXecute)


   Function	   Executes all command lines.

   Syntax	   /X

   How To	   To execute all command lines, press a key which is
		   defined to perform a /X command.

   Examples	   Ctrl-X
		   Execute all command lines.

   Keystrokes	   Ctrl-X performs an EXECUTE keyboard function.

   Remarks	   This  command  is  provided for compatibility with
		   previous   versions	 of   fLIST  (PC-FLIST).  The
		   preferred method of executing all command lines is
		   by pressing a key defined as the  EXECUTE keyboard
		   function (Ctrl-X).



   / (Goto)


   Function	   Jump to a file within the current list.

   Syntax	   /

		   /num

		   /+num

		   /-num

   How To	   To locate a	file  in  the  list at the top of the
		   screen, type / on the command line associated with
		   that directory and press Ctrl-X.

		   To locate the 84th file in the list at the  top of
		   the screen, type /84 on any command line and press
		   Ctrl-X.

		   To scroll  forward 10 files in the list, type /+10
		   on any command line and press Ctrl-X.



   32						   fLIST User's Guide






			  To scroll backward 10 files in the list, type /-10
			  on any command line and press Ctrl-X.

	  Examples	  /
			  Locate the current file at the top of the screen.

			  /9999
			  Locate the last file in the list at the top of the
			  screen.

	  Keystrokes	  None.

	  Remarks	  None.



	  ? (Recall)


	  Function	  Recalls the last DOS command executed.

	  Syntax	  ?

	  How To	  To recall the last DOS command executed, type ? on
			  any command line and press Ctrl-X.

	  Examples	  ?
			  Recall last DOS command.

	  Keystrokes	  None.

	  Remarks	  Only	DOS  commands  may  be	recalled  with	this
			  command.



	  = (Repeat)


	  Function	  Repeats the last DOS command executed.

	  Syntax	  =

	  How To	  To repeat the  last  DOS  command  executed  for a
			  series of files,  type  = on each command line and
			  press Ctrl-X.

	  Examples	  =
			  Repeat last DOS command.

	  Keystrokes	  None.

	  Remarks	  Only	DOS  commands  may  be	repeated  with	this
			  command.



	  Chapter 4,  Command Reference 				  33































































   34						   fLIST User's Guide












				      Chapter 5

				  Variable Reference


	  fLIST supports a variety of  filename variables which may be typed
	  in a command line or assigned to keystrokes as  described  in  the
	  Customization   Guide.   Whenever   fLIST  encounters  a  filename
	  variable, the variable  is  replaced	by  the  associated filename
	  component from the current  filename.  Filename  variables  may be
	  combined  without  repeating	the  fLIST  command  character.  For
	  example, the following are equivalent:

	       /D/P/N
	       /D/PN
	       /DP/N
	       /DPN



	  Summary of Variables


	  /		  Insert	the	    complete	    filename
			  (DRIVE:\PATH\NAME.EXT)

	  /D		  Insert the drive portion of filename (DRIVE:)

	  /E		  Insert  the  extension  portion  of  the  filename
			  (.EXT)

	  /N		  Insert the name portion of the filename (NAME)

	  /P		  Insert the path portion of the filename (\PATH\)



	  / (DRIVE:\PATH\NAME.EXT)


	  Function	  Inserts the complete filename in a command line.

	  Syntax	  /

	  How To	  To insert the complete filename in a command line,
			  type / at the desired location.





	  Chapter 5,  Variable Reference				  35






   Examples	   COPY / A:
		   Insert the complete filename in a COPY command.

   Keystrokes	   Alt-F types a / variable.

   Remarks	   Inserting   a   filename   variable	prevents  the
		   complete   filename	 from	automatically	being
		   appended to the end of a command.



   /D (DRIVE:)


   Function	   Insert the drive  portion  of a filename (D:) in a
		   command line.

   Syntax	   /D

   How To	   To insert the drive portion	of  a  filename  in a
		   command line, type /D at the desired location.

   Examples	   DIR /D*.H
		   Insert the drive portion  of  a  filename in a DIR
		   command.

   Keystrokes	   Alt-D types a /D variable.

   Remarks	   Inserting   a   filename   variable	prevents  the
		   complete   filename	 from	automatically	being
		   appended to the end of a command.



   /E (.EXT)


   Function	   Insert the extension  portion of a filename (.EXT)
		   in a command line.

   Syntax	   /E

   How To	   To insert the extension portion of a filename in a
		   command line, type /E at the desired location.

   Examples	   ERASE *./E
		   Insert the extension portion of a  filename	in an
		   ERASE command.

   Keystrokes	   Alt-E types a /E variable.

   Remarks	   Inserting   a   filename   variable	prevents  the
		   complete   filename	 from	automatically	being
		   appended to the end of a command.



   36						   fLIST User's Guide






	  /N (NAME)


	  Function	  Insert the  name portion of a filename (NAME) in a
			  command line.

	  Syntax	  /N

	  How To	  To  insert the name portion of  a  filename  in  a
			  command line, type /N at the desired location.

	  Examples	  CC /N
			  Insert  the name portion of a  filename  in  a  CC
			  command.

	  Keystrokes	  Alt-N types a /N variable.

	  Remarks	  Inserting   a   filename   variable  prevents  the
			  complete   filename	from   automatically   being
			  appended to the end of a command.



	  /P (\PATH\)


	  Function	  Insert the path portion of a filename  (\PATH\) in
			  a command line.

	  Syntax	  /P

	  How To	  To  insert the path portion of  a  filename  in  a
			  command line, type /P at the desired location.

	  Examples	  REN /P*.X *.Y
			  Insert the path portion of  a  filename  in  a REN
			  command.

	  Keystrokes	  Alt-P types a /P variable.

	  Remarks	  Inserting   a   filename   variable  prevents  the
			  complete   filename	from   automatically   being
			  appended to the end of a command.














	  Chapter 5,  Variable Reference				  37































































   38						   fLIST User's Guide












				      Appendix A

				    fLIST Messages


	  fLIST produces a variety of messages as notification of events and
	  errors  encountered  during	processing.  Message  texts  may  be
	  modified to suit your  requirements,	even  translated  into other
	  languages.  The  message  texts  described  here  represent  those
	  defined in the product as distributed:


	  [Aborted]
	  This	message appears on a command line  when  the  command  being
	  executed ends due to a reply of Abort to the Abort,  Retry, Ignore
	  message from DOS. If BREAK-LEVEL is set to  3  or  less,  no other
	  command  lines are executed. Press Ctrl-X  again  to	execute  the
	  remaining command lines. (Message 23)


	  [Interrupted]
	  This	message appears on a command line  when  the  command  being
	  executed  ends  due  to  a  Ctrl-Break (or Ctrl-C)  interrupt.  If
	  BREAK-LEVEL  is  set to 3 or less,  no  other  command  lines  are
	  executed. Press Ctrl-X  again  to  execute  the  remaining command
	  lines. (Message 22)


	  [RC=nnnn]
	  This	message appears on a command line  when  the  command  being
	  executed  ends  with	a  non-zero  return  value  (errorlevel). If
	  BREAK-LEVEL  is  set to 2 or less,  no  other  command  lines  are
	  executed. Press Ctrl-X  again  to  execute  the  remaining command
	  lines. (Message 21)


	  Command not found
	  This	message appears on a command line  when  the  command  being
	  executed could not be found. Verify the name of  the	command  and
	  the PATH environment variable. (Message 16)


	  Drive data error (bad CRC)
	  This message appears when a  data error occurs while attempting to
	  access  a  disk  drive. Verify the  media  with  CHKDSK  and	take
	  appropriate corrective action. (Message 26)





	  Appendix A,  fLIST Messages					  39






   Drive disk error
   This  message appears when an error	occurs	while  attempting  to
   access  a  disk  drive. Verify the  media  with  CHKDSK  and  take
   appropriate corrective action. (Message 28)


   Drive general failure
   This message appears when an unknown error occurs while attempting
   to  access a disk drive. Verify the media  with  CHKDSK  and  take
   appropriate corrective action. (Message 32)


   Drive not ready
   This  message   appears  when  a  not  ready  error	occurs	while
   attempting  to  access  a disk drive. Verify the media is inserted
   and the drive door is closed. (Message 25)


   Drive read fault
   This message appears when an read error occurs while attempting to
   access  a  disk  drive. Verify the  media  with  CHKDSK  and  take
   appropriate corrective action. (Message 31)


   Drive sector error
   This message  appears when an format error occurs while attempting
   to access a disk drive. Verify the media was  formatted  for  this
   type of disk drive. (Message 29)


   Drive seek error
   This message appears when an seek error occurs while attempting to
   access a disk drive. Verify the media was formatted for  this type
   of disk drive. (Message 27)


   Drive write fault
   This message appears  when  an write error occurs while attempting
   to  access a disk drive. Verify the media  with  CHKDSK  and  take
   appropriate corrective action. (Message 30)


   Drive write protected
   This  message appears when an write	protect  error	occurs	while
   attempting  to access a disk drive. Verify  the  proper  media  is
   inserted and remove the write protect tab if appropriate. (Message
   24)


   Environment invalid
   This  message appears on a command line  when  the  command	being
   executed fails due  to  an invalid environment. Attempt to execute
   the command again, if the  problem persists reboot the system when




   40						   fLIST User's Guide






	  it  is  convenient  and  attempt  to	execute  the command  again.
	  (Message 18)


	  Error(s) in Help file
	  This message appears when the Help file is not the  proper format.
	  Recreate the Help file  using  the  fLIST  Help File Generator and
	  rerun fLIST. (Message 15)


	  Error(s) in Profile
	  This message appears when  error(s)  are  detected in the Profile.
	  The Error file, FLIST.ERR in the FLIST directory,  will  contain a
	  detailed  list  of  all  Profile  errors.  Correct  the statements
	  flagged as errors and rerun fLIST. (Message 13)


	  Format invalid
	  This	message appears on a command line  when  the  command  being
	  executed fails due to an  invalid format. Verify the command being
	  executed is a valid .EXE file or recreate the  command  and  rerun
	  the command. (Message 19)


	  Help file not found
	  This	message appears when the Help file  could  not	be  located.
	  Verify  the  name  of the Help file and both the  FLIST  and	PATH
	  environment variables and rerun fLIST. (Message 14)


	  Holding ...
	  This message appears	when  the next screen would possibly overlay
	  command  output.  After  viewing  the  output,  press  any key  to
	  continue. (Message 3)


	  Invalid TERM= environment variable
	  This	message  appears  when	the  value  specified  for the	TERM
	  environment  variable  is invalid. Correct  the  TERM  environment
	  variable and rerun fLIST. (Message 5)


	  Invalid command line option(s)
	  This message appears	when  an unrecognized command line option is
	  specified.  Correct  the  command  line  option  and	rerun fLIST.
	  (Message 7)


	  Invalid file selection pattern
	  This message appears when  an  improper  file selection pattern is
	  specified. Correct the  file	selection  pattern  and  reissue the
	  fLIST command. (Message 9)





	  Appendix A,  fLIST Messages					  41






   Maximum of 9 file groups
   This message appears  when  an  attempt  is	made to add to a list
   which already contains nine	(9)  file  groups.  Create a new list
   rather than attempting to add to the current list. (Message 8)


   No matching file(s) found
   This message appears when no files match a file selection pattern.
   Specify  a  new  file  selection  pattern  and  reissue the	fLIST
   command. (Message 10)


   No pattern specified
   This message appears when a /F command is issued  without  a  file
   selection  pattern and no previous /F  command  had	been  issued.
   Specify a file selection  pattern  and  reissue the fLIST command.
   (Message 11)


   Not enough memory available
   This message appears when there is  insufficient  memory available
   to perform the requested function. Specify a different function or
   remove large TSR commands. (Message 6)


   Pausing ...
   This  message  appears  when  a  command is about to be  executed.
   Verify  the	command  line  shown,  press  Esc  to  abort  command
   execution or press any other  key to execute the command. (Message
   4)


   Permission denied
   This  message appears on a command line  when  the  command	being
   executed fails due to a  sharing violation. Verify the command may
   be shared and rerun the command. (Message 17)


   Profile not found
   This message appears when the Profile could not be located. Verify
   the name of the Profile and both the FLIST  and  PATH  environment
   variables and rerun fLIST. (Message 12)


   Unknown EXEC error
   This  message appears on a command line  when  the  command	being
   executed fails  due to an unknown EXEC error. Contact CodeCrafters
   about this problem  and  include all applicable files and commands
   to assist in problem diagnosis. (Message 20)








   42						   fLIST User's Guide












				      Appendix B

			       Default Key Assignments


	  fLIST is distributed with a minimal  built-in  configuration which
	  enables  it	to  be	used  without  any  customization.  The  key
	  definitions of this minimal configuration are as follows:

	  Ctrl-A	  Add the current file/directory to the current list

	  Ctrl-B	  Go to the last page (bottom) of the current list

	  Ctrl-C	  Discard all lists and return to DOS

	  Ctrl-D	  Sort the current list by descending Date and Time

	  Ctrl-E	  Sort	the current list by ascending Extension  and
			  Name

	  Ctrl-F	  View the Help file in a pop-up window

	  Ctrl-G	  Sort the current list by ascending Group, Name and
			  Extension

	  Backspace	  Delete the character to the left of the cursor

	  Tab		  Tab to the next word

	  Ctrl-K	  View the Key Definitions in a pop-up window

	  Ctrl-L	  Select the next list in the ring of lists

	  Enter 	  Cursor to the beginning of the next command line

	  Ctrl-N	  Sort	the  current  list  by	ascending  Name  and
			  Extension

	  Ctrl-O	  Unmark all marked files in the current list

	  Ctrl-P	  Toggle current file mark status

	  Ctrl-Q	  Run current file as a command

	  Ctrl-S	  Sort the current list by descending Size

	  Ctrl-T	  Go to the first page (top) of the current list




	  Appendix B,  Default Key Assignments				  43






   Ctrl-U	   Update the current list from disk

   Ctrl-X	   Execute all command lines

   Ctrl-Z	   Meta prefix for compound key definitions

   Esc		   Discard the current list

   F1		   View the Help file in a pop-up window

   F2		   Run TYPE using the current file as input

   F3		   Run EDLIN using the current file as input

   F4		   Add the current file/dorectory to the current list

   F5		   Make a new list using the current file/directory

   F6		   Replace   the  current  list  using	the   current
		   file/directory

   F7		   Select the previous list in the ring of lists

   F8		   Select the next list in the ring of lists

   F9		   Discard all lists and return to DOS

   F10		   Discard the current list

   Shift-F1	   View the Key Definitions in a pop-up window

   Shift-Tab	   Backtab to the previous word

   Up		   Cursor up to the previous command line

   Down 	   Cursor down to the next command line

   Left 	   Cursor left to the previous character

   Right	   Cursor right to the next character

   PgUp 	   Go to the previous page of the current list

   PgDn 	   Go to the next page of the current list

   Home 	   Cursor to the beginning of the command line

   End		   Cursor to the end of the command line

   Ins		   Switch between Insert and Overwrite modes

   Del		   Delete the character above the cursor

   Ctrl-Left	   Delete all characters to the left of the cursor



   44						   fLIST User's Guide






	  Ctrl-Right	  Delete all characters to the right of the cursor

	  Ctrl-PgUp	  Go to the first page (top) of the current list

	  Ctrl-PgDn	  Go to the last page (bottom) of the current list

	  Ctrl-Home	  Cursor to the first line on the screen

	  Ctrl-End	  Cursor to the last line on the screen

	  Alt-C 	  Erase all command lines

	  Alt-D 	  Type /D at the  current  location  in  the command
			  line

	  Alt-E 	  Type /E at the  current  location  in  the command
			  line

	  Alt-F 	  Type / at the current location in the command line

	  Alt-N 	  Type /N at the  current  location  in  the command
			  line

	  Alt-P 	  Type /P at the  current  location  in  the command
			  line

	  Alt-S 	  Run COMMAND as a second-level shell






























	  Appendix B,  Default Key Assignments				  45































































   46						   fLIST User's Guide












					Index


		 [! ] pattern 20	     /TB option 19
		 [ ] pattern 20 	     /TC option 20
		 { } pattern 20 	     /TE option 20
		 43-line 8		     /TI option 20
		 50-line 8		     /TV option 20
		 / command 32		     /TW option 20
		 = command 33		     /U command 31
		 ? command 33		     /X command 32
		 /+num command 32
		 /-num command 32	     A
		 * pattern 20		     aborting commands 39
		 ? pattern 20		     ANSI
		 / variable 15, 28, 35		color 9
		 /A command 24			monochrome 8
		 /B command 24		     AUTOEXEC.BAT 8, 9
		 /C command 25
		 /D variable 15, 28, 36      B
		 /E variable 15, 28, 36      BIOS 8
		 /Efile option 19	     Bourne shell (sh) 20
		 .EXT 36
		 /F+ command 25 	     C
		 /F- command 25 	     C shell (csh) 20
		 /F command 25		     CGA 8
		 /H command 26		     command line 19, 41
		 /Hfile option 19	     commands
		 /K command 26			/ 32
		 /L+ command 27 		= 33
		 /L- command 27 		? 33
		 /L command 27			/+num 32
		 /M command 28			/-num 32
		 /N variable 15, 28, 37 	/A 24
		 /num command 32		/B 24
		 /O command 15, 28		/C 25
		 /P variable 15, 28, 37 	/F 25
		 \PATH\ 37			/F+ 25
		 /Pfile option 19		/F- 25
		 /Q command 29			/H 26
		 /R command 29			/K 26
		 /SD command 30 		/L 27
		 /SE command 30 		/L+ 27
		 /SG command 30 		/L- 27
		 /SN command 30 		/M 28
		 /SP command 30 		/num 32
		 /T command 31			/O 15, 28
		 /TA option 19			/Q 29



	  Index 							  47






	     /R 29		      drive portion of
	     /SD 30			 filename 36
	     /SE 30
	     /SG 30		      E
	     /SN 30		      editing
	     /SP 30			 deleting characters
	     /T 31			 13
	     /U 31		      EGA 8
	     /X 32		      environment 8
	     aborting 39		 FLIST 8
	     commenting 14		 PATH 8
	     concatenating 14		 TERM 8, 41
	     executing 14, 28,		    ansi-pc 8, 19
	     32, 39, 40, 41, 42 	    bios-pc 8, 19
	     interrupting 39		    c_ansi-pc 9, 20
	     recalling 33		    ega-pc 8, 20
	     repeating 33		    ibm-pc 8, 20
	     return values 39		    vga-pc 8, 20
	     summary 23 		    wang-pc 9, 20
	  commenting commands 14      errors
	  complete filename 35		 disk 39, 40
	  concatenating commands      Evaluation Diskette 6
	     14 		      Evaluation Package 3, 6
	  configuration 	      executing commands 14,
	     minimum MS-DOS 6		 28, 32, 39, 40, 41,
	     minimum UNIX/XENIX 6	 42
	  creating lists 17, 27       exiting fLIST 25, 29
	  Ctrl-Break interrupts       expanding lists 17, 24,
	     39 			 42
	  cursor		      extension portion of
	     movement 12		 filename 36
	  customization 16, 41,
	     42 		      F
	  Customization Guide 26,     features 5
	     27, 31		      filenames
					 complete 35
	  D				 drive portion 36
	  deleting characters 13	 extension portion 36
	  DESQview 9			 manipulating 14, 28,
	  DESQview/386 9		 35, 36, 37
	  discarding lists 18,		 name portion 37
	     25, 29			 path portion 37
	  disk errors 39, 40	      files
	  Diskette			 AUTOEXEC.BAT 8, 9
	     Distribution 7		 finding 25, 42
	     Evaluation 6		 FLHELP.EXE 7
	  display 12			 FLIST.ERR 19
	     group area 12		 FLIST.EXE 6, 11
	     information area 12	 FLIST.HLP 6, 19
	     input area 12		 FLIST.PRO 7, 19
	     name area 12		 GUIDE 7
	  Distribution Diskette 7	 HELPTEXT 7
	  DRIVE: 36			 LICENSE 3, 7
	  DRIVE:\PATH\NAME.EXT 35	 marked 28



   48						   fLIST User's Guide






		    README 7, 14	     I
		    selecting 19, 20,	     installation 6
		    41, 42		     interrupting commands
		 finding files 25, 42		39
		 FLHELP 26		     interrupts
		 FLHELP.EXE 7			Ctrl-Break 39
		 FLIST 8
		 fLIST			     K
		    command line 19, 41      key definitions 26, 43
		    commands 23 	     keyboard systems 6
		    customization 16,	     Korn shell (ksh) 20
		    41, 42
		    Customization Guide      L
		    26, 27, 31		     LICENSE 3, 7
		    display 12		     License Agreement 3
		    environments 6	     Licensed User Package 7
		    Evaluation Package	     licensing fLIST 3, 6
		    3, 6		     lists
		    exiting 18, 25, 29		creating 17, 27
		    features 5			discarding 18, 25,
		    files 6			29
		    for MS-DOS 6		expanding 17, 24, 42
		    for UNIX/XENIX 6		replacing 29
		    help information 15,	scrolling 13, 24,
		    26, 41			31, 32
		    history 5			searching 25, 42
		    installation 6		selecting 18, 27
		    key definitions 26, 	sorting 13, 30
		    43				updating 31
		    License Agreement 3
		    Licensed User	     M
		    Package 7		     manipulating filenames
		    licensing 3, 6		14, 28, 35, 36, 37
		    loading 11, 19	     marked files 28
		    messages 39 	     MCGA 8
		    overview 5		     MDA 8
		    product support 3	     memory requirement 6
		    tutorial 11 	     messages 39
		    variables 35	     Microsoft Windows 9
		 FLIST.ERR 19		     MS-DOS 6
		 FLIST.EXE 6, 11
		 FLIST.HLP 19		     N
		 FLIST.PRO 7, 19	     NAME 37
					     name portion of
		 G				filename 37
		 getting started 5
		 GUIDE 7		     O
					     options
		 H				/Efile 19
		 HELP ! 15, 26, 41		/Hfile 19
		 HELPTEXT 7			/Pfile 19
		 history 5			/TA 19
						/TB 19
						/TC 20



	  Index 							  49






	     /TE 20		      updating lists 31
	     /TI 20
	     /TV 20		      V
	     /TW 20		      variables
					 / 15, 28, 35
	  P				 /D 15, 28, 36
	  PATH 8			 /E 15, 28, 36
	  path portion of		 /N 15, 28, 37
	     filename 37		 /P 15, 28, 37
	  pattern matching 19, 20	 environment 8
	     * 20			 FLIST 8
	     ? 20			 PATH 8
	     [ ] 20			 summary 35
	     { } 20			 TERM 8, 41
	     [! ] 20			    ansi-pc 8, 19
	     DOS wildcards 21		    bios-pc 8, 19
	  PC-FLIST 32			    c_ansi-pc 9, 20
	  product support 3		    ega-pc 8, 20
					    ibm-pc 8, 20
	  R				    vga-pc 8, 20
	  README 7, 14			    wang-pc 9, 20
	  recalling commands 33       VGA 8
	  repeating commands 33       video systems 6
	  replacing lists 29		 43-line 8
	  return values from		 50-line 8
	     commands 39		 BIOS 8
					 CGA 8
	  S				 color ANSI 9
	  scrolling lists 13, 24,	 EGA 8
	     31, 32			 MCGA 8
	  searching lists 25, 42	 MDA 8
	  selecting files 19, 20,	 monochrome ANSI 8
	     41, 42			 VGA 8
	  selecting lists 18, 27	 Wang PC/APC 9
	  Shareware 7
	  sorting lists 13, 30	      W
				      Wang PC/APC 9
	  T
	  TERM 8, 41		      X
	  tutorial 11		      XENIX 6

	  U
	  UNIX 6, 20














   50						   fLIST User's Guide

