home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / mjutils-1.0.lha / MJUtils / MJUtils.doc < prev    next >
Text File  |  1993-12-21  |  10KB  |  287 lines
  1.  
  2.                               The Utility Pack #1
  3.  
  4.                (c) 1991-1993 Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9.   Preface
  10.   =======
  11.  
  12.    This is a package of small utilities developed by me during last three years.
  13. All of them work with Kickstart 1.2 or higher and require arp.library.
  14.  
  15.    All  the  utilities  in  this  package are Copyright (c) Martin Mares, MJSoft
  16. System Software, Prague, Czech Republic.
  17.  
  18.    This  archive  can  be  freely redistributed, as long as all of its files are
  19. included   in   their   original   form  without  any  additions,  deletions  or
  20. modifications,  and  no more than a nominal fee is charged for its distribution.
  21. All  copyright notices in the programs and accompanying documentation files must
  22. remain  on  their  places.  Also '.displayme' and other similar files may not be
  23. added.  This is generally known as FREEWARE.
  24.  
  25.    Special  permission  is  given to Fred Fish to distribute this program on his
  26. "Fish Disks".
  27.  
  28.    This  software  is  provided  "AS  IS"  without  warranty of any kind, either
  29. expressed  or  implied.   The author is not responsible for any damage caused by
  30. it.
  31.  
  32.    Send your comments and bug reports to mjsoft@k332.feld.cvut.cz.
  33.  
  34.  
  35. ===================================== AFD ======================================
  36.  
  37.    Syntax: AFD <file>
  38.  
  39.    AFD is an acronym from 'ASCII File Dumper'. It shows you a dump of a file
  40. which contains dots on places of unprintable characters (only characters with
  41. code $20 to $7F are considered to be printable).
  42.  
  43.    For example: AFD AFD will display: (only start of the dump is shown here)
  44.  
  45. ó.......................~...........~H...C..S,x..N..h#....|fhP.C..K,x..N..hJ.g",@
  46. N...".$<...P&<....N..."N,x..N..bp.NuYou need arp.library.!.dos.library.Bad args.
  47. ....L...C..HE.....G..g,y...|N...J.k.f.C...N...p.`.a..NB.,y...|N.................
  48.  
  49. ===================================== Stat =====================================
  50.  
  51.    Syntax: Stat <command> <arguments> [NIL] [NOROM]
  52.  
  53.    Options:    NIL - suppress console output of the command
  54.              NOROM - exclude memory allocations called from the ROM
  55.  
  56.    Warning: if there's more than one argument, the argument string must be
  57.             enclosed in quotes.
  58.  
  59.    Stat runs specified command with given arguments and monitors its activity.
  60. It measures the time of execution and memory requirements.  The time includes
  61. loading of the program.  The memory statistics include ONLY memory allocated by
  62. the program - if your program allocates some memory and other process frees it,
  63. Stat will report that your program leaves some memory allocated, therefore
  64. the "memory left" characteristic is only true for simple programs which don't
  65. communicate with others.
  66.  
  67.    Example:
  68.  
  69.      <<< Stat list RAM: NIL
  70.      >>> Loading+execution time: 1.101412 s
  71.      >>> Max memory usage: 12380 bytes, 0 bytes left allocated.
  72.  
  73. =================================== MakeCol ====================================
  74.  
  75.    Syntax: MakeCol <from> <to> [W <width>] [H <height>] [SP <spacing>] [T <tab>]
  76.  
  77.    Defauls: W=80 H=60 SP=4 T=8
  78.  
  79.    MakeCol converts a text file to another text file trying to make multiple
  80. columns on one page.  There may be different number of columns on each page.
  81. MakeCol never splits source lines, therefore each column has a width of the
  82. longest line in it.
  83.  
  84.    The H and W parameters specify page size, SP controls number of spaces
  85. inserted between two adjacent columns, T sets tab size.
  86.  
  87. ==================================== Print =====================================
  88.  
  89.    Syntax: Print <file>
  90.  
  91.    Prints a 640x512x1 IFF picture on Epson 9-pin printers.  The printing is done
  92. in special mode with equal density of dots in both (vertical and horizontal)
  93. directions.
  94.  
  95. ===================================== PW2 ======================================
  96.  
  97.    Syntax: PW2 <exponent>
  98.  
  99.    Calculates the value of 2^<exponent> for natural exponents less than 187220.
  100. This program tries to do it as quickly as it's possible. (It is also an example
  101. of less typical benchmark program.)
  102.  
  103. ================================== TwoMouses ===================================
  104.  
  105.    This small utility (its size is exactly 512 bytes) allows to control your
  106. mouse pointer with two mice (the second one is connected to the second game
  107. port). It's useful for playing of games controlled by two users (e.g.
  108. Exploding Atoms).
  109.  
  110.    May be started from the WorkBench if you make an icon for it.
  111.  
  112.    Known bugs: eats a lot of CPU time when you use the second mouse.
  113.  
  114.    TwoMouses can be distributed without any restrictions (it may be included in
  115. any kind of software package including commercial one).
  116.  
  117. ================================== WordCount ===================================
  118.  
  119. Syntax: WordCount <file>
  120.  
  121.    Counts frequencies of all words in the file. The words are sorted by their
  122. decreasing frequency (the most frequent word is placed on the first line of output).
  123. All non-empty sequences of letters are considered to be a word.
  124.  
  125. ================================== ExpMemPri ===================================
  126.  
  127.    Syntax: ExpMemPri (0|1)
  128.  
  129.    ExpMemPri controls priority of your expansion memory. It is useful on systems
  130. with small amount of 32-bit RAM if you want to load some program to other
  131. memory regions and leave the expansion RAM free for later use.
  132.  
  133.    ExpMemPri 0   sets the priority to -20 (lower than priority of all standard
  134.                  memory regions)
  135.  
  136.    ExpMemPri 1   sets the priority to 10 (original value)
  137.  
  138.    ExpMemPri doesn't require arp.library.
  139.  
  140. ===================================== Cut ======================================
  141.  
  142.    Syntax: Cut <from> <to> <bytesize>
  143.  
  144.    Cut is a small utility for file chopping. Its purpose is to chop a large file
  145. to many small ones which are not larger than specified size.
  146.  
  147.    The names of destination files are <to>.<n>  (n is number of the fragment).
  148.  
  149. =================================== FastCmp ====================================
  150.  
  151.    Syntax: FastCmp <file1> <file2>
  152.  
  153.    FastCmp performs a byte-to-byte comparison of two files. There are two
  154. differences between FastCmp and standard Cmp: FastCmp doesn't support wildcards
  155. and loads both files to the memory -> FastCmp is significantly faster.
  156.  
  157. ==================================== FType =====================================
  158.  
  159.    Syntax: FType <file> [MINLEN <length>]
  160.  
  161.    Prints all strings composed of printable characters (see AFD) of length
  162. greater or equal to given threshold (default is 5).  I use it very frequently
  163. when I search for messages in any kind of binary file.
  164.  
  165.    Example:
  166.  
  167.    <<< FType AFD
  168.    >>> g",@N
  169.    >>> NuYou need arp.library
  170.    >>> dos.library
  171.    >>> Bad args
  172.    >>> May be used for file dumping in ASCII...
  173.    >>> FILE/A
  174.    >>> lpR,y
  175.    >>> NuS@ y
  176.    >>> Unable to open source file!
  177.    >>> Insufficient memory for buffer!
  178.    >>> <EOF>
  179.  
  180. ==================================== LFilt =====================================
  181.  
  182.    Syntax: LFilt [NOT] [FIRST]
  183.  
  184.    LFilt is a filter (it means that it communicates only through its standard
  185. input and standard output streams).  Its main task is to process text files and
  186. do something with consecutive identical lines (the comparison of lines is not
  187. case-sensitive).
  188.  
  189.    Standard operation: only first line of the block of identical ones is
  190. copied, the other ones are ignored.
  191.  
  192.    FIRST option set: only non-duplicated lines are copied.
  193.  
  194.    NOT option set: inverse operation (the lines which would be normally copied
  195. are ignored, the other lines are ignored).
  196.  
  197.    Example:
  198.  
  199.        source file contains:
  200. aaa
  201. aaa
  202. aaa
  203. bbb
  204. ccc
  205. CCC
  206. aaa
  207. aaa
  208. bbb
  209.  
  210.        after LFilt:
  211.  
  212. aaa
  213. bbb
  214. ccc
  215. aaa
  216. bbb
  217.  
  218.        after LFilt NOT:
  219.  
  220. aaa
  221. aaa
  222. ccc
  223. aaa
  224.  
  225.        after LFilt FIRST:
  226.  
  227. bbb
  228. bbb
  229.  
  230.        after LFilt FIRST NOT:
  231.  
  232. aaa
  233. aaa
  234. aaa
  235. ccc
  236. ccc
  237. aaa
  238. aaa
  239.  
  240. ================================== Requester ===================================
  241.  
  242.    Syntax: Requester [ON | OFF]
  243.  
  244.    Turns ON or OFF displaying of system requesters ("Please insert volume
  245. <xxx> in any drive", "Volume Empty is full" etc.). This setting affects only
  246. the shell it has been ran from.
  247.  
  248.    When no parameters are specified, the current status of system requester
  249. switch is displaye