home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / diskutil / sosutil / readme.1st < prev    next >
Encoding:
Text File  |  1993-10-20  |  5.7 KB  |  146 lines
  1. ReadMe.1st for SOS utilities 1.2 =====================================
  2.  
  3. Author:         Tommi Nieminen 20-Oct-1993
  4. Internet:       Tommi.Nieminen@uta.fi (preferred)
  5.                 sktoni@kielo.uta.fi
  6. Snail mail:     Tommi Nieminen
  7.                 Pajulankatu 8
  8.                 37150 NOKIA
  9.                 FINLAND
  10.  
  11. This package (sosutl12) should contain the following files:
  12.  
  13.     ReadMe.1st              This file
  14.     License                 GNU General Public License (version 1.0);
  15.                             see `Copyrights' section below
  16.  
  17.     bin\                    Executable files
  18.     sostree.exe             SOS Tree directory tree drawer
  19.     sostree_catala.exe      Catalan SOS Tree
  20.     sostree_espanol.exe     Spanish SOS Tree
  21.     sostree_suomi.exe       Finnish SOS Tree
  22.     chname.cmd              Changes HPFS names to FAT format and vice
  23.                             versa
  24.     extract.cmd             Extract files from / List contents of
  25.                             archives
  26.     filefind.cmd            File finder
  27.     kill.cmd                Kill processes by their PIDs
  28.     ps.cmd                  Process Status simplifier utility
  29.  
  30.     doc\                    Documentation (including manual pages)
  31.     sosutil.inf             Info file for all the programs
  32.     sosutil.texi            Texinfo document file for all the programs
  33.     sostree.man
  34.     chname.man
  35.     extract.man
  36.     filefind.man
  37.     kill.man
  38.     ps.man
  39.  
  40.     src\                    C sources for SOS Tree
  41.     sostree.c
  42.     msg_catalan.inc         Catalan messages by Xavier Caballe
  43.     msg_english.inc         English messages
  44.     msg_espanol.inc         Spanish messages by Xavier Caballe
  45.     msg_suomi.inc           Finnish messages
  46.  
  47. All these programs are public domain.
  48.  
  49. Thanks for Xavier Caballe, who translated SOS Tree messages to
  50. Spanish and Catalan.
  51.  
  52. texi2ipf was used in creating `sosutil.inf' from `sosutil.texi'.
  53. Thanks for Beverly A. Erlebacher and Marcus Groeber, who wrote that
  54. utility! I am also very grateful for the excellent text window cut
  55. and paste utility TWCP by Maurizio Sartori Masar (Masar Software
  56. Ltd).
  57.  
  58. Notes ----------------------------------------------------------------
  59.  
  60. I'd be happy to obtain versions of these programs in different
  61. languages. If you are able to translate the program messages, please
  62. send the modified sources to me so that I can include them in an
  63. update package of SOS Utilities. NOTE: EVEN IF YOU DON'T HAVE ACCESS
  64. TO BORLAND C++ COMPILER you still can translate the messages in the
  65. source files, and then send the sources to me. I'll distribute the
  66. recompiled programs further. Currently available languages are
  67. Catalan, English, Finnish, and Spanish.
  68.  
  69. The Texinfo document file, `sosutil.texi', is formatted for A4 sheets.
  70. If you are using another paper size, remove the command `@afourpaper'
  71. between the `@iftex' and `@end iftex' statements near the beginning
  72. of the document.
  73.  
  74. Bug Notes ------------------------------------------------------------
  75.  
  76. 1. FileFind
  77.  
  78. In SOS Utilities version 1.0, FileFind had a serious bug that caused
  79. strange problems when the script was run (for me, anyway). The buggy
  80. script loads the two RexxUtil functions, SysFileTree() and SysIni with
  81. the following Calls:
  82.  
  83.     Call RxFuncAdd "SysFileTree", "RexxUtil", "SysFileTree"
  84.     Call RxFuncAdd "SysIni", "RexxUtil", "SysFileTree"
  85.  
  86. The latter should of course be:
  87.  
  88.     Call RxFuncAdd "SysIni", "RexxUtil", "SysIni"
  89.  
  90. This seems not to disturb SysFileTree(), but SysIni() may return
  91. strange results...
  92.  
  93. Also, in the previous versions of this `ReadMe.1st' file, FileFind is
  94. for several times referred to as `FindFile' :-)  probably because my
  95. own, personalized version of the program is named `Kussa' (which is a
  96. non-existent but linguistically possible way of saying `where' in
  97. Finnish).
  98.  
  99. 2. ps
  100.  
  101. In `ps.cmd' of SOS Utilities version 1.1--ie. in the REXX script, not
  102. the earlier Perl script--the input filter worked incorrectly. The
  103. script filters out all input lines that (a) do not have exactly eight
  104. `words' (ie. eight blank-separated character strings), (b) do not
  105. begin with a number. The latter condition filters out all header lines
  106. and is necessary, but the trouble was that PSTAT outputs numbers in
  107. hex, and the filtering function only lets through decimals. Later in
  108. the script, however, the values were converted from hexadecimal to
  109. decimal correctly.
  110.  
  111. To be more specific, the following `context matching' line in the
  112. script was incorrect:
  113.  
  114.     If Words(line) == 8 & DataType(Word(line, 1)) == "NUM" Then Do
  115.  
  116. It really should have read:
  117.  
  118.     If Words(line) == 8 & DataType(Word(line, 1), "X") == 1 Then Do
  119.  
  120. SOS Utilities version 1.2 contains the correct version, of course.
  121.  
  122. Copyrights -----------------------------------------------------------
  123.  
  124. SOS Tree v1.0a  directory drawer
  125. ChName v1.1b    change names to/from FAT format
  126. Extract v1.1    archive extractor/lister
  127. FindFile v1.4a  file finder
  128. ps v4.0a        PSTAT output simplifier
  129. Copyright (C) 1993, SuperOscar Softwares, Tommi Nieminen.
  130.  
  131. This program is free software; you can redistribute it and/or modify
  132. it under the terms of the GNU General Public License as published by
  133. the Free Software Foundation; either version 1, or (at your option)
  134. any later version.
  135.  
  136. This program is distributed in the hope that it will be useful, but
  137. WITHOUT ANY WARRANTY; without even the implied warranty of
  138. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  139. General Public License for more details.
  140.  
  141. You should have received a copy of the GNU General Public License
  142. along with this program; if not, write to the Free Software
  143. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  144.  
  145. End of ReadMe.1st ===================================================
  146.