NAME
		geodir.exe

SYNOPSIS
		GEODIR [drive:][\dir\...\][*.*] [/S] [/E] [/D] [/N] [/B[:filename]]

DESCRIPTION
geodir is a program for displaying GeoWorks/GEOS filenames under MS-DOS.
In GeoWorks, filenames can be longer (32 characters max.) than under MS-DOS. This program is useful if you want to give out all filenames of GeoWorks-documents on a printer (using redirection).
Without any parameter or option, geodir displays the contents of your currently active MS-DOS directory. The contents of a directory are automatically sorted, if enough memory is available (64kB segment size limit, sorry!). geodir knows filetypes of GEOS-versions 1.x and 2.0.

Output
geodir displays one filename with additional information per line. All additional information is separated by a vertikal bar |, so you get 4 columns.
In the first column you see the filename in the second the file-size in bytes in the third the date of the last modification and in the last column information about the file-attribrutes and the filetype.
Example (shortened output):
C:\GEOS20\SYSTEM>geodir
Directory of < BLESS >:.\
PREF                   | < DIR > | 12.08.93-11:47 | D
...
GEOS Kernel            |  244958 | 14.06.93-17:42 | A GEOS2.0
...
Text Metafile Converter|   10004 | 14.06.93-17:44 | A GEOS2.0
< 42 File(s),14 Dir(s) (1886918 Bytes) >
< 42 File(s),14 Dir(s) (1886918 Bytes),50008064 (29.5%) Bytes free >

As you see in the example, geodir starts with the volume label  and path-name, and it ends with information about the number of shown files, directories and a summation of the file-sizes, as well as the number of the available bytes on this volume.

In the last column there are the following letters standing for attributes:
 D	directory
 R	read only
 S	system file
 H	hidden file
 A	not archived

geodir recognizes the following GeoWorks file-types:
GeoWrite, GeoDraw, GeoCalc, GeoFile, ScrapBook, GeoDex, GeoPlanner.
If a file is associated with one of these applications, a short form of the application-name is printed in the last column, behind the attributes. If geodir doesn't know about an association, but nevertheless thinks it is a Geos-file it prints GEOS instead and the version number 1.x or 2.x

Special characters like the German Umlaute and letters with accents are translated according to Code-Page 437 or the PC-8 danish/norge character set, so the translation may be incorrect on your Computer.






Parameters
All parameters are optional (i.e. not required). geodir takes as only parameter a (more or less complete) path. The path can consist of a drive specification (drive letter followed by a colon), or a path of directories or a filepattern, which naturally can be a full filename. A full path specification consists of a drive-specification directly followed (i.e. no separating blank) by one or more directories and a filename-pattern (separated by \).

A filepattern consists of letters and/or wildcards * and ?. The wildcard *  represents an arbitrary sequence of any characters or no character, the ? represents any character. 
If the filepattern is missing, *.* is used by default, which represents any file. If a file is recognized as a GeoWorks-file the pattern is not matched against the DOS-name of the file, but against the GeoWorks-filename. The extension is ignored in this case!! Note: Although the extension is ignored for GeoWorks-files, at least the separating dot must be present to signal that this part is a filename and not a directory-name. So if you specify patterns for GeoWorks-files, use always .* at the end of the filename. Pattern-matching is case-independent, which means that the difference between upper and lower case letters are ignored.

Options
Options can occur before or behind the parameter, but each must be separated by blanks.

/?		display short usage info.

/S		display all sub-directories, too. Without option /E , empty
			directories (i.e. that contains no files) are not displayed.

/E		display emtpy subdirectories, too.

/D		display the DOS-name of the file in a second line under the			GeoWorks-filename. This makes it possible to map GeoWorks-			files onto DOS-files.

/N		no sorting of filenames.

/B	special mode for backup. geodir collects all files in the named directory (or actual if none given) which have the archive flag set and displays the names as with option /D . At the same time a file is created which contains the filenames (with full path). This is useful for programs like pkzip, arj, lha, etc. which take "filelists" as their argument. You can specify the filename directly behind the option, separated by a colon (default filename is C:\filelist.tmp.

EXAMPLES
geodir A: >prn:				print directory of drive A:.
geodir C:\GEOS20\DOCUMENT /S		display the full document 									directory including sub-dirs.
geodir C:\GEOWORKS\DOCUMENT\A*.*	display all filenames starting 									with "a" in the document 									directory.
geodir A?B*C*.T*				display all filenames in the 									current directory starting 									with "A", having a "B" as 									third letter and a "C" in any 									following position. For non 									GEOS-files the extension 									must start with a "T".
geodir /D | more				display current directory 									with dosnames, too, pausing 									after a full page.
geodir /?						display usage information.
geodir /B:C\gaga.tmp			like "geodir /D", but only 									collecting files which have 									the archive-flag set and 									creating a filelist with the name 								C:\gaga.tmp

COPYRIGHT
	geodir is copyrighted software.
(C)opyright 1993  by Roland Bless of Blessed Software Products, all rights reserved.
This code contains no GEOS-code.

DISTRIBUTABILITY
geodir is freely distributable, but only if these rules are followed:
You can/should copy it, but only with this documentation included. Distribution of a changed program, source or documentation is forbidden! 
Making profit with it in any form is forbidden, especially including it into commercial packages without my permission. Uploading it on commercial BBSs like Compuserve is explicitly allowed.
If you like this program, feel free to appreciate my work and send a donation in US$ or DM of any amount (suggested $20 or 20DM) to the address under section CONTACT.

LIABILITY
No guarantee for any function of this program is given.
Use it at your own risk! I'm not responsible for any kind of data loss or damage in any form caused by this program.

CONTACT
Send e-mail to:
bless@rpkhp2.mach.uni-karlsruhe.de (Internet site)
or
rob@spirits.ka.sub.org	(private UUCP-site, offline in vacations)

snail-mail:
Roland Bless
Mrsenbroicher Weg 151
D-40470 Dsseldorf
F.R. of Germany

BUGS
Naturally, no non-verified program is bug-free, so there may be some bugs. Especially the wildcard matching algorithm may show some incorrect behaviour.
Because I only had the knowledge about the GEOS file-headers by guessing from hex-dumps, one has to expect some incompatabilities with future versions of GEOS.
Longer dirnames from GEOS2.x aren't displayed, yet.

VERSION
1.5

SEE ALSO
dir, more
