Initial revision

Fork: 0

tundra / tdir

Browse code Initial revision master
0 parent commit 4bc5b03e774f7f36f0de3022ccfed1b574b41fb5 tundra authored on 23 Jun 2001

Patch

Unified Split

Showing 3 changed files

                Ignore Space
               Show notes
              View
            
          
          41 ■■■■■
          tdir-license.txt
        
        
        
          0 → 100644
               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
+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:
+) 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.
+) 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.
+) 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.
+) If duplicated and/or distributed, no fee beyond reasonable
+        duplication charges may be charged for tdir.
+) Any distributed copies of tdir  must include all the
+        originally provided software, documentation, and licensing
+        information.
+) 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

                Ignore Space
               Show notes
              View
            
          
          91 ■■■■■
          tdir.1
        
        
        
          0 → 100644
               .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
+.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

Ignore Space Show notes View tdir.bat 0 → 100644

Show line notes below