Jargon Writer Version 3 README File
November 2003 - Version 3.2 - Build 197

This document provides a summary of newly added or changed features in this version.

IMPORTANT: You must upgrade to Java JRE 1.4 in order to use this release. See "What's New" below.

For a detailed list of known issues and for a history of new features and bug fixes by release, see the local release notes document provided with this release.

You can also view an updated copy of the same document on the Jargon Software web site at http://www.jargonsoft.com/V3/doc/writer/v3releasenotes.html for the latest information.

For a summary of features added or changed in previous versions, refer to the Version 2 documentation.

Contents

Version Information
Installation Requirements
Installing JavaDocs for Swing and AWT
What's New in Version 3.2
Changes from older versions of Jargon Writer
Evaluation Limitations
Known Issues
Uninstalling Jargon Writer



Version Information

This release includes the following:

Java 2 Standard Edition (J2SE) JRE 1.4 Install file (on CD only)
Jargon Writer Version 3 Install File (on CD or download file)



Installation Requirements

This version of Jargon Writer can be installed on the following platform(s):

Client: Intel-compatible PC running Windows 98/ME/NT/2000/XP/2003.
Note that Windows 95 is no longer supported (due to JRE 1.4 supported platform change).

Host:   WinNT/2000/XP or Unix/Linux system with appropriate middleware and database software

Recommended client configuration:

  1. 64MB RAM or greater is recommended.
  2. 300MHZ Pentium or greater processor is recommended.
  3. Jargon Writer requires about 50MB disk space during installation. Less than 30MB is used after install.
  4. Java requires about 90MB for JRE 1.4.2. See the Java web site for specific JRE requirements: http://java.sun.com/j2se/1.4.2/jre/install-windows.html#requirements
The following items must be installed on your client system:
  1. Network card that allows TCP/IP access to your host server(s).
  2. A Windows FTP program to move files between client and host
  3. Or, a host directory network-mapped to your client system.
  4. The Java 2 Standard Edition (J2SE) JRE 1.4 (must install this first)
The following items must be installed on your host server(s).
  1. The appropriate middleware and database software for your host environment
  2. A Web server that supports either CGI, ISAPI or NSAPI interfaces
  3. DNS name server (required on unix only)


Installing JavaDocs for Swing and AWT

Due to Sun's licensing restrictions, the HTML files for the JavaDoc API documentation of the Swing and AWT classes cannot be redistributed by Jargon Software. The default links to these documentation files are set in the preferences.ini file in the system subdirectory to point to Sun's web site, and can be viewed online if you have an Internet connection.

You may also download a zip file of these docs and install on your local system, so long as you update them whenever Sun releases a new version. If you do so, then change the preferences.ini parameters to point to local file links rather than Sun's web site for these docs.

To download the docs (or view them online), go to http://java.sun.com/docs/ and select the appropriate format (typically a zip file of HTML documents).



