home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / AMETHYST / BADNTS.MSS < prev    next >
Text File  |  2000-06-30  |  4KB  |  86 lines
  1. pageheading(left "Notes on AUG Disk # 1 by B. Dobyns")
  2. This disk isn't nearly as full as I had intended it to be, but the
  3. release is occuring now, so that everyone can begin to share the
  4. benefits of the code contained herein. 
  5.  
  6. There should be little trouble getting most of these functions to work
  7. in your Amethyst package, with the exception of Jeffrey Stone's and
  8. Oscar Goldman's Scribble/Crayon hacks. These are strictly for
  9. Scrobble/Crayon 1.0 only and will not work elsewhere.
  10.  
  11. For Mince extenders, most of the Mince source is very liberally
  12. commented, and easy to use. You may have some trouble geting some of
  13. these things going in your Mince, though, if you have not tried any
  14. extenson yet. 
  15.  
  16. I have included SD for two reasons: One, they both work under
  17. CP/M 2.2 (while many older extended directory listers don't). Two, I
  18. am planning on turning one into an overlay for Mince (heh, heh).
  19.  
  20. Don't forget that if you #define LARGE in MINCE.GBL you can get two
  21. more modes 'Save' and 'C'. Neither of these are really 'complete' yet,
  22. but the code for them is scattered about the source files, disabled by
  23. #ifdef LARGE ... and you can be tinkering with them now. 
  24.  
  25. Hereare some notes on how to go about extension:
  26.  
  27. If the extensions that you want on this disk are already
  28. built into a Bindings.C file (recognizable by the presence of
  29. finit1(), finit2(), finit3(), SetModes() and UInit() in the file) then
  30. you merely need to pip the file over to a disk with the rest of the
  31. Mince code on it, and edit MC.SUB or LMC.SUB to reflect the new name
  32. of the bindings source file. Take out the old references to Bindings.C
  33. and put in the new ones (e.g. Demo.C). Submit (L)MC and lean back. You
  34. should get a new Mince shortly. 
  35.  
  36. Note that you can have lines in a submit file that start with a ';'
  37. and these are taken by CP/M (all versions) to be comment lines, and
  38. are printed on the terminal, but ignored. Comment lines in your submit
  39. files can greatly ease the pain of figuring out what the little
  40. nasties do weeks later (especially when you named it with a VERY
  41. arcane name (QQX.SUB)). 
  42.  
  43. If you do not find that the code that you want is already in a
  44. Bindings file, you must do some work. Take your current Bindings.C and
  45. edit it thusly: Take the functions you want and place them at the end
  46. of the file, just before the /* END OF mumble.C */. Place a
  47. modification notice at the head of the file. If this loses you, look
  48. at what I did (in MACBIND.C) for an example of one way to go about
  49. this.  Decide which command names (the letters you type on the
  50. keyboard) you want to go with which command. Look in the file for the
  51. bindings similar to it (all the C- commands are in finit1, all the M-
  52. in finit2, all the C-X in finit3). Near the the beginning of finitX
  53. there will be a number of function declarations. Put the new functions
  54. in after the ones there (e.g. int MMumble();) Put the assignments for
  55. the function names in the body of finitX, preserving the order. Once
  56. again, if this loses you, look at the way I did it.  
  57.  
  58. Once you have modified your bindings, you may find that there is
  59. insufficient space for all of the code to fit before the externals.
  60. You can comment out page mode in the Bindings, and this will give you
  61. some space, but the functions will still be linked in by L2. To insure
  62. that the page mode (or any other) functions you never reference will
  63. NOT be linked in, edit them out of COMMx and into another file. Put
  64. this file after the -l on the L2 command line. I provide a sample of
  65. this, COMM4.C in which I have placed all the page mode functions, and
  66. the MSearch and MRSearch (I wrote new ones). If I include it after the
  67. -l on the L2 line (with appropriately modified COMM(1-3)), when
  68. compiled with the 'factory standard' bindings, I get a 'factory
  69. standard' mince. When compiled with a bindings without references to
  70. these functions, they do not get linked in, and save me space (in
  71. which I can do other things.)
  72.  
  73. I keep all of my .CRL files on a separate disk in B:, and keep a
  74. mince, all the source code, the C compiler, and L2 on another in A:.
  75. This way i have enough space to get things done in. I have provided a
  76. few submit files that i use so that you can see how i have things
  77. organized and how i get new minces built.
  78.  
  79. address{22 September 1981
  80.  
  81. Barry A. Dobyns, Editor, Slave &c.
  82. Amethyst Users Group
  83. P.O. Box 8173
  84. Austin, Texas 78712-8173
  85. (512)441-9466}
  86.