home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 294.lha / CC_Utils / utils.doc < prev   
Encoding:
Text File  |  1989-10-09  |  11.6 KB  |  325 lines
  1.         UTILITY PROGRAM DOCUMENTATION
  2.  
  3.     Copyright (C) 1989 by Robert W. Albrecht, All Rights Reserved
  4.  
  5. --------------------------------------------------------------------------
  6.              CONTENTS
  7.  
  8. I)    CCLIB.LIBRARY
  9. II)   BITES
  10. III)  EXEC
  11. IV)   IFFCheck
  12. V)    LOC
  13. VI)   NOIBM
  14. VII)  NOW
  15. VIII) NUKELIB
  16. IX)   SETPRI
  17. X)    CREDITS
  18. XI)   LICENSE AND DISCLAIMER
  19.  
  20. ---------------------------------------------------------------------------
  21. I) CCLIB.LIBRARY
  22.  
  23.    All of these utilities use CClib.library which you need to put in your
  24.    LIBS: directory. The reason the programs are so small is that the
  25.    overhead for the C library is all in one place. Here is an example of
  26.    the size of some programs before and after using CClib.library.
  27.  
  28.    Program        Before         After
  29.  
  30.    exec           6592          2300
  31.    noibm          2148          1004  (improved)
  32.    nukelib          1992           928  (improved)
  33.    iffcheck          7872          3720
  34.    bites          6420          5288
  35.  
  36.    Totals         25024         13240   47% Savings
  37.  
  38.    I don't know about you but I need every last bit of disk space on
  39.    my system. The Amiga community should DEMAND that C programmers use this
  40.    library for all their programs, this will eventually save you from
  41.    having to upgrade your system because you are out disk space or RAM.
  42.    You certainly don't need multiple copies of the Aztec and Lattice C
  43.    libraries imbedded in your programs.
  44.  
  45.    The binary version of CClib.library is available in the form of
  46.    USRCCLIB.ZOO found on many BBS's including Compuserve and Codename:
  47.    Lorraine BBS (805-648-7833). If you wish to write PD C programs that
  48.    use CClib.library look for the full version of CClib.library in the
  49.    form of CCLIB.ZOO which contains everything you need to write programs
  50.    for CClib.library. If you are a commercial software developer you will
  51.    need pay the one license fee of $50 to distribute CClib.library with
  52.    your software, however I urge you to get the non-commercial version
  53.    and evaluate it first.
  54.  
  55. ---------------------------------------------------------------------------
  56. II) BITES
  57.  
  58.        Documentation For 'Bites' Version 1.3
  59.          It's smaller, and better.
  60.  
  61.              Introduction
  62.  
  63.    Bites is a program written at the request of "MIKE VDS"
  64.    by Robert W. Albrecht. It is designed to display disk space
  65.    available on all mounted volumes.
  66.  
  67.  
  68.              How to use Bites...
  69.  
  70.    Run the program by double clicking on it's icon or typing:
  71.    'RUN Bites' from the CLI prompt.
  72.  
  73.    Bites needs at least a 2500 byte stack.
  74.  
  75.    A small window will appear in the title bar with the Bites icon at the
  76.    left. When you click on the Bites icon the program terminates. The
  77.    window can be dragged around like any other intuition window. The
  78.    standard 'to back' and 'to front' system gadgets appear at the right of
  79.    the window. There are two other gadgets to the left of the system
  80.    gadgets that control the behaviour of Bites.
  81.  
  82.    When Bites first comes up it will cycle through all of the mounted
  83.    volumes and display the number of bytes available on each volume every
  84.    three seconds. To stop cycling through the volumes click on the 'up and
  85.    down arrow' gadget. The next time you click on the 'up and down arrow'
  86.    gadget the next volume in the list will be displayed. To return to
  87.    cycling mode click on the 'circle arrow' gadget.
  88.  
  89.    The Bites window can be 'iconified' by clicking the right mouse button
  90.    while it's window is active. The window will reduce to a 24x10 Bites
  91.    icon that takes a minimum amount of screen space. To 'un-iconify' the
  92.    Bites window just activate the window by clicking on the icon with the
  93.    left mouse button, then click the right mouse button.
  94.  
  95.    Bites can also be terminated by use of the Amiga DOS Break command.
  96.    First type 'Status' at the CLI and get the Process ID of Bites then type
  97.    'Break <Process ID>'.
  98.  
  99.  
  100.           Enhancements Made for Version 1.1
  101.  
  102.    You can now control the position and size of the Bites window through
  103.    command line switches or icon 'Tool Types'. You may also display free
  104.    'blocks' instead of free bytes.
  105.  
  106.    CLI command line switches:
  107.  
  108.    -l<Left Edge>    Left edge of Bites window in pixels
  109.  
  110.    -t<Top Edge>     Top Edge of Bites window in pixels
  111.  
  112.    -w<Width>        Width of Bites window in pixels
  113.  
  114.    -b            Displays 'blocks' instead of bytes
  115.  
  116.      EXAMPLE: RUN BITES -l0 -t20 -w640 -b
  117.  
  118.    Icon Tool Types:
  119.  
  120.    LEFTEDGE=<Left Edge>  Left Edge of Bites window in pixels
  121.  
  122.    TOPEDGE=<Top Edge>     Top Edge of Bites window in pixels
  123.  
  124.    WIDTH=<Width>     Width of Bites window in pixels
  125.  
  126.    SHOWBLOCKS=ON     Displays 'blocks' instead of bytes
  127.  
  128.      EXAMPLE:
  129.  
  130.      LEFTEDGE=0
  131.      TOPEDGE=20
  132.      WIDTH=640
  133.      SHOWBLOCKS=ON
  134.  
  135.  
  136.            Bug Fixes Made for Version 1.1
  137.  
  138.    There was a bug where if you had an 'ASSIGN' to a disk that was no
  139.    longer in the drive a system requester would come up and not go away.
  140.    This has been fixed. Now when this situation exists the volume name will
  141.    be given and instead of bytes free or blocks free the message 'Not
  142.    Installed' will be displayed. This way you will be clued into assigns
  143.    that are just flopping around.
  144.  
  145.            Bug Fixes made for version 1.2
  146.  
  147.    The command line arguments for width and left-edge and top-edge are now
  148.    checked for correctness. The width has to be greater than 24, and the
  149.    left-edge and top-edge have to be greater than zero.
  150.  
  151.            Enhancements for version 1.3
  152.  
  153.    Bites now uses CClib.library which is a shareable C library. This has
  154.    reduced the size of the executable to 5288 from 6420 bytes. For bites
  155.    version 1.3 to work you MUST have CClib.library installed in your LIBS:
  156.    directory. You can find the binary only version of CClib.library under
  157.    the name USRCCLIB.ZOO on many BSS's.
  158.  
  159. ---------------------------------------------------------------------------
  160. III) EXEC
  161.  
  162.    SYNTAX: Exec
  163.  
  164.    Exec displays a list of the data structures used by the Amiga OS. This
  165.    includes a list of; memory, resources, devices, interrupt handlers,
  166.    libraries, message ports, and tasks.
  167.  
  168. ---------------------------------------------------------------------------
  169. IV) IFFCheck
  170.  
  171.    SYNTAX: IFFCheck <iff file name>
  172.  
  173.    IFFCheck checks the integrity of any IFF file.
  174.  
  175.    A typical listing looks like this:
  176.  
  177. --- Checking file "pic:life/pumpkin"---
  178.  FORM 6194 ILBM
  179. . BMHD 20
  180. . CMAP 96
  181. . CRNG 8
  182. . CRNG 8
  183. . CRNG 8
  184. . CRNG 8
  185. . BODY 5985
  186. --- (IFF_OKAY) A good IFF file.
  187.  
  188. ---------------------------------------------------------------------------
  189. V) LOC
  190.  
  191.    SYNTAX: LOC [-Q] <files1> <files2> ...
  192.  
  193.    The -Q switch turns off the file-by-file listing of files and only
  194.    prints the totals.
  195.  
  196.    The file name arguments can contain the '*' and '?' wild card characters.
  197.  
  198.    Loc counts lines of C code and gives other statistics.
  199.    Here is an example of it's output:
  200.  
  201.    Lines Of C (LOC) by Robert W. Albrecht
  202.  
  203.  
  204.    The file loc.c contains...
  205.    157 lines of code, 20 blank lines, 2387 bytes of code,
  206.    1032 bytes of whitespace, and 479 bytes of comments.
  207.    The average code line has 15 bytes.
  208.    The code content is 61%, 69% without comments.
  209.  
  210. ---------------------------------------------------------------------------
  211. VI) NOIBM
  212.  
  213.    SYNTAX: NoIBM [>outfile] infile
  214.  
  215.    Noibm will strip the carriage returns from a file. Typically text files
  216.    from an IBM PC will have <CR><LF> at the end of each line, where on Amiga
  217.    DOS and UNIX lines are terminated only with <LF>. By default output
  218.    is directed to the console, but you can redirect it to a file.
  219.  
  220. ---------------------------------------------------------------------------
  221. VII) NOW
  222.  
  223.    SYNTAX: now
  224.  
  225.    Now will display the date in a more American fasion. Here is some
  226.    example output:
  227.  
  228.    Saturday October, 07 1989 02:24 AM
  229.  
  230. ---------------------------------------------------------------------------
  231. VIII) NUKELIB
  232.  
  233.    SYNTAX: NukeLib <lib1.library> <lib2.library> ...
  234.  
  235.    NukeLib removes un-needed libraries from memory. For example:
  236.  
  237.    NukeLib CClib.library
  238.  
  239.    removes CClib.library if no programs are using it. This is really
  240.    not necessacary because Amiga OS will attempt to remove libraries
  241.    when it needs the memory. To find out the names of the libraries in
  242.    memory use the exec program.
  243.  
  244. ---------------------------------------------------------------------------
  245. IX) SETPRI
  246.  
  247.    SYNTAX: SetPri
  248.  
  249.    SetPri will allow you set the priority of any task in the system, even
  250.    while it is running. This is very useful for controlling your multi-
  251.    tasking computer. After you type SetPri you will be shown a list of the
  252.    currently running tasks in the system and be asked for the number
  253.    of the task to change the priority of. You can then enter the
  254.    priority of the task.
  255.  
  256. ---------------------------------------------------------------------------
  257. X) CREDITS
  258.            Software and Documentation Written by:
  259.  
  260.               Robert W. Albrecht
  261.               1457 Zion Way
  262.               Ventura CA 93003
  263.  
  264. ---------------------------------------------------------------------------
  265. XI) LICENSE AND DISCLAIMER
  266.  
  267.  
  268.                 LICENSE
  269.  
  270.       Robert W. Albrecht is the exclusive owner of the enclosed Software
  271.       and Documentation. You are granted non-exclusive license to use the
  272.       Software and Documentation, but you are not the owner of them.
  273.      Your right to use the Software and Documentation under this
  274.       agreement is the "License". "You" means the individual or legal
  275.       entity whose agent uploads this software and accepts this Agreement.
  276.       "Software" means the computer program recorded on the floppy-disk or
  277.       other media, any update to them Robert W. Albrecht may later provide
  278.       you, and any back-up copies made. "Documentation" means the user
  279.       manual and other materials packaged with this Software.
  280.  
  281.                 Transfer
  282.  
  283.       You may transfer the license for the use of the Software or
  284.       Documentation to another person without limitation, except that
  285.       no license fee may be charged.
  286.  
  287.               Backup Copies
  288.  
  289.          Make as many copies as you want.
  290.  
  291.                   Term
  292.  
  293.       The license is effective for twenty (20) years from the time you
  294.       upload the software. You may terminate the license at any time.
  295.  
  296.             Robert W. Albrecht's rights.
  297.  
  298.       The Bites Software and Documentation is protected by copyright, trade
  299.       secret and trademark laws. You may not disclose the Software or
  300.       Documentation to others, except as allowed in this license agreement,
  301.       or remove or alter ownership, trademark and copyright notices on
  302.       Documentation. YOU MUST MAKE A GOOD FAITH EFFORT TO PREVENT ANY
  303.       UNAUTHORIZED USE, COPYING, OR DISCLOSURE OF THE SOFTWARE OR
  304.       DOCUMENTATION. THESE OBLIGATIONS WILL SURVIVE ANY TERMINATION OF THE
  305.       LICENSE AGREEMENT.
  306.  
  307.          Disclaimer of other Warranties, and Liabilities.
  308.  
  309.       THERE ARE NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, FOR THE
  310.       SOFTWARE OR DOCUMENTATION, WHICH ARE BOTH LICENSED TO YOU "AS IS".
  311.       ROBERT W. ALBRECHT EXPRESSLY DISCLAIMS ANY WARRANTY AS TO THE
  312.       PERFORMANCE OF THE SOFTWARE, OR DOCUMENTATION. HE ALSO DISCLAIMS ALL
  313.       OTHER WARRANTIES, INCLUDING (WITHOUT LIMITATION) IMPLIED WARRANTIES
  314.       OF MERCANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
  315.       SHALL ANYONE INVOLVED IN THE CREATION, PRODUCTION, OR DISTRIBUTION,
  316.       OF THE SOFTWARE OR DOCUMENTATION BE LIABLE FOR ANY INDIRECT, SPECIAL,
  317.       INCEDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THE
  318.       SOFTWARE OR DOCUMENTATION OR ARISING FROM ANY BREACH OF ANY WARRANTY.
  319.       Some states do not allow the exclusion or limitation of implied
  320.       warranties or liability for incedental or consequential damages so
  321.       the above exclusion and limitation may not apply to you. IN ADDITON
  322.       TO THE ABOVE LIMITATION, OUR LIABILITY TO YOU OR TO ANYONE ELSE FOR
  323.       DAMAGES SHALL NOT EXCEED THE LICENSE FEE PAID BY YOU FOR THE SOFTWARE
  324.       AND DOCUMENTATION (NOTHING).
  325.