                                  CD List

                          (c) 1994-98 D.G. Sureau
                                      
                             For 80386 and more
                                  Freeware

    Ŀ
                                 Summary                            
    
       Overview
       How to install
       Starting up  
       Icons of the text viewer     
       Commands of the text viewer
       Icons of the file manager 
       Commands of the file manager  
       The alternate directory 
       The input line editor
       Summary and chapters
       Hypertext
       Directory list mask
       Tagging
       ZIP archives
        ZIP Menu
        Viewing an archive
        Unarchiving                   
        Reading text inside archive
        Running program inside archive              
        Making or updating archive                
       Disk format
       Disk copy
       File and directory copy 
       Dir and Disk commands
       Direct DOS commands
       Edit
       Launching a program
       Descriptions of files           
       CDLIST.INI


OVERVIEW

  CD List  is  an  advanced,  keyboard and mouse driven  program to display
text  files  and  browse  large  disks, with a graphical interface. Its main
purpose  is to browse CD-ROM or disk handling archives with ZIP format, view
content,  navigate  inside  if  directories  included, and read texts or run
programs...
 A Windows 9n and Linux version exists, its name is Advanced Explorer.
 This version doesn't display long name but keep them when MS-DOS programs as
XCOPY are used.

 Tested on MS-DOS 3.3 to 7, Windows 3.11. Works with Windows 95 without long
names.

Disk features:
- Double directory list.
- Front-end to ZIP: make, extract archives, navigate inside.
- Read files inside archives.
- Run programs inside archives.
- Display BBS description for each file if a BBS file in the directory.
  Otherwise displays description according to the extension.
- Extended file, dir, and disk management, uses tagged lists.
- Secured format: works on diskettes only.
- Special MS-DOS window with scrolling list of functions. Apply any commands
  to current file or tagged list.
- Search for file and point out in dir.

Text features:
- Read text with no size limit.
  Lines can take up to 256 characters long.
- Search for a document in a whole disk.
- Access a chapter in a document by a click on the title.
- String search.
- Can call Teknow or other editor to edit the text.



HOW TO INSTALL

 Nothing to do to install CD List: simply copy the files.
 In  no temporary dir is set in the CDLIST.INI, CD List must create one in
its directory, to properly work, so a no write-protected disk is required.

 By  editing  the  INI  file,  you  may configure the program, set path, set
utilities  called  by  it  (archiver, unarchiver, text editor). You may also
write DOS commands that are useful for you in the [Commands] section.
 If you have a removable drive unit, put its type at the "RemovableUnit"
variable.
 Set the temporary directory to the "TempPath"" variable to replace c:\temp.


 Installing for Windows:  as above, plus:
1) You may use the property function to install the CD List icon.
2) You may associate an extension (doc, asc, txt) to CD List.


STARTING UP

Type:      LIST [Drive:][Directory][Filename] [Destination]

Examples:  LIST
           LIST CDLIST.DOC
           LIST A:CDLIST.DOC
           LIST \DOS2\CDLIST.DOC
           LIST sourcedir destdir 

 If  the file is not inside the current directory or the typed path, it will
be searched on the whole disk.


ICONS OF THE TEXT VIEWER

 The  function  of  each  icon may be displayed from within the program by a
mouse click on the icon, with the right mouse button.

Listing  p         Print the text.
HOME     CTRL HOME Return to start of text.
PAGE ->  PAGE DOWN Next page.
Arrows   Cursor    Previous/Next line, or column.
PAGE <-  PAGE UP   Previous page.
END      CTRL END  End of text in memory.
Search   s         Search for a string.
Again    n         Search again.
Hyp      h         Set hypertext mode.
W        w         Wrap-around on/off.
Tree     d         Display the directory of files.
?        F1        Display/Remove the command list. If the text
                   hides this help screen, move it to left with CTRL-RIGHT.
C>..     ALT X     Quit the program in the starting path.


COMMANDS OF THE TEXT VIEWER

