diff --git a/tdir-license.txt b/tdir-license.txt new file mode 100644 index 0000000..9bbfab0 --- /dev/null +++ b/tdir-license.txt @@ -0,0 +1,40 @@ +tdir - Copyright (c) 2001, TundraWare Inc., All Rights Reserved + +Permission is hereby granted for the duplication and use of tdir so +long as ALL the following conditions are met: + + 1) The user of tdir understands and agrees that this is experimental + software which is provided "AS-IS" with no warranties expressed + or implied by TundraWare Inc. + + 2) The user acknowledges tdir has NOT been tested for: + a) Correct operation + b) Freedom from unintended consequences + c) Any operation or condition which might cause damage to + the user's machine, software, network, or data, or which + might cause any breach of system security of the user's + system(s) or any other systems. + + 3) By using tdir, the user does so at their own risk and + agrees to hold TundraWare Inc. harmless for any damage, + direct or indirect, that this software may or does cause to + the user's computational environment, including, but not + limited to, the user's hardware, software, network, or data. + The user further agrees to hold TundraWare Inc. harmless for + any economic damage or any other adverse consequence, direct + or indirect, caused by the use of tdir. + + 4) If duplicated and/or distributed, no fee beyond reasonable + duplication charges may be charged for tdir. + + 5) Any distributed copies of tdir must include all the + originally provided software, documentation, and licensing + information. + + 6) No modification of tdir, its documentation, or its + licensing information is permitted. + +If you do not understand, or cannot abide by any of these conditions, +DO NOT USE tdir. + +To report bugs or suggest improvements, contact: tundra@tundraware.com diff --git a/tdir.1 b/tdir.1 new file mode 100644 index 0000000..b9f6b07 --- /dev/null +++ b/tdir.1 @@ -0,0 +1,90 @@ +.TH tdir 1 TundraWare +.SH NAME +tdir \- Display formatted directory listing +.SH SYNOPSIS: +tdir [-Rhv] [-c\fICol Width\fP] [-s\fISep Character\fP] [-w\fIOutput Width\fP] [dir ...] +.SH DESCRIPTION +tdir displays a formatted listing for the directories you select, +grouping the file names by "extension". If you do not name a +specific directory, it defaults to the current directory. + +For each directory selected, tdir will first display a columnated and +sorted list of subdirectories delimited by square brackets, followed +by a columnated list of files sorted by "extension" which appears on the +left side of the listing delimited by curly braces. + +If either a directory or file name cannot fit in the column width, it will +be truncated so that it does fit. In that case, the last character of +the truncated name will be replaced with a carat (^) to let you know +what happened. + +The output is written to the standard output. + +Normal exits return an exit status of 0. Command line errors or +unreasonable parameters return an exit status of 2. + +.SH OPTIONS +.TP +.B -R +Travel down each directory tree Recursively. Defaults to +no recursion. +.TP +.B -h +Display Help information about tdir. +.TP +.B -v +Display Version information about tdir. +.TP +.B -c # +Set Column With to # characters. (default: 19) +.TP +.B -s c +Set Extension Separator character to c. (default: .) +tdir will search for the rightmost instance of this character +when examining file names. From that position to the end of +the name is considered the "extension" of the file. Everything +before it is considered the "name". +.TP +.B -w # +Set the Output Width to # characters. (default: 80) +.SH COLUMN ARITHMETIC +tdir defines its columnar output based on the total output width and +column width. Both of these can be changed from the command line. +The number of columns is (output-width modulo column- width). The +indentation to the first column is (remainder +output-width/column-width). The width of the text is always one less +than the column width to leave room for a trailing space. +.SH SEPARATOR CHARACTER +tdir sorts and displays file names based on their so-called "extensions". +In most cases, the default of '.' should be fine. However, there may +be times when you want to override the default (with the -s command +line option). Say, for example, you have a bunch of reports ending +in: -001, -002, -003, and so on. In this case, switching the separator +character to '-' will probably give you a more reasonable output +sort order. +.SH OTHER +You must have a reasonably current copy of 'python' installed for tdir +to operate. +.SH BUGS AND MISFEATURES +None known as of this release. tdir is written in 'python' and has +been used on both FreeBSD and Windows 2000 installations. If you are +using something else that supports 'python', give it a whirl. + +tdir is case-sensitive. So, files ending in ".EXE" and ".exe" and +".eXe" will sort into separate groups. This is completely appropriate +for adult operating systems like Unix, but (at the very least) +arguable for systems like Windows where case is preserved but not +observed by the OS. + +Paths are displayed using '/' as the path separator. I can't help it +that Microsoft departed from The One True Way ;)) +.SH COPYRIGHT +tdir is Copyright(c) 2001, TundraWare Inc. +For terms of use, see the tdir-license.txt file in the program distribution. +If you install tdir on a FreeBSD system using the 'ports' mechanism, you will +also find this file in /usr/local/share/doc/tdir. +.SH AUTHOR +.nf +Tim Daneliuk +tundra@tundraware.com + diff --git a/tdir.bat b/tdir.bat new file mode 100644 index 0000000..be4c325 --- /dev/null +++ b/tdir.bat @@ -0,0 +1,4 @@ +@echo off +REM Batch file for WinDoze to invoke tdir +REM python executable must be in PATH +python c:\usr\local\bin\tdir %*