home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / misc / kramden2.lzh / KRAMDEN.DOC < prev    next >
Text File  |  1990-01-19  |  11KB  |  318 lines
  1. Kramden Utilities
  2. =================
  3.  
  4. v2.0 - 10-Sep-89
  5.  
  6. This is the latest installment of the Kramden Utilities.  The original
  7. release of these tools were inspired (if not directly ripped off) from a
  8. certain set of hitherto unnamed MS-DOS utilities that have been known to
  9. be real _life_savers_.    This new release contains utilities that are
  10. more of a departure from the original plan (i.e. to release a set of
  11. tools similar to the MS-DOS tools) since they have no counterpart in the
  12. MS-DOS world.
  13.  
  14. New for this version:
  15.     . new utilities
  16.     . Clk        - yet another title bar clock (based on Mike Meyer's
  17.               mclk)
  18.     . Meter     - yet another memory meter (sort of based on GfxMem)
  19.     . SetCon    - allows you to modify a shell window's size,
  20.               position, and font.
  21.     . Stat        - a system status utility that lists tasks, fonts,
  22.               libraries, devices, resources, etc.
  23.  
  24.     . propaz.font - a proportional version of topaz.
  25.  
  26.     . revisions to original Kramden utilities
  27.     . FF - new display modes
  28.     . SI - new information and format
  29.  
  30.     . the correct spelling of Kramden (used to be Cramden) thanks to TV
  31.       Guide
  32.  
  33. All of the utilities use Arp release 3 (v39 of arp.library must be in
  34. your LIBS: directory).    If you don't have Arp release 3 you can probably
  35. get it from wherever you got this file.
  36.  
  37.  
  38. Utilities
  39. =========
  40.  
  41. Clk - Title Bar Clock
  42. ---------------------
  43.  
  44. This program displays a clock in a window in the Workbench title bar
  45. just to the left of the screen depth gadgets.  It bases its position on
  46. the actual size of the Workbench screen (for MoreRows users).
  47.  
  48.     syntax:
  49.     Clk
  50.  
  51. This program is based on Mike Meyer's mclk program.  It now
  52. self-detaches and displays only date and time (memory display was
  53. removed).
  54.  
  55.  
  56. FF - Find Files
  57. ---------------
  58.  
  59. This utility is used to find files with a particular file name or pattern
  60. in any directory on a disk.
  61.  
  62.     syntax:
  63.     ff <filespec>... [Short|Quick]
  64.  
  65.     <filespec> - any AmigaDOS (Arp actually) wild card pattern
  66.     Short       - lists files like "Dir all"
  67.     Quick       - makes a listings suitable for using with "Zoo aI"
  68.  
  69.     examples:
  70.     ff
  71.     ff *.c
  72.     ff sys:*.info
  73.     ff include:#?.(h|i) *.[hi] quick
  74.     ff quick | zoo aI ram:foo
  75.  
  76. Example 1 lists all the files starting at the current directory and
  77. proceeding through all subdirectories.    Example 2 lists all files that
  78. are suffixed by .c (like a.c, ff.c, etc) in the current directory and
  79. all subdirectories.  Example 3 finds all icon files on the volume named
  80. "sys:".  Example 4 lists all files suffixed .h or .i on include: and in
  81. the current directory and all subdirectories respectively.  This example
  82. also shows a couple of Arp synonyms for AmigaDOS wild cards.  Example 5
  83. shows how to collect the contents of the current directory and all subs
  84. into ram:foo.zoo.  This example requires using a shell that supports
  85. piping (like the Arp ASH).
  86.  
  87. NOTE:  Real sorry about the name conflict between this and Charlie
  88. Heath's FastFonts utility (now found on Workbench v1.3 disks).  I don't
  89. plan to change this since chances are you'll run this more frequently
  90. than FastFonts.  I therefore recommend that you rename the FastFonts
  91. "FF" to "FastFonts" (and fix your startup-sequence) prior to installing
  92. the Kramden FF in your command directory.
  93.  
  94.  
  95. Meter - Memory Meter
  96. --------------------
  97.  
  98. This memory meter displays a bar graph in a window in the upper left
  99. corner of the Workbench screen.
  100.  
  101.     syntax:
  102.     Meter
  103.  
  104. This program self-detaches.  If propaz.font/8 is in the current FONTS:
  105. directory, Meter will use it.  Otherwise topaz.font/8 is used.
  106.  
  107. This program is sort of based on GfxMem but vastly improved (at least
  108. from the code standpoint).
  109.  
  110.  
  111. SetCon - Set Console
  112. --------------------
  113.  
  114. This program allows the user to sets the dimensions and font used by a
  115. shell console window.
  116.  
  117.     syntax:
  118.     SetCon [left top width height] [Relative]
  119.            [Font name/size] [Report]
  120.  
  121.     left, top, width, height
  122.             - New dimensions for the console window.
  123.     Relative    - Indicates that dimensions specified are
  124.               relative to the current window dimensions.
  125.     Font name/size    - Permits a new font to be used within the
  126.               console window (topaz.font/11 for example).
  127.     Report        - Forces displaying the current console
  128.               settings.  When no other arguments are
  129.               present, this happens by default.
  130.  
  131.     examples:
  132.     SetCon        - reports the current shell console settings
  133.  
  134.     SetCon 0 20 328 80
  135.             - makes the shell console window a small window
  136.               in the upper left corner of the screen.
  137.  
  138.     SetCon font topaz/11
  139.             - sets the current shell font to topaz.font/11.
  140.  
  141. The font management is sort of a kludge.  The font opened by SetCon will
  142. never be closed (use "Stat fonts" to see open count).  If you place a
  143. SetCon command in your shell-startup file that always use the same font,
  144. this shortcoming won't cause much trouble since only one instance of the
  145. font will reside in memory.
  146.  
  147.  
  148. SI - System Info
  149. ----------------
  150.  
  151. This can be used to get a quick spec sheet on your Amiga.  It tells you
  152. things like operating system version number, 68xxx chips in your
  153. machine, video mode, memory configuration, and computing performance
  154. index (my favorite).
  155.  
  156.     syntax:
  157.     si
  158.  
  159. The display sizes and pixel aspect ratio are printed X x Y and X:Y
  160. respectively.  The pixel aspect ratio is based on the Dot/Meter values
  161. found in GfxBase and differ between NTSC and PAL machines.  For NTSC
  162. machines this value is 1:1.166 which means that the pixels are just a
  163. little taller than they are wide.
  164.  
  165. The Maximum Display Size horizontal value might look a bit high (I get
  166. 466).  According to the doc's on GfxBase (where this value comes from)
  167. this value has to do with the dot clock and isn't terribly meaningful to
  168. anyone else. This number is in lo-res such that comparing this value to
  169. the normal lo-res screen width of 320 or overscan width of 352 gives an
  170. estimate of the width of the horizontal blank area.  This number changes
  171. to a slightly more reasonable value with 1.4.
  172.  
  173. In the MS-DOS world the computing performance index is often used to
  174. compare PC clones with one another.  The Amiga version of SI contains
  175. two performance index tests.  The first is calculated using integer math
  176. operations which is affected mainly by CPU & memory access speed.  The
  177. second is calculated using floating point math operations and is
  178. therefore affected by all of the above and the presence of a math
  179. coprocessor or periperal chip.    For each test your Amiga is tested
  180. against times for a stock Amiga 1000 (see below for actual benchmark
  181. conditions) and a stock IBM/XT (the Integer test is the very same number
  182. used in MS-DOS circles and is fairly accurate).  Essentially these
  183. numbers tell you how many times the computing power your computer has
  184. over a stock Amiga 1000 and stock IBM/XT.
  185.  
  186. Disclaimers:  The Floating Point test results relative to IBM/XT is an
  187. approximation using similar (but not exact) code on an MS-DOS machine.
  188. The reason that I couldn't duplicate the code is that this test on the
  189. Amiga uses mathieeedoubbas.library which doesn't have any real
  190. counterpart on my MS-DOS machine, so I had to rely on my MS-DOS C
  191. compiler's math library to perform the operations.  I have no way of
  192. checking the relative efficiency in order to cancel it out of the
  193. performance index.
  194.  
  195. Also the integer index is easily fooled by instruction caches such that
  196. it will give a higher than accurate result for processors like a 68020
  197. and 68030.
  198.  
  199. Be aware that the computing performance tests are VERY sensitive to your
  200. current task loading.  This is intentional.  I could have Forbidden around
  201. the timing code section, but this way you can see the effects of task
  202. loading.  If you've got a bunch of other stuff running on your Amiga at the
  203. same time that you run SI, the performance of the task running SI will
  204. probably be lower than if it had the whole machine to itself (depending on
  205. relative task priorities).  In fact, if you run SI in two different CLI's
  206. with the same task priority, the performance index values returned should
  207. be exactly half of the values obtained when only one instance is running.
  208.  
  209. Incidentally, if anyone knows how to detect things like Amiga model
  210. number, or anything else that seems to be missing, please let me know.
  211.  
  212.  
  213. Stat - System Status
  214. --------------------
  215.  
  216. This program reports the contents of a number of system lists.
  217.  
  218.     syntax:
  219.     stat [opts] [Sort|Pri] [CIA] [CLI] [Devs] [Fonts] [Libs]
  220.          [Misc] [Ports] [Res=Resources] [Sem=Semaphores] [Tasks]
  221.  
  222.  
  223.     opts    - a list of single character shorthands for the other
  224.           status keywords (listed below).
  225.  
  226.  
  227.     Sort keywords:
  228.         Sort    - lists are sorted by name.
  229.         Pri     - lists are sorted by priority.
  230.         none    - lists are sorted by address.
  231.  
  232.     List keywords:
  233.  
  234.         key        opt report
  235.         ---        --- ------
  236.         CIA        CIA allocations
  237.         CLI     c  CLI's
  238.         Devs    d  Devices
  239.         Fonts    f  Fonts
  240.         Libs    l  Libraries
  241.         Misc       misc.resource allocation
  242.         Ports    p  Public message ports
  243.         Resources    r  Resources
  244.         Semaphores    s  Semaphores
  245.         Tasks    t  Tasks
  246.  
  247.     examples:
  248.     stat        - displays CLI's
  249.     stat l        - displays currently loaded libraries
  250.     stat t pri  - displays task list sorted by priority
  251.     stat f sort - displays fonts sorted by name
  252.  
  253. Be careful using "stat t" during serial receives.  It is necessary to
  254. turn off interrupts while collecting the task list.  This may cause the
  255. serial.device to miss receiving a byte.  The other status lists are
  256. safe.
  257.  
  258.  
  259. Revision History
  260. ================
  261.  
  262. v2.0  10-Sep-89
  263.     . added other utilities
  264.     . ff
  265.         . added Short and Quick display options
  266.     . si
  267.         . added ECS detection
  268.  
  269. v1.2  8-Sep-88 (internal release)
  270.     . ff
  271.         . File lengths of 0 now appear as Empty
  272.     . si
  273.         . Added MathIEEE.resource detection (thanks to Bill Coldwell of
  274.           Creative Microsystems, Inc for the suggestion and detection
  275.           code)
  276.         . Changed format of report
  277.         . Added memory list priority field
  278.         . Added floating point math benchmark (to show off your 68881
  279.           to your friends)
  280.  
  281. v1.1  (internal release)
  282.     . Corrected spelling of Kramden
  283.  
  284. v1.0  6-May-88
  285.     . Initial release
  286.  
  287.  
  288. Copyright & Distribution Rights
  289. ===============================
  290.  
  291. Copyright 1988 Pregnant Badger Software.  All Rights Reserved.
  292.  
  293. These utilities may be freely distributed without profit.
  294.  
  295. Any contributions (no amount is too small or too large) may be sent to
  296. the following address.
  297.  
  298.  
  299.     Bill Barton
  300.     Pregnant Badger Software
  301.     1111 El Sur Way
  302.     Sacramento, CA    95864
  303.     (916) 487-9472
  304.  
  305.     bix: peabody
  306.     plink: peabody
  307.     delphi: bbarton
  308.  
  309.  
  310. Special thanks to St. Peter, the patron saint of PC's, without whom
  311. these utilities would never have been written.
  312.  
  313. I'm honestly quite amazed with the rate at which the first version of The
  314. Kramden Utilities has propogated since I initially uploaded it to PLink &
  315. BIX.  I've never had one of my files move so far so fast before.  What a
  316. thrill!
  317.  
  318.