Arrows             Scroll the text.
PAGES              Previous/Next page.
CTRL HOME/END      Go to start/end of the text.
CTRL LEFT          Shift the display 20 columns left.
CTRL RIGHT         Shift the display 20 columns right.
HOME               Return to the first column.
CTRL n             Search again.
ALT x              Exit in the starting path.                
a                  About the program, displaying version number.
d                  Directory.
e                  Edit the text.
h                  Set the hypertext mode
n                  Search again.
s                  Search for a string.
p                  Print the document.
q                  Quit in the current directory.
t                  Change text color to amber or green
w                  Set/Reset wrap-around.


ICONS OF THE FILE MANAGER

Listing  p         Print the pointed out file.
HOME     HOME      Go to start of directory.
PAGE ->  PAGE DOWN Display next page of files.
PAGE <-  PAGE UP   Display previous page of files.
END      END       Go to end of directory.
Tree     CTRL t    Display the disk tree.
Glass    l         Locate a file on the current disk.
Disks    c         Copy file or tagged list.
Zip      z         Make an archive.
Pen      e         Edit the text file.
Archive  ALT+u     Unarchive a ZIP file.
Dos      o         Send a MS-DOS command.
BBS      b         Switch for the file list or generic description.
Sort     <         Sorting switched on / off.
Windows  F2        Set/Reset double directory windows.
Arrows   >         Exchange current and destination directories.


COMMANDS OF THE FILE MANAGER

HOME           Go to start.
END            Go to end.
PAGE           Display previous/next page.
UP/DOWN ARROW  Select file.
RIGHT ARROW    Enter alternate directory (if displayed).
TAB            Toggles directory.
>              Exchange directories in source and destination windows.
ENTER          On a text file name, display the text.
               On an archive name, display the content.
               On a text file inside an archive, display the text.
               On a sub-directory name, change to.
Left arrow     Return to parent directory or exit archive if inside.
F1             Display help.
F2             Show/Hide second directory.
F10            About the program.

CTRL k         Make a sub-directory and open it.
CTRL t         Display the disk tree.
CTRL v         Unlock file or tagged list.
CTRL x         Clear all tags.

ALT a          File Access menu.
ALT f          Files menu.
ALT i          Tools menu.
ALT k          Disk menu. 
ALT p          Type a path to go.
ALT s          File selection menu.
ALT v          Invert tags: untagged files become tagged and conversely.
ALT x          Quit and return to the starting path.
ALT z          Zip file menu.

A-W            Select a unit.
X              Tag all files (X uppercase).

a              About the program... version number.
b              Display BBS description if a BBS file in the directory.
               Otherwise display generic description (if single window).
c              Copy a file or tagged list.
d              Diskette copy.
e              Edit the file. 
f              Diskette format.  
k              Make a directory.
l              Locate a file in the disk and point out it in the list.
m              Set a file mask.
n              Rename a file or a directory.
               A file may be moved also if a new path is included
               in the new name.  
o              Send a MS-DOS command.
p              Print the file.
q              Quit to the current directory.
r              Run an executable: file with EXE, COM or BAT extension.
               Requires LIST.BAT ran instead CDLIST.EXE
t              Sort.
u              Unzip an archive in the destination directory.
v              Lock a file or tagged list. 
x              Tag/Untag the highlighted filename.
z              Make an archive.


THE ALTERNATE DIRECTORY

 Press F2 to display a second directory. To remove it, press F2 again.
 The  second  directory  is a destination one. When it is displayed, copy of
file and unarchiving are stored in this directory without prompting.
 You may exchange it with the source one, at the ">" keypress.
 
 You may enter in the second window at the TAB or RIGHT ARROW press. In this
window are allowed functions to navigate and to make room.
 Here, you may tag file, lock or unlock list, delete list of file.


THE INPUT LINE EDITOR

