aCupOfCoffee 1.0 ----------------- aCupOfCoffee is a Java Interface Builder palette for the NEXTSTEP InterfaceBuilder. You can build Applets, Frames, Panels, Dialogs, Windows. aCupOfCoffee supports all standard AWT Component subclasses (Buttons, TextFields, TextAreas, Scrollbars, Checkboxes and CheckboxGroups, Lists, Labels, Choices). From the edited interface, a Java class is generated. You can use this class as is, together with other classes, or you can subclass it to add your custom functionality. Please don't edit the generated code, it is maintained by aCupOfCoffees coffeemaker. Also, aCupOfCoffee supports the interaction between the user interface and your application objects. It generates variables that allow you to access the interface objects. Also it generates an event handler for you, that will call your application object methods in response to user actions. See at the end of this file for copyright and usage restrictions. How to use aCupOfCoffee ----------------------- First you need NEXTSTEP 3.2 or 3.3 User + Developer to run aCupOfCoffee. After unarchiving the delivery (...tar.gz) file with Opener.app, you double-click aCupOfCoffee.palette. It opens in InterfaceBuilder. Create a new empty document with Command-Shift-N. Drag the coffeemaker from the palette and drop it into the document window in the lower left corner of the screen. Then drag a Container from the palette to somewhere in the middle of the screen. You get a large container window. Drag and drop components from the palette to the container. Select the components in the container and open the Inspector Panel (Command-1). Here you can change the component attributes. To change texts of components, double-click them in the container window, then edit them. To generate Java code, select the coffeemaker in the document window, customize it in the Inspector Panel (Command-1), then press "Make Java". With Command-s you can save your InterfaceBuilder document for later use. That's it, basically. If you are a bit familiar with NeXTs, InterfaceBuilder, you should feel comfortable enough with aCupOfCoffee until a manual is written :-) Here are, finally, some Not-To-Do's: Please don't use more than one container per nib file. Coffemaker would be rather confused. Please don't intermix Java objects with NEXTSTEP objects for the same reason. Also don't try to arrange Java objects into arrays with Alt-Dragging, this won't work (except CheckboxGroups, where you change the number of rows and columns by Alt-Dragging the knobs). Platforms --------- aCupOfCoffee runs with NEXTSTEP Developer 3.2 or 3.3 on all architectures (Motorola, Intel, Sun, HP). The output has been tested with the Java Development Kit from Sun on solaris 2.5 and Windows95 as well as with Netscape 2.0 on HP-UX. Limitations ------------ The current version of Sun's AWT is not yet in a good portable state. Both the solaris and Win95 versions have bugs and inconsistencies. Also, you get different layouts from the same java program, i.e. the AWT is not yet portable enough. aCupOfCoffee works around some of the bugs in the Win95 versions of List and Choice positioning and resizing. Textfields that work OK under aCupOfCoffee and Win95, may show only a part of the text under solaris. Making these Textfields larger helps on solaris, but looks very ugly under Win95, so I didn't do that. Setting of background and foreground colors is not yet supported. License -------- Permission to use, copy, modify and distribute this software and its documentation for non-commercial purposes, is hereby granted without fee, provided that this license information and copyright notice appear in all copies. "Commercial purposes" is defined within the scope of this license as the generation of monetary revenue from the use or redistribution of the software, beit by itself or "bundled" with or incorporated into any other product. Also generation of reveny by the use or redistribution of other software generated by this software is considered a "commercial purpose". No Warranty: This software is provided "as is" without warranty of any kind, either expressed or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. No Liability For Consequential Damages: In no event shall the author or melonSoft Ralf Suckow Berlin be liable for any damages, including any lost profits, lost savings or other incidental or consequential damages arising out of the use or inability to use this software, even if the author or melonSoft Ralf Suckow Berlin has been advised of the possibility of such damages. Please ask suckow@contrib.de about the conditions for commercial use. Pricing ------- aCupOfCoffee is free for any non-commercial purposes. Please see above for more detailed explanation of the term commercial purposes. Any commercial use, direct or indirect, is not free. Please ask suckow@contrib.de for the price of a license for commercial use of aCupOfCoffee. For Information and Bug Reports -------------------------------- Any help to improve aCupOfCoffee and reporting bugs (suckow@contrib.de) is highly appreciated. Especially useful are proposals for more flexible or powerful java code, since it's not difficult to adapt aCupOfCoffee to generate what you want. melonSoft Ralf Suckow Berlin e-mail: suckow@contrib.de Koenigswinterstrasse 12 fax: (+4930) 5030 595 10318 Berlin, Germany (!! Address and Fax# changed !!) Copyright --------- This description as well as the software it describes is Copyright (1996) by melonSoft Ralf Suckow, Berlin. All Rights Reserved. -------------------------------------------------------------------------- Java and solaris are trademarks or registered trademark of Sun Microsystems, Inc. NEXTSTEP is a trademark of NeXT Computer, Inc. aCupOfCoffee is a trademark of melonSoft Ralf Suckow Berlin. Netscape is a trademark or registered trademark of Netscape Communications Inc. All other trademarks belong to their respective owners.
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.
