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:
- 64MB RAM or greater is recommended.
- 300MHZ Pentium or greater processor is recommended.
- Jargon Writer requires about 50MB disk space during installation.
Less than 30MB is used after install.
- 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:
- Network card that allows TCP/IP access to your host server(s).
- A Windows FTP program to move files between client and host
- Or, a host directory network-mapped to your client system.
- The Java 2 Standard Edition (J2SE) JRE 1.4 (must install this first)
The following items must be installed on your host server(s).
- The appropriate middleware and database software for your host environment
- A Web server that supports either CGI, ISAPI or NSAPI interfaces
- 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
- 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
- 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.
- 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.
- 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.
- 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).
- 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.
- 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).
- 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.
- 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).
- 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).
- Password fields.
New "passwordfield" component behaves like a textfield but displays asterisks
("***") instead of the actual characters of the field's data value.
- 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).
- 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).
- 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.
- 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.
- 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
- Java JRE 1.2 is no longer supported. Only JRE 1.4 is supported (see above).
- 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.
- 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.
Evaluation Limitations
The evaluation version of Jargon Writer has the following limitations compared
to the full version:
-
A maximum of 50 component instruction objects can be saved in one XML app file.
-
Startup screens and frame titles display the "Evaluation copy" notice.
-
Certain features may display a message that they cannot be used in the Eval version.
Known Issues
- At this time, only the Palm, PocketPC and Windows PC versions of Jargon
Reader are available. Other versions for Macs and Unix workstations may
be released in subsequent versions.
- Not all of the Version 2 components and methods are supported at this
time in Version 3, and so a V2-to-V3 conversion utility has not yet been
released, since all of the V2 functionality cannot yet be converted.
-
Because of this, Version 2 must still be used for existing applications, including
Jargon Replicator, Building Blocks, the RDU utility, and similar tools. Since
Version 3 applications will not run on Version 2 Jargon Reader products (and
vice versa), YOU SHOULD INSTALL VERSION 3 IN A SEPARATE DIRECTORY, and keep
your Version 2 Jargon Writer for developing and maintaining such applications,
until the upgrade to V3 is available.
-
See
http://www.jargonsoft.com/V3/doc/writer/v3releasenotes.html
for a current list of 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.