home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / dev / c / mkid.readme < prev    next >
Text File  |  1996-01-05  |  7KB  |  144 lines
  1. Short:  V1.6, a program identifier database package
  2. Author: Greg McGary, Randell Jesup, Olaf Barthel
  3. Type:   dev/c
  4.  
  5.     I got this back in 1987, and have been using it since then.  It
  6. is freely redistributable (see the original writer's copyright message).
  7. My modifications and the 2 routines I added are public domain.  It also
  8. uses Chuck McManis's cooked IO routines.
  9.  
  10.     To compile under amigados, you must use -Dfseek=unixfseek.  This
  11. is because the program assumes fseek will extend the file, which is not
  12. normally true under amigados.
  13.  
  14.     It needs an amigados makefile (badly).  Don't forget to include
  15. amiga.c, amiga_getenv.c, and raw.o.
  16.  
  17.     It could use some of the 2.0 routines (like the pattern-matching
  18. in place of unix RE's, and GetVar() in amiga_getenv.c).  Under 2.0 you
  19. can use one executable and hardlink the others (it keys off the name it
  20. was run under).
  21.  
  22.     It's pretty stable.  Unix-pathing has been replaced with amiga-
  23. pathing (., .., etc).  The amiga-specific changes to the main code are
  24. ifdef AMIGA.
  25.  
  26.     Randell Jesup
  27.  
  28.  
  29.  
  30.     Just about four years later I found this tool on the
  31. Frozen Fish CD-ROM. Neat! But some feature were missing, such as the
  32. regexp support in the lookup utilities and wildcard file name expansion
  33. in mkid. I also found one or the other bug that needed fixing. For
  34. example, if a lookup tool didn't find the ID database in its current
  35. drawer or some parent drawer, it would cause Enforcer hits and change
  36. the calling Shell's current directory without ever restoring it.
  37. Rebuilding the tools using SAS/C was a good idea, the tools are all
  38. pure now and can be made resident. I also threw in some 2.0 additions,
  39. notably the editor launch procedure and the wildcard expansion stuff.
  40. The scanner now handles .i and .asm files and the lookup tools will
  41. output proper AmigaDOS wildcard patterns rather than plain regexp
  42. patterns.
  43.     The distribution preserves Fred's original drawer
  44. structure and adds an SAS/C SMakefile. I removed some of the original
  45. source files which were now obsolete. The binaries in the "bin"
  46. drawer were built for an Amiga running Kickstart 2.04 or higher,
  47. using the ieee math libraries. I haven't tested if they still work on
  48. Kickstart 1.3 and friends, they probably won't.
  49.  
  50.     Olaf Barthel <olsen@sourcery.han.de>, 29 June 1995
  51.  
  52.  
  53.     More, small additions: the C scanner now handles C++ style
  54. comments ("//") and recognizes files with .cpp/.cxx/.c++/.hpp/.hxx/.h++
  55. extensions. There is no specific C++ support in the scanner, but it never
  56. checked for C specific data structures anyway ;) The assembly language
  57. scanner now handles comment lines introduced by "*" or ";". Some file
  58. name and name suffix comparisons were case sensitive, which does not
  59. make that much sense on the Amiga; the comparisons now ignore the file
  60. name case. Speaking of case, the lookup tools sport an "-i" option to
  61. enable case-insensitive pattern comparisons. I changed the makefile
  62. slightly to take advantage of the fact that all tools share the same
  63. basic set of support files which are now bound together in a linker
  64. library. This reduced the tool size once again. The tools now use
  65. utility.library for inline math routines. This means that they will
  66. definitely no longer run under Kickstart 1.3 and below. For the record,
  67. all changes I made and routines I added are public domain.
  68.  
  69.     Olaf Barthel <olsen@sourcery.han.de>, 23 July 1995
  70.  
  71.  
  72.     In an attempt to make the raw/cooked I/O routines more
  73. robust I rewrote raw.c. mkid now uses ffp math routines as it
  74. was using floating point arithmetics only to calculate the final
  75. stats it displays after building the database. This made the program
  76. a little smaller without loss of robustness.
  77.  
  78.     Olaf Barthel <olsen@sourcery.han.de>, 17 September 1995
  79.  
  80.  
  81.     The RCS support was disabled, there probably was no working
  82. Amiga port of it available when Randell killed the code. I rewrote
  83. the relevant routines which appear to be working fine now. The scanners
  84. did not always like end of file conditions, some loops could run
  85. forever. I inserted code to check for EOF where it was obviously missing.
  86.  
  87.     Olaf Barthel <olsen@sourcery.han.de>, 3 December 1995
  88.  
  89.  
  90. ============================= Archive contents =============================
  91.  
  92. Original  Packed Ratio    Date     Time    Name
  93. -------- ------- ----- --------- --------  -------------
  94.     3993    1953 51.0% 03-Dec-95 13:31:56  AMIGA_README
  95.    19608   12304 37.2% 03-Dec-95 13:32:38 +fid
  96.    26772   16571 38.1% 03-Dec-95 13:32:22 +lid
  97.    34400   19408 43.5% 03-Dec-95 13:32:32 +mkid
  98.      651     392 39.7% 01-Feb-91 13:00:36 +cookedio.txt
  99.     4020    1763 56.1% 01-Feb-91 13:00:36 +lid.1
  100.     5319    1899 64.2% 29-Jun-95 20:43:54 +lid.man
  101.     4644    1977 57.4% 01-Feb-91 13:00:42 +mkid.1
  102.     6384    2183 65.8% 29-Jun-95 20:44:04 +mkid.man
  103.     4329    1750 59.5% 17-Sep-95 15:44:28 +amiga.c
  104.      705     320 54.6% 01-Feb-91 13:04:20 +basename.c
  105.      643     348 45.8% 01-Feb-91 13:04:20 +bitcount.c
  106.      992     282 71.5% 01-Feb-91 13:04:50 +bitops.c
  107.      537     214 60.1% 01-Feb-91 13:04:58 +bitops.h
  108.     1614     578 64.1% 01-Feb-91 13:04:54 +bitsvec.c
  109.      128     115 10.1% 01-Feb-91 13:04:54 +bool.h
  110.      692     366 47.1% 01-Feb-91 13:03:48 +bsearch.c
  111.      199     160 19.5% 01-Feb-91 13:04:10 +bzero.c
  112.      188     151 19.6% 01-Feb-91 13:02:28 +document.c
  113.     1281     425 66.8% 29-Jun-95 20:48:26 +extern.h
  114.     2453    1102 55.0% 23-Jul-95 17:07:32 +fid.c
  115.      575     367 36.1% 01-Feb-91 13:04:56 +gets0.c
  116.     6104    1876 69.2% 12-Jul-95 21:16:48 +getscan.c
  117.      418     244 41.6% 01-Feb-91 13:04:42 +getsFF.c
  118.     2203     926 57.9% 01-Feb-91 13:04:08 +hash.c
  119.     1716     797 53.5% 01-Feb-91 13:04:22 +id.h
  120.     1449     680 53.0% 23-Jul-95 17:07:40 +idx.c
  121.     1259     614 51.2% 01-Feb-91 13:04:22 +init.c
  122.    19356    5825 69.9% 17-Sep-95 15:42:14 +lid.c
  123.     3610    1448 59.8% 01-Feb-91 13:04:02 +Makefile.unix
  124.    18724    6052 67.6% 17-Sep-95 15:43:32 +mkid.c
  125.       60      44 26.6% 01-Feb-91 13:04:40 +numtst.c
  126.     4696    1284 72.6% 17-Sep-95 15:53:56 +opensrc.c
  127.       21      21  0.0% 01-Feb-91 13:02:28 +patchlevel.h
  128.     5829    1944 66.6% 08-Jul-95 21:40:36 +paths.c
  129.      225     138 38.6% 01-Feb-91 13:03:46 +radix.h
  130.     1631     895 45.1% 17-Sep-95 15:45:34 +raw.c
  131.     7408    2159 70.8% 03-Dec-95 13:25:54 +scan-asm.c
  132.     8300    2303 72.2% 03-Dec-95 13:26:50 +scan-c.c
  133.     1354     565 58.2% 03-Dec-95 13:31:12 +SMakefile
  134.     1883     682 63.7% 01-Feb-91 13:04:30 +stoi.c
  135.      735     348 52.6% 08-Jul-95 21:40:52 +string.h
  136.      648     353 45.5% 01-Feb-91 13:04:08 +test.c
  137.     1874     644 65.6% 17-Sep-95 14:31:58 +tty.c
  138.      630     358 43.1% 29-Jun-95 20:48:16 +uerror.c
  139.      830     479 42.2% 01-Feb-91 13:04:46 +wmatch.c
  140.      546     335 38.6% 01-Feb-91 13:02:08  todo
  141.    16037    6305 60.6% 01-Feb-91 13:01:14  TUTORIAL
  142. -------- ------- ----- --------- --------
  143.   227673  101947 55.2% 03-Dec-95 16:21:40   48 files
  144.