What's New in Version 3.2
  1. IMPORTANT: JAVA JRE 1.4 NOW REQUIRED Effective with this Build 197, JRE 1.4 MUST be installed and used with Jargon Writer. Previous java versions 1.2 and 1.3 are NOT supported and will definitely not work, there is a problem with saving files when using these older versions. You MUST update your java JRE to a 1.4 version. You can download it from Sun's web site at: http://java.sun.com/j2se/1.4.2/download.html

  2.  
  3. Browser Invocation On Windows platforms only (ReaderWin and ReaderPDA), a new sys.ShowDocument(string URL) method has been implemented which will invoke the default web browser on the user PC and pass it the specified URL as the initial web document to be displayed (typically an HTML, PDF or TXT file). This can be used for displaying host-generated reports, online documentation, and similar purposes.

  4.  
  5. Calendar Control for Date Entry A native popup calendar control is now used for selection of dates in textfields with a "fieldType" attribute value of "Date". When focus is placed on the field by touching it, clicking into into or tabbing into it (depending on the device), a native popup calendar is displayed from which the user can select a date or cancel to keep the current field value.

  6.  
  7. Boldface Fonts Labels and text components (textfield, passwordfield, textarea, textpane, table cells) can now be displayed in either regular or boldface fonts. All labels (including checkbox captions) can be displayed in a boldface font by using a new startup parameter "BoldLabels=true" (the default is false, for regular font face). Text components are individually controlled by a new method "SetFontID(int)" where int is 0=regular or 1=bold.

  8.  
  9. Ability to Hide Components The "SetVisible(true/false)" method has been implemented for all components. This allows buttons, labels, textfields and other components to be dynamically hidden or redisplayed at runtime. Components may also be initially hidden by using the "isVisible=false" attribute value (not implemented on PalmOS platforms).

  10.  
  11. New Menubar/Menuitem Components A standard menubar with dropdown menus and menu choices has been implemented. The menubar choices are hardcoded as "File, Options, Help" and no new menubar choices can be added in a program, due to PalmOS limitations. Any number of menu choices (menuitems) can be added under the "Options" menu. In this release, submenus are not supported and menu choices cannot be added under File or Help menus.

  12.  
  13. Custom startup menus. New support for custom Jargon Reader startup menus, which can contain hard-coded customer-specific URLs (for an application menu, etc). This feature eliminates the need to enter long URL values to load applications. (Not currently implemented on PalmOS platforms).

  14.  
  15. Apps can run other apps. Adds the ability for one xml app ("a.xml") to run another one ("b.xml"). This uses a set of new methods on the global "sys" object, and can also be used to update or delete a currently cached app file, and to get a list of cached files. These provide basic functionality for an app menu.

  16.  
  17. SSL Encryption. A new form of the http SendRequest method can now be used to send the URL request to the remote server and specify whether SSL encryption is to be used or not. This requires that the specified server has installed a valid SSL certificate. (Not currently supported when executing programs from within Jargon Writer or when using Jargon Reader on PalmOS-based handheld devices).

  18.  
  19. File System Methods. A new global "jsifile" object provides methods to interface with the native file system of Windows-based client devices. (Not currently supported for PalmOS-based handheld devices).

  20.  
  21. Password fields. New "passwordfield" component behaves like a textfield but displays asterisks ("***") instead of the actual characters of the field's data value.

  22.  
  23. Local ODBC Databases. Jargon Writer and Jargon Reader now provide native support for accessing and updating local databases on Windows-based PCs and handheld devices, using standard ODBC and SQL. (Not currently supported for PalmOS-based handheld devices).

  24.  
  25. Displaying and Storing Images. A new "image" component allows loading and displaying GIF and JPG images (only the GIF87a format is supported for PalmOS devices).

  26.  
  27. New "hyperlink" component. A new "hyperlink" component, which is an underlined label with an ActionEvent, provides functionality similar to an HTML link. Both the displayed text and a hidden user data value can be assigned and accessed by new methods for this component. A similar new hyperlink cell editor is also available as a table cell component.

  28.  
  29. New HTTP Host Methods. A new "http" global component and methods allow low-level access to any resource that a remote web server can provide, including text files, image files, and other documents.

  30.  
  31. New Jargon Emulator for Windows PCs. A new entry in the system/preferences.ini allows you to choose which emulator will be used when the "EXE" button is pressed in Jargon Writer. Choices are the Jargon PDA Emulator or the Jargon Windows Emulator.


Changes from older versions of Jargon Writer
  1. Java JRE 1.2 is no longer supported. Only JRE 1.4 is supported (see above).

  2.  
  3. The methods used with the "symbol" barcode scanner component have been revised since V3.1. If you have used the symbol methods in V3.1, please contact support@jargonsoft.com for details.

  4.  
  5. In the initial Version 3 releases, only those components, attributes and methods currently supported for the Palm and Pocket PC deployment engines are shown in the Jargon Writer windows. These will be expanded in future versions and will eventually include all features supported in V2.

  6.  


Evaluation Limitations

The evaluation version of Jargon Writer has the following limitations compared to the full version:

  1. A maximum of 50 component instruction objects can be saved in one XML app file.
  2. Startup screens and frame titles display the "Evaluation copy" notice.
  3. Certain features may display a message that they cannot be used in the Eval version.




Known Issues

Uninstalling Jargon Writer

From the Windows Start menu, select "Control Panel", then "Add/Remove Programs".
In the list of installed programs, select "Jargon Writer", then click the add/remove button.
This will remove the program files and registry entries.



Copyright © 1999-2003 Jargon Software, Inc. All rights reserved.