Commands of the built-in line editor of the dialog boxes are these:
ESC         Cancel.
ENTER       Keep and execute.
INSERT      Toggles insert/copy mode.
DEL         Delete next character.
BACKSPACE   Delete previous character.
CTRL l      Clear the line.
CTRL e      Clear to end of the line.


SUMMARY AND CHAPTERS

 CD List  allows  to  go  directly  to  a chapter. If titles of chapters are
listed  into  a  summary, click on the proper title and the program jumps to
this  chapter.  The  search of a chapter requires an exact matching but case
sensitivity.
 The  hypertext  flag  must  be  off  otherwise this function is replaced by
hypertext search.


HYPERTEXT

 CD List  allows to associate a thesaurus to a text file. The thesaurus name
is  that  of  the  file  with the "THE" extension. If this file is not found,
CD List uses the currently displayed text file.
 To  make  link  to  a  text,  get definition of a word or get a card from a
keyword, push the "hyp" button and click on a word.
 A card is made in a text file with the "#" symbol followed by the keyword.
 

DIRECTORY LIST MASK

 To  set a mask for files to display, type "m". The default mask is *.* that
is for displaying all files. You may type for example:
   CDLIST.*
   *.doc
 Masks  are  stored  into a scrolling list. To get this list, press the down
arrow or click on the button at right of the input line.


TAGGING

 Using  the mouse, click on the root symbol to enter the tag mode, the mouse
becomes a root symbol, click on filenames to tag them.
 Keyboard commands are these:
 x              Tag the selected highlighted file,
                or untag it if tagged.
 X              Tag all files in the current directory.
 CTRL x         Clear all tags.
 ALT v          Invert tags: untagged files become tagged and conversely.

 When the directory is changed, all tags are cleared.


ZIP ARCHIVES

ZIP Menu

 Commands of the menu are:
- Unzip:       Uncompress an archive.
- Zip:         Make an archive.
- ZIP in EXE:  View content of an auto-extractible archive.
- Normal size: Display the total size of all files in the archive.
- View file_id.diz: Display the standard description file is included. 

Viewing the archive

 Press ENTER to view content of an archive.
 If  paths  are  included  inside  the  archive,  you  may  navigate as in a
directory and its sub-directories.

Unarchiving

 To  unarchive a ZIP file pointed out, press the "u" command or click on the
icon.  You  will be asked for the destination path (if no double directory),
the default one being displayed in the dialog box.
 CD List uses PKUNZIP or program set at the variable in INI:
    Unarchiver = 
 The  unarchiver  must  be  in  the  CD List  directory or callable from any
directory. Or you may also set its path in the INI file.

Reading text inside archive

 CD List may display a file packed inside an archive.
 When  content  of  archive  is  displayed, press ENTER to view a text file.
 Press left arrow or ESC to return to directory list.

Running program inside archive

 Press "r" to run a program inside an archive.
 The  temporary  path  will  not be cleared if you run a program from an
archive, because CD List must exit and leave the program in the temporary
path.
 You must erase it yourself or you may use a virtual disk as temporary path.

Making or updating archive

 This  command requires PKZIP (c) or a compatible program. The name and path
of the archiver may be set in the INI file or accessible by the PATH variable
of MS-DOS (type PATH from command line to view it. Set it in AUTOEXEC.BAT).

 To  make  or  update  an archive, thick a list of files, press "z" and type
the destination path and name of the archive.
 If   no  file  is  tagged  the  whole  content of current directory will be
archived.
 Five options may be thicked:
- Update archive: if the archive already exists, this allow to replace 
  existing files.
- Recurse subdirectories: the content of subdirectories will be archived
  also. No file tagged here.
- Store pathname: names of sub-directories are stored even if empty.
- Span disk: big archive may be stored on several diskettes.
- Wipe disk: diskettes the archive is stored into is previously erased.



DISK FORMAT

 To format a disk, type "f".
 You  may  choose  ever the A or B disk unit, the disk type in the scrolling
list and the format mode:
- Quick: allows unformat, erase only directories and FAT.
- Certify: allows unformat, clear disk and verify sectors.
- Unconditional: does not allows unformat, use that for new disks.


