OS/2 Shareware BBS: 6 File/06-File.zip/lstman.zip/LISTMAN.HLP

OS/2 Help File | 1995-02-09 | 12KB | 296 lines

ΓòÉΓòÉΓòÉ 1. Introduction: ΓòÉΓòÉΓòÉ

List Man is a utility that helps you create a list, of file paths and names, to
be read by other programs, including Dos programs.  List Man uses two window
lists.  You build and maintain a list of file paths and names in the main
list-box.  In the Commands container you can maintain a list of commonly used
commands to pass the list to.  When you Run a command from the Commands
container, List Man creates a temporary file containing the lines of the List
Man list-box, and starts the selected command and passes the name of the
temporary file to it.  See the Example.Cmd file for an example of a Rexx
program that can be called from List Man and will further call PkZip and pass
it the name of the temporary file.  You don't have to call a Rexx program
between List Man and your program, but as you will see, some times it helps.

Drag & Drop folders to the List Man list-box to build the list of file names.
Set the Traverse SubFolders Option to include all files from all sub-folders.
You can edit individual lines in the list or edit the entire list to fine tune
the lines of the list.  You can save the list and load it later.

Drag & Drop folders to the List Man Commands container to build the list of
file names.  Set the Traverse SubFolders Option to include all files from all
sub-folders.  You can edit individual lines in the list or edit the entire list
to fine tune the lines of the list.  You can save the list and load it later.

See Disclaimer.


ΓòÉΓòÉΓòÉ 2. Disclaimer: ΓòÉΓòÉΓòÉ

Keystone Software Corp. makes no representation or warranty with respect to the
adequacy of this program or the documentation which describes it for any
particular purpose or with respect to its adequacy to produce any particular
result.  In no event shall Keystone Software Corp., its employees, its
contractors, the authors of the program and documentation, or Watcom (Watcom
International Corporation and all of its subsidiaries) be liable for special,
direct, indirect or consequential damages, losses, costs, charges, claims,
demands or claim for lost profits, fees or expenses of any nature or kind.


ΓòÉΓòÉΓòÉ 3. List Man List-Box: ΓòÉΓòÉΓòÉ

The List Man List-Box contains the list of files being constructed.  Drag &
Drop Files & Folders to this list-box to add files to the list.  Use the
options under List menu item to maintain the items in the list-box.


ΓòÉΓòÉΓòÉ 4. List Man -- List: ΓòÉΓòÉΓòÉ

Maintain the entries in the List Man List-Box.  Use Find to find a file to
include in the list.  Use Load to Load a previously saved list into the
list-box.  Use Save to Save the contents of the list-box to a text file.  Use
Clear to Clear the contents of the list-box.  Use Remove Selected to remove the
selected lines from the list-box.  Use Add/Edit Selected to Edit the first
selected item in the list-box or to Add a new line if no lines are selected.
Use Edit List to Edit the contents of the list-box.


ΓòÉΓòÉΓòÉ 4.1. Find: ΓòÉΓòÉΓòÉ

Use the Find menu option under List, to find a file to include in the list.
This option uses a standard find a file dialog box.


ΓòÉΓòÉΓòÉ 4.2. Load: ΓòÉΓòÉΓòÉ

Use the Load menu option under List, to Load a previously saved list into the
list-box.  This option reads a standard text file into the list-box.


ΓòÉΓòÉΓòÉ 4.3. Save: ΓòÉΓòÉΓòÉ

Use the Save and Save As option under List, to Save the contents of the
list-box to a text file.  The Save As option will prompt for a file name.


ΓòÉΓòÉΓòÉ 4.4. Clear: ΓòÉΓòÉΓòÉ

Use the Clear option under List, to Clear the contents of the list-box.


ΓòÉΓòÉΓòÉ 4.5. Remove Selected: ΓòÉΓòÉΓòÉ

Use the Remove Selected option under List, to remove the selected lines from
the list-box.

You can also remove items from the list by Draging and Droping them on the
Shredder.


ΓòÉΓòÉΓòÉ 4.6. Add/Edit Selected: ΓòÉΓòÉΓòÉ

