home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Frameworks / MADE 1.0.1 / About MADE Essentials next >
Encoding:
Text File  |  1997-06-04  |  6.4 KB  |  141 lines  |  [TEXT/CWIE]
  1. // MADE - Macintosh Application Development Essentials
  2. // ---------------------------------------------------
  3.  
  4. // (c) Gideon Greenspan, Sig Software - June 1997 - http://www.kagi.com/gdg/
  5.  
  6. // These files can only be used for experimental standalone purposes. To obtain
  7. // fully commented code, and licenses for standalone, shareware, internal and
  8. // commercial usage, run the enclosed Register application.
  9.  
  10. What is Macintosh Application Development Essentials?
  11. -----------------------------------------------------
  12.  
  13. MADE is a tiny package of C/C++ code which provides all the lowest-level
  14. needs for a Macintosh application. It is designed for people who are
  15. learning, or know how to program Macs, but don't have the time, energy or
  16. desire to write basic menu, event, memory and error handling routines.
  17.  
  18. MADE doesn't include any pane, window, dialog, file, networking, graphics,
  19. printing, clipboard, text, control, list or other routines. There are several
  20. reasons for this:
  21.  
  22. * Every application needs a different subset, and MADE is for all applications.
  23. * A programmer will want to handle these in the best way for their project.
  24. * Adding in such functionality would negate the benefits of the MADE package.
  25.  
  26. As a result, MADE is extremely small, fast to compile, and easy to understand.
  27.  
  28.  
  29. How will Macintosh Application Development Essentials help my project?
  30. ----------------------------------------------------------------------
  31.  
  32. Despite its small size, MADE includes several features specifically
  33. designed to help the development process; allowing potential crashes to be
  34. caught before testing, and various methods to turn intermittent errors
  35. into ones that happen every time (perhaps you think that's a bad idea!)
  36.  
  37. These are :
  38.  
  39. * Support for Assertions - checks that get removed in final builds.
  40. * Memory trashing so code that accesses uninitialised memory always fails.
  41. * Memory block moving so code that just 'hopes' memory won't move always fails.
  42.  
  43. These features are based on a book by Steve Maguire, published by Microsoft
  44. Press, entitled "Writing Solid Code - Microsoft's Techniques for Developing
  45. Bug-Free C Programs". It's an excellent reference, even if the title is a
  46. contradiction in terms!
  47.  
  48. All of the above options are switchable in the Essential Settings.h file.
  49.  
  50.  
  51. What other features does Macintosh Application Development Essentials have?
  52. ---------------------------------------------------------------------------
  53.  
  54. The other two areas in which MADE helps are AppleEvents and the Drag
  55. Manager. Despite the fact that some projects won't need these, they can be
  56. tricky to implement so I've put them in as switchable options.
  57.  
  58. You'll still have to decide what to do with an Open, Print or Quit AppleEvent,
  59. or a received drag, but at least you've got a starting point.
  60.  
  61.  
  62. How do I get started using Macintosh Application Development Essentials?
  63. ------------------------------------------------------------------------
  64.  
  65. If you add the resource and six source files to a Mac 680x0 or PowerPC
  66. project, you'll have a compilable and runnable application, containing
  67. just 3K of 680x0 code, 5K of PowerPC code, and 2K of resources under
  68. CodeWarrior. You won't notice the overhead, and you'd need it all anyway.
  69.  
  70. Now it's worth looking at the following files : 
  71.  
  72. * Essential Settings.h - set up how much of MADE you want to use.
  73. * Essential Headers.h - see which routines are provided for your use.
  74. * Essential Prototypes.h - see which functions you need to write.
  75.  
  76. The file User Functions.c contains some silly routines to complete an
  77. application's functionality - this is where you start working. You can also
  78. edit the other files, although this might make it harder to upgrade MADE.
  79.  
  80.  
  81. How does licensing for Macintosh Application Development Essentials work?
  82. -------------------------------------------------------------------------
  83.  
  84. Macintosh Application Development Essentials is shareware.
  85.  
  86. These files can only be used for experimental standalone purposes. To obtain
  87. fully commented code, and licenses for standalone, shareware, internal and
  88. commercial usage, you must register by sending payment.
  89.  
  90. Payment is carried out either with the enclosed Register MADE program, or using
  91. a page on the World Wide Web. Payment may be made by cash, cheque, VISA,
  92. MasterCard, American Express or First Virtual.
  93.  
  94. To purchase a registration on the World Wide Web :
  95. * Go to http://order.kagi.com/?BX
  96. * Wait for the Web browser to load up the page.
  97. * Enter name, address and eMail details into the fields provided.
  98. * Follow the rest of the instructions on the Web page.
  99.  
  100. To purchase a registration using the register program :
  101. * Run the enclosed Register MADE application.
  102. * Enter name, address and eMail details into the fields provided.
  103. * Specify how many licenses of which type for Email Merge are required.
  104. * Enter payment details in the area provided.
  105. * Save, copy or print out the information, and forward to Kagi for processing.
  106.  
  107. Email the registration purchase by copying the details to an eMail message
  108. (click Copy), and send to sales@kagi.com. Alternatively, print or save the
  109. details, and fax to (US) 510 652-6589, or post to : Kagi, 1442-A Walnut Street
  110. #392-BX, Berkeley, California, 94709-1405, USA. Please be patient, as eMailed
  111. registrations may take up to 3 days for processing, and faxes and postal mail
  112. may take up to 8 days.
  113.  
  114.  $20 for fully commented code and a standalone license
  115.  $50 for fully commented code and a license to use in shareware
  116. $100 for fully commented code and a license to use in internal software
  117. $250 for fully commented code and a license to use in commercial software
  118.  
  119. The commented code has about double the number of comments as this package.
  120.  
  121.  
  122. What has changed since version 1.0.1 of MADE?
  123. ---------------------------------------------
  124.  
  125. Short answer : Very little.
  126. Long answer : The drag tracking handler now resets the GrafPort correctly, and
  127. some macros for initialising allocated memory are now fixed.
  128.  
  129.  
  130. What if I get stuck with Macintosh Application Development Essentials?
  131. ----------------------------------------------------------------------
  132.  
  133. If you've bought a license, I am willing to answer reasonable enquiries. I am
  134. not about to write your next database for you, but I could give you some clues
  135. for implementing features or using parts of the Mac Toolbox. This offer is
  136. completely subject to my own discretion.
  137.  
  138. If you have any bug reports, comments or suggestions, I'd be happy to hear them.
  139.  
  140. (c) Gideon Greenspan, Sig Software - 4th June 1997 - http://www.kagi.com/gdg/
  141.