DISK COPY

 Press "d" to open the window.
 Click  on the left button to select the source disk, the left one to select
the target disk.


FILE AND DIRECTORY COPY

 Press  "c" to copy the currently selected file or tagged list to a path the
program ask to enter.
 To copy a directory and sub-directories, use this command also.

 TIP 1:
 Tag  a  single  file  to  copy  it.  The program will verify that the
destination  is  a  directory  and  ask  to  create  it if it does not exist.
Otherwise  when you copy a file, if the destination directory does not exist,
MS-DOS  rename the file to the name you have typed. Copying a set of file on
a same filename is a non-sense also CD List check for that.

 TIP 2:
 MS-DOS 5 does not create sub-directory if a file has the same name.
 You may break that by typing a path before the name.
 For  example,  the  directory  "myname"  will  not  be  created if the file
"myname" exists, but if you type "c:myname", it does!


DIR AND DISK COMMANDS

 Lot of directory and disk commands are available from the menu bar.
 To  delete  a file, a tagged list or a directory and sub-directories, press
the DELETE key. You are prompted to delete the entry.

 The DOS window also allows to send more commands.


DIRECT DOS COMMAND

 Press  "o"  to  send  an MS-DOS command.

 There are three input lines in the window:
- command and options filed,
-  source  field,  that  already  holds  the  file  selected  in  the source
directoy ou the tagged list the command will apply to,
- the target field.

 You  may  ignore  these  fields  and  type all data on a single line if the
command does not use the standard order: command, source, target.

 A scrolling list holds some examples of commands to fill the fields.
 This list is kept from the CDLIST.INI file and must be made by the user.


EDIT

 To edit a text, type "e", and the editor will be loaded. The default editor
is  Teknow  (TE.EXE)  that  edits  text on a graphical screen. You may set a
editor in the CDLIST.INI file, at "EditPath =".


LAUNCHING A PROGRAM

 From  the  directory  list,  type  "r"  to launch a program with EXE or COM
extension 
 If you have ran CDLIST.EXE rather than LIST.BAT, this command only returns
to DOS.


DESCRIPTIONS OF FILES

 The  program  display either specific description found in the directory or
generic descriptions.
 The  specific  descriptions  are read from FILES.BBS (JCSM) or 00.INDEX.TXT
(SIMTEL)  files  if they are found in the current directory. These files are
in CD-ROM directories.
 The  generic  ones are 40 characters long description of files according to
their extension. These descriptions are stored into CDLIST.INI.
 You  may  change  the  descriptions  and  add  to up to 64. The format of a
description line is 3 characters for the extension (lowercases), a space and
up to 40 characters for the text to display.


CDLIST.INI

 This configuration file may be edited with any text editor.
 
[Setup] section:
 Color codes are these:
 0   Black         1   Blue           2 Green          3 Cyan 
 4   Red           5   Magenta        6 Brown          7 Light gray
 8   Dark gray     9   Light blue    10 Light green   11 Light cyan
12   Light red    13   Light magenta 14 Yellow        15 White

*** WARNING ***
 Don't use a root directory as C:\ for temporary directory in
  TempPath=
 Use only a dir that holds unused files, because CD-List may replace
files inside the temporary path with no prompt.
 The default value is C:\TEMP and may be replaced with any path holding
only temprorary files.

[Commands]
 The symbol ">" must to be in front of each line of memory.
 A  line  holds  a title, followed by "=", and then one or two codes and the
MS-DOS command.
 The "C" code, is for clearing the DESTINATION field.
 A second "C" if for clearing the SOURCE field.
 Up  to  16 commands are allowed, with up to 40 characters long for both the
title and the MS-DOS command.



* Copyright notice *
MS-DOS, Windows, are trademarks of Microsoft Inc.
PKZIP, PKUNZIP, are trademarks of PKware Inc.
Teknow is another nice software of mine.