Use the Add/Edit Selected option under List, to Edit the first selected item in
the list-box or to Add a new line if no lines are selected.  Double-clicking on
a list-box line will open the Edit line window.


ΓòÉΓòÉΓòÉ 4.7. Edit List: ΓòÉΓòÉΓòÉ

Use the Edit List option under List, to put the contents of the list-box into a
tempoary text file, for use with one of the OS/2 editors.  The contents of the
list-box will be replaced with the contents of the temporary file upon exiting
the editor.


ΓòÉΓòÉΓòÉ 5. List Man -- Options: ΓòÉΓòÉΓòÉ

Set the Traverse SubFolders Option to include all files from all sub-folders.
Set the List Folder Name only Option to include folder names in the list
instead of the names of the files from the folder.  Use the Create Desktop
Object option to create a desk top object of List Man.  Use the Editor Option
to choose between the Enhanced Editor and the System Editor when editing the
List Man list-box or the Commands container.  Use the Sort Option to choose how
to sort the items in the list-box.  Set the Quote Folder Names Option to place
Quotes around Folder Names that include blanks.


ΓòÉΓòÉΓòÉ 5.1. Traverse SubFolders: ΓòÉΓòÉΓòÉ

Traverse SubFolders indicates that all files in sub-folders should be included
in the List Man list-box when a folder is dropped on the List Man list-box.
List Man will include all files from the folder dropped and from folders in
that and subsequent folders.


ΓòÉΓòÉΓòÉ 5.2. List Folder Name only: ΓòÉΓòÉΓòÉ

List Folder Name only, indicates that folder names with "\*.*" appended will be
placed in the List Man list-box when a folder is dropped on the List Man
list-box.  If this option is not checked the names of files from the folder are
added to the list.


ΓòÉΓòÉΓòÉ 5.3. Desktop Object: ΓòÉΓòÉΓòÉ

This Menu option will create a Desktop Object you can use to start List Man.
The Install process creates the same object, but if it has some how been lost,
deleted or destroyed, this option will recreate it for you.


ΓòÉΓòÉΓòÉ 5.4. Editor: ΓòÉΓòÉΓòÉ

The Editor option allows you to choose between the Enhanced Editor and the
System Editor when editing the List Man list-box or the Commands container.


ΓòÉΓòÉΓòÉ 5.5. Sort: ΓòÉΓòÉΓòÉ

The Sort option allows you to choose between the Ascending, Descending and None
for sorting the contents of the List Man list-box.


ΓòÉΓòÉΓòÉ 5.6. Quote Folder Names: ΓòÉΓòÉΓòÉ

The Quote Folder Names option, if Checked, will place Quotes around Folder
Names that include blanks.


ΓòÉΓòÉΓòÉ 6. Info: ΓòÉΓòÉΓòÉ

General, Registration and Help Information.  See Information, or Registration
for more Information.


ΓòÉΓòÉΓòÉ 7. Command List: ΓòÉΓòÉΓòÉ

The Command List option will make the Command container window visible.


ΓòÉΓòÉΓòÉ 8. Command List Container: ΓòÉΓòÉΓòÉ

The List Man Command List Container contains the Commands to be run with the
list.  Drag & Drop Files & Folders to this Container to add files to it.  Use
the options under List menu item to maintain the items in the container.


ΓòÉΓòÉΓòÉ 9. Command -- List: ΓòÉΓòÉΓòÉ

Maintain the entries in the Command Container.  Use Find to find a program to
include in the container.  Use Load to Load a previously saved list into the
container.  Use Save to Save the contents of the container to a text file.  Use
Clear to Clear the contents of the container.  Use Remove Selected to remove
the selected items from the container.  Use Add/Edit Selected to Edit the first
selected item in the container or to Add a new item if no items are selected.
Use Edit List to Edit the contents of the container.


ΓòÉΓòÉΓòÉ 9.1. Find: ΓòÉΓòÉΓòÉ

Use the Find menu option under List, to find a program or command to include in
the list.  This option uses a standard find a file dialog box.


ΓòÉΓòÉΓòÉ 9.2. Load: ΓòÉΓòÉΓòÉ

