home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sosutl12.zip / doc / sostree.man < prev    next >
Text File  |  1993-10-20  |  3KB  |  81 lines
  1. SOS Tree
  2.  
  3. Description
  4.  
  5.     SOS Tree--directory tree drawer for OS/2.
  6.  
  7. Usage
  8.  
  9.     [D:\] sostree [ -adfnqz ] PATH
  10.  
  11.     Options:
  12.  
  13.     -a      Display file attributes in the format "ADHRS"
  14.     -d      Display dates and times too (in current national format).
  15.     -f      Include plain files too in the listing.
  16.     -n      List all directories (or all files and directories with -f
  17.             option) with full path names; do not draw the tree graph.
  18.     -q      Don't display the "Directory tree of ..." header.
  19.     -z      Display file sizes too. This switch is meaningless if -f
  20.             isn't used simultaneously.
  21.  
  22. Note
  23.  
  24.     This program is public domain. Copyrights are there only to show
  25.     who first wrote this program.
  26.  
  27. Note of re-compiling
  28.  
  29.     I have tried to make SOS Tree as easy to be translated to other
  30.     languages as possible, but without the IBM `mkmsgf' utility I'm
  31.     forced to use different methods than the handy `.msg' system
  32.     OS/2 makes possible. However, it should still be easy to make
  33.     other-language versions of the program. From version 1.0a onwards,
  34.     there are several conditional `#include' clauses after the
  35.     standard header files have been included (file `sostree.c', line
  36.     24 fw.):
  37.  
  38.         #if defined(LANG_SUOMI)
  39.         #include "msg_suomi.inc"
  40.         ...
  41.         #else
  42.         #include "msg_english.inc"      /* The default */
  43.         #endif
  44.  
  45.     Currently SOS Tree is translated to four languages. English is the
  46.     default--ie. the one you get with plain `bcc sostree.c'. By setting
  47.     one of the following symbolic constants, you can get a different-
  48.     language version:
  49.  
  50.         SYMBOLIC CONSTANT       LANGUAGE
  51.         ------------------------------------
  52.         LANG_CATALA             Catalan
  53.         LANG_ENGLISH            English
  54.         LANG_ESPANOL            Spanish
  55.         LANG_SUOMI              Finnish
  56.  
  57.     For example, to get the Finnish messages:
  58.  
  59.         [D:\] bcc -DLANG_SUOMI sostree.c
  60.  
  61.     To create a custom message file, examine `msg_english.inc', create
  62.     a similar one with all the English messages translated, and add an
  63.     `#elif' clause to the source code:
  64.  
  65.         #if defined(LANG_SUOMI)
  66.         #include "msg_suomi.h"
  67.         #elif defined(LANG_ESPERANTO)
  68.         #include "msg_esperanto.h"
  69.         ...
  70.         #else
  71.         #include "msg_english.h"
  72.         #endif
  73.  
  74.     Please keep English as the default language (ie. the last one in
  75.     the list). And PLEASE send your translation to me, so that I can
  76.     make it an `official' part of the next version of SOS Tree.
  77.  
  78. Version
  79.  
  80.     SOS Tree v1.0a (C) SuperOscar Softwares, 1993.
  81.