home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / jbuilder / TRIAL / JBUILDER / JHELP.Z / README.txt < prev    next >
Encoding:
Text File  |  1998-05-08  |  6.8 KB  |  199 lines
  1.  
  2.                 README
  3.  
  4. Welcome to this Swing release!  This release includes
  5. the Swing libraries, some examples, and API documentation.
  6.  
  7. This file has two sections:
  8.  
  9. - Quick Start
  10. - What's In This Release
  11.  
  12.     -----------------------------------------------------------
  13.     VERSION NOTES
  14.     
  15.     This release is called Swing 1.0 (also known as JFC 1.1).
  16.  
  17.     This Swing release relies on bug fixes first released in JDK
  18.     1.1.5.  If you don't have 1.1.5 or a later release, please
  19.     get it.  We recommend building Swing applications with the
  20.     most current JDK release.  See the following URL for information 
  21.     on downloading the JDK:
  22.  
  23.           http://java.sun.com/products/jdk/1.1
  24.  
  25.     ---------------------------------------------------------
  26.  
  27.  
  28. Quick Start
  29. -----------
  30. Please read the License (LICENSE.txt) before using this release.
  31.  
  32. Please visit the Swing Web site, The Swing Connection.  That's
  33. the place where we're putting the information developers ask us
  34. for the most, with the content coming straight from the
  35. designers and implementers of Swing.  Here's the URL:
  36.  
  37.     http://java.sun.com/products/jfc/swingdoc-current/
  38.  
  39. The Java Tutorial has ever-growing coverage of Swing.  To view the
  40. Swing section of the Tutorial, point your Web browser at this URL:
  41.  
  42.     http://java.sun.com/Series/Tutorial/ui/swing/index.html
  43.     
  44. The remainder of this section tells you how to run an application
  45. that showcases all the Swing components.
  46.  
  47.  
  48. A. If you're running Solaris:
  49. -----------------------------
  50.  
  51. 1. Set your JAVA_HOME environment variable to be the top directory
  52.    of the JDK release you're using. For example:
  53.  
  54.     setenv JAVA_HOME /home/me/jdk1.1.5
  55.     
  56. 2. Go to the examples directory, and then to its SwingSet subdirectory.
  57.  
  58. 3. Execute the runnit command:
  59.  
  60.     runnit
  61.  
  62. 4. If it doesn't run successfully, unset your CLASSPATH environment
  63.    variable and type runnit again:
  64.  
  65.         unsetenv CLASSPATH
  66.     runnit   
  67.  
  68. 5. Read the README.txt file in the SwingSet directory for help
  69.    using the SwingSet example.
  70.  
  71.  
  72. B. If you're running Windows NT:
  73. ---------------------------------
  74.  
  75. 1. Double-click the System icon inside the Control Panel. When the
  76.    System Properties dialog box opens, place the following
  77.    variables in the lower list box, which is labeled "User
  78.    Variables." (Be careful not to change your system environment
  79.    variables, which appear in the upper list box.)
  80.  
  81.        JAVA_HOME      C:\JDK1.1.5
  82.        SWING_HOME     C:\swing-1.0
  83.        CLASSPATH      .;%JAVA_HOME%\lib\classes.zip
  84.        PATH           %PATH%;%JAVA_HOME%\bin
  85.    
  86.    These settings assume that you have installed both the JDK and the 
  87.    Swing tool set on drive C. If either these toolkits has been installed
  88.    on a different drive, substitute that drive's designator wherever it
  89.    is appropriate.
  90.    
  91. 2. From the Windows Start menu or from the Control Panel, open a console 
  92.    (MS-DOS-style) window.
  93.    
  94. 3. In the console window you have opened, navigate to the examples
  95.    directory, and then to its SwingSet subdirectory.
  96.  
  97. 4. From your console window, execute the runnit command:
  98.  
  99.     runnit
  100.  
  101. 5. Read the README.txt file in the SwingSet directory for help
  102.    using the SwingSet example.
  103.  
  104.  
  105. C. If you're running Windows 95:
  106. ---------------------------------
  107.  
  108. 1. Open your favorite text editor and add the following environment-variable
  109.    settings to your system's AUTOEXEC.BAT file:
  110.    
  111.        set JAVA_HOME=C:\JDK1.1.5
  112.        set SWING_HOME=C:\swing-1.0
  113.        set CLASSPATH=.;%JAVA_HOME%\lib\classes.zip
  114.        set PATH=%PATH%;%JAVA_HOME%\bin
  115.    
  116.    These settings assume that you have installed both the JDK and the 
  117.    Swing tool set on drive C. If either these toolkits has been installed
  118.    on a different drive, substitute that drive's designator wherever it
  119.    is appropriate.
  120.    
  121. 2. Perform steps 2 through 5 of the instructions listed under the preceding
  122.    heading, "If you're runnning Windows NT."
  123.  
  124. 3. If you encounter an "Out of environment space" error, then you'll
  125.    need to increase the size of the environment table.  You can do
  126.    this at the command line (which is temporary) or by editing a
  127.    configuration file to make a permanent change (which requires
  128.    restarting your computer).
  129.  
  130.    To temporarily increase environment space, enter the following
  131.    at the DOS prompt:
  132.  
  133.        command /e:8192
  134.  
  135.    To permanently increase environment space, add the following 
  136.    line to your CONFIG.SYS file and then restart your system:
  137.  
  138.        shell=command.com /e:8192 /p
  139.  
  140.    Once you've increased the size of the environment table, try
  141.    running SwingSet again.
  142.  
  143.  
  144. D. Using Swing Components in an IDE
  145. -----------------------------------
  146.  
  147. To use Swing components in an IDE, such as Borland's JBuilder,
  148. Symantec's Cafe, Sun's JavaWorkshop, or IBM's VisualAge, you must
  149. import the swingall.jar file. The swingall.jar file includes the
  150. base Swing implementation, several looks and feels (Metal, Windows,
  151. and Motif), and information that make the Swing components work
  152. as beans.
  153.  
  154. The swingall.jar file is necessary only if you plan to use Swing
  155. in one of the IDE environments, or if you would like to simply
  156. include one "all inclusive" jar file in your CLASSPATH or
  157. application.
  158.  
  159. Also included in this release is the beaninfo.jar file. This file
  160. is included for users who wish to generate their own swingall.jar
  161. file, if perhaps it was removed and you would like to regenerate
  162. it.  For instructions on generating a swingall.jar file, see
  163. NOTES.txt.
  164.  
  165.  
  166. What's In This Release
  167. ----------------------
  168. This release contains the following:
  169.  
  170. README.txt        This file.
  171. README.html        Has links to interesting files (such as README.txt).
  172. LICENSE.txt        Software license.
  173. CHANGES.txt        Notes on changes since the previous release.
  174. NOTES.txt        Miscellaneous notes, including how to reach us.
  175. doc/api/packages.html    Automatically generated Swing API documentation.
  176.  
  177. swing.jar            The Swing classes.  DO NOT UNARCHIVE THIS FILE!
  178. windows.jar             The Windows look and feel.  DO NOT UNARCHIVE!
  179. motif.jar           The Motif look and feel.  DO NOT UNARCHIVE!
  180. beaninfo.jar        Beans-related files and classes.  DO NOT UNARCHIVE!
  181. swingall.jar        All of the above (useful for IDEs).  DO NOT UNARCHIVE!
  182. multi.jar        An experimental multiplexing look and feel.  DO NOT UN-
  183.             ARCHIVE!
  184.  
  185. examples/SwingSet    The comprehensive Swing example.
  186. examples/Simple        A simple Swing application.
  187. examples/SwingApplet    A simple Swing applet.
  188. examples/SampleTree    An example using Swing tree features.
  189. examples/Stylepad    An example using Swing text features.
  190. examples/Notepad    Another text example.
  191. examples/DBDemos    Files to set up databases for use with JDBC.
  192. examples/Table        JTable/JDBC database connectivity examples.
  193. examples/Metalworks    Demonstrates the Metal look and feel.
  194.  
  195.  
  196. Have fun trying out Swing!
  197.  
  198. --The Swing Team
  199.