Use the Load menu option under List, to Load a previously saved command file
into the container.  This option reads a standard text file into the container.


ΓòÉΓòÉΓòÉ 9.3. Save: ΓòÉΓòÉΓòÉ

Use the Save and Save As option under List, to Save the contents of the
container to a text file.  The Save As option will prompt for a file name.


ΓòÉΓòÉΓòÉ 9.4. Clear: ΓòÉΓòÉΓòÉ

Use the Clear option under List, to Clear the contents of the container.


ΓòÉΓòÉΓòÉ 9.5. Remove Selected: ΓòÉΓòÉΓòÉ

Use the Remove Selected option under List, to remove the selected lines from
the container.

You can also remove items from the list by Draging and Droping them on the
Shredder.


ΓòÉΓòÉΓòÉ 9.6. Add/Edit Selected: ΓòÉΓòÉΓòÉ

Use the Add/Edit Selected option under List, to Edit the first selected item in
the container or to Add a new line if no lines are selected.  Note:
Double-clicking on a container command will run the command.


ΓòÉΓòÉΓòÉ 9.7. Edit List: ΓòÉΓòÉΓòÉ

Use the Edit List option under List, to put the contents of the container into
a tempoary text file, for use with one of the OS/2 editors.  The contents of
the container will be replaced with the contents of the temporary file upon
exiting the editor.


ΓòÉΓòÉΓòÉ 10. Run Selected: ΓòÉΓòÉΓòÉ

Run Selected will Run the Selected command.  List Man will create a temporary
file containing the lines of the List Man list-box, start the selected command
and pass the name of the temporary file to it.  See the Example.Cmd file for an
example of a Rexx program that can be called from List Man and will further
call PkZip and pass it the name of the temporary file.  You don't have to call
a Rexx program between List Man and your program, but as you will see, some
times it helps.  Example.Cmd may not work on your system.  It calls PkZip and
you may not have PkZip, but it is a simple example of how you can call other
command line programs.

You can also Run a command by double-clicking on it in the container.


ΓòÉΓòÉΓòÉ 11. View: ΓòÉΓòÉΓòÉ

The View option allows you to choose between the Icon and Detail Views for
contents of the Commands container.


ΓòÉΓòÉΓòÉ 12. Saving Settings: ΓòÉΓòÉΓòÉ

Closing the Settings notebook saves all your settings in ListMan.Ini, this file
is read when List Man is started and sets List Man with your settings.


ΓòÉΓòÉΓòÉ 13. Registration: ΓòÉΓòÉΓòÉ

List Man is sold as Shareware "Try before you buy".  If you like List Man and
haven't registered and paid for your copy, you should do so.  You can get to
the Registration menu by pressing {Ctrl}R while the List Man window has the
focus, or by selecting "Registration" from the context-menu, (click on the
window with the right mouse button).  Fill in the requested information, print
the registration form and mail it with your check.  Call for volume discount
information.  You can reach Louis LaBrunda at 908-647-5905 or 71604,1662 on
CompuServe.  You have 30 days to try List Man, after which you should send your
registration fee or stop using it.  You have another 30 days after sending your
registration fee, to receive and enter your registration code, after which List
Man will stop working.

Be sure to enter your name the way you wish it to be displayed in the
Information window.  List Man uses your name in its Registration Code
verification process.  Your name and Registration Code are linked and must by
entered in the Registration window for your copy of List Man to be considered
Registered.  Your address is necessary for us to return your Registration Code
by Mail.  Your Comments are also welcome.

If you choose not to register List Man and wish to remove it from your system,
just delete the List Man folder, probably C:\ListMan, and the folder that
VRObj.DLL was stored in probably C:\VXRexx.  If you have VXRexx or any other
Keystone Software Corp. products that use VRObj.DLL, don't delete that folder.
You can also delete the List Man Desktop Object.

See Disclaimer.


ΓòÉΓòÉΓòÉ 14. Desktop Object: ΓòÉΓòÉΓòÉ

This Menu option will create a Desktop Object you can use to start List Man.
The Install process creates the same object, but if it has some how been lost,
deleted or destroyed, this option will recreate it for you.