home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / resources / palettes / aCupOfCoffee.1.0.README < prev    next >
Encoding:
Text File  |  1996-02-27  |  5.9 KB  |  151 lines
  1. aCupOfCoffee 1.0
  2. -----------------
  3.  
  4. aCupOfCoffee is a Java Interface Builder palette
  5. for the NEXTSTEP InterfaceBuilder. 
  6.  
  7. You can build Applets, Frames, Panels, Dialogs, Windows.
  8.  
  9. aCupOfCoffee supports all standard AWT Component subclasses (Buttons,
  10. TextFields, TextAreas, Scrollbars, Checkboxes and CheckboxGroups,
  11. Lists, Labels, Choices).
  12.  
  13. From the edited interface, a Java class is generated. You can use
  14. this class as is, together with other classes, or you can subclass
  15. it to add your custom functionality. Please don't edit the generated
  16. code, it is maintained by aCupOfCoffees coffeemaker.
  17.  
  18. Also, aCupOfCoffee supports the interaction between the user interface
  19. and your application objects. It generates variables that allow you
  20. to access the interface objects. Also it generates an event handler for you,
  21. that will call your application object methods in response to user actions.
  22.  
  23. See at the end of this file for copyright and usage restrictions.
  24.  
  25. How to use aCupOfCoffee
  26. -----------------------
  27.  
  28. First you need NEXTSTEP 3.2 or 3.3 User + Developer to run aCupOfCoffee.
  29.  
  30. After unarchiving the delivery (...tar.gz) file with Opener.app,
  31. you double-click aCupOfCoffee.palette. It opens in InterfaceBuilder.
  32.  
  33. Create a new empty document with Command-Shift-N.
  34.  
  35. Drag the coffeemaker from the palette and drop it into the document
  36. window in the lower left corner of the screen. 
  37.  
  38. Then drag a Container from the palette to somewhere in the middle
  39. of the screen. You get a large container window.
  40.  
  41. Drag and drop components from the palette to the container.
  42.  
  43. Select the components in the container and open the
  44. Inspector Panel (Command-1). Here you can change the component
  45. attributes. To change texts of components, double-click
  46. them in the container window, then edit them. 
  47.  
  48. To generate Java code, select the coffeemaker in the document window,
  49. customize it in the Inspector Panel (Command-1), then press "Make Java".
  50.   
  51. With Command-s you can save your InterfaceBuilder 
  52. document for later use.
  53.  
  54. That's it, basically. If you are a bit familiar with NeXTs,
  55. InterfaceBuilder, you should feel comfortable enough with
  56. aCupOfCoffee until a manual is written :-)
  57.   
  58. Here are, finally, some Not-To-Do's:
  59. Please don't use more than one container per nib file. Coffemaker
  60. would be rather confused. Please don't intermix Java objects
  61. with NEXTSTEP objects for the same reason. Also don't try
  62. to arrange Java objects into arrays with Alt-Dragging, this won't
  63. work (except CheckboxGroups, where you change the number
  64. of rows and columns by Alt-Dragging the knobs).
  65.  
  66. Platforms
  67. ---------
  68.  
  69. aCupOfCoffee runs with NEXTSTEP Developer 3.2 or 3.3 on all
  70. architectures (Motorola, Intel, Sun, HP). The output has been
  71. tested with the Java Development Kit from Sun on solaris 2.5 
  72. and Windows95 as well as with Netscape 2.0 on HP-UX.
  73.  
  74. Limitations
  75. ------------
  76.  
  77. The current version of Sun's AWT is not yet in a good portable state.
  78. Both the solaris and Win95 versions have bugs and inconsistencies.
  79. Also, you get different layouts from the same java program, i.e. the
  80. AWT is not yet portable enough. aCupOfCoffee works around some of the
  81. bugs in the Win95 versions of List and Choice positioning and resizing.
  82. Textfields that work OK under aCupOfCoffee and Win95, may show only
  83. a part of the text under solaris. Making these Textfields larger
  84. helps on solaris, but looks very ugly under Win95, so I didn't do that.
  85.  
  86. Setting of background and foreground colors is not yet supported.
  87.  
  88. License
  89. --------
  90.  
  91. Permission to use, copy, modify and distribute this software and its
  92. documentation for non-commercial purposes, is hereby granted without 
  93. fee, provided that this license information and copyright notice appear 
  94. in all copies.
  95.  
  96. "Commercial purposes" is defined within the scope of this license as
  97. the generation of monetary revenue from the use or redistribution 
  98. of the software, beit by itself or "bundled" with or incorporated
  99. into any other product. Also generation of reveny by the use
  100. or redistribution of other software generated by this software
  101. is considered a "commercial purpose".
  102.  
  103. No Warranty: This software is provided "as is" without warranty of
  104. any kind, either expressed or implied, including but not limited to
  105. the implied warranties of merchantability and fitness for a particular
  106. purpose.
  107.  
  108. No Liability For Consequential Damages: In no event shall the author or
  109. melonSoft Ralf Suckow Berlin be liable for any damages, including any
  110. lost profits, lost savings or other incidental or consequential damages
  111. arising out of the use or inability to use this software, even if the author
  112. or melonSoft Ralf Suckow Berlin has been advised of the possibility of such
  113. damages.
  114.  
  115. Please ask suckow@contrib.de about the conditions for commercial use.
  116.  
  117. Pricing
  118. -------
  119.  
  120. aCupOfCoffee is free for any non-commercial purposes. Please see above
  121. for more detailed explanation of the term commercial purposes.
  122.  
  123. Any commercial use, direct or indirect, is not free.
  124. Please ask suckow@contrib.de for the price of a license for
  125. commercial use of aCupOfCoffee.
  126.  
  127. For Information and Bug Reports
  128. --------------------------------
  129.  
  130. Any help to improve aCupOfCoffee and reporting bugs (suckow@contrib.de)
  131. is highly appreciated. Especially useful are proposals for more flexible
  132. or powerful java code, since it's not difficult to adapt aCupOfCoffee
  133. to generate what you want.
  134.  
  135. melonSoft Ralf Suckow Berlin      e-mail: suckow@contrib.de
  136. Koenigswinterstrasse 12           fax: (+4930) 5030 595
  137. 10318 Berlin, Germany             (!! Address and Fax# changed !!)
  138.  
  139. Copyright
  140. ---------
  141.  
  142. This description as well as the software it describes is
  143. Copyright (1996) by melonSoft Ralf Suckow, Berlin. All Rights Reserved.
  144.  
  145. --------------------------------------------------------------------------
  146. Java and solaris are trademarks or registered trademark of Sun Microsystems, Inc. NEXTSTEP is a trademark of NeXT Computer, Inc. aCupOfCoffee is a
  147. trademark of melonSoft Ralf Suckow Berlin. Netscape is a trademark or
  148. registered trademark of Netscape Communications Inc.
  149.  
  150. All other trademarks belong to their respective owners.
  151.