tn5250j/src tn5250jMsgs.properties,1.40,1.41 COPYING,1.1.1.1,1.2 macros.txt,1.1.1.1,1.2 readme.txt,1.18,1.19 applet.txt,1.1.1.1,1.2 filetransfers.txt,1.1.1.1,1.2 e-mail.txt,1.3,1.4
"Kenneth J. Pouncey" <[email protected]> Thu, 16 Jun 2005 04:41:18 +0000
| Newsgroups | gmane.comp.java.tn5250j.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/tn5250j/tn5250j/src
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24279/src
Modified Files:
tn5250jMsgs.properties COPYING macros.txt readme.txt
applet.txt filetransfers.txt e-mail.txt
Log Message:
the rest of the story
Index: e-mail.txt
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/e-mail.txt,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** e-mail.txt 18 Jul 2002 16:50:04 -0000 1.3
--- e-mail.txt 16 Jun 2005 04:41:16 -0000 1.4
***************
*** 1,107 ****
! E-mail README
! ------------------------------------------------------------------------------
!
! This version of the emulator includes support to send screen to e-mail.
!
! 1. Setting up e-mail support
! 2. Deployment
! 3. Deployment with JavaWebStart
! 4. Using emulator to send screen shots via e-mail
!
!
! Setting up e-mail support
! -------------------------
!
! 1. Download the e-mail api's from sun. You will need two packages.
!
! http://java.sun.com/products/javamail/
! http://java.sun.com/products/javabeans/glasgow/jaf.html
!
! 2. Unzip the files into there respective directories. I use the same directory
! names as provided within the zip files.
!
! Deployment
! -----------
!
! 1. Copy the file activation.jar from the /jaf-1.0.1 file to the SAME DIRECTORY as
! the my5250.jar.
!
! 2. Copy the files
! mail.jar
! mailapi.jar
! smtp.jar
!
! to the SAME DIRECTORY as the my5250.jar.
!
! If you list the directory where the my5250.jar file is you should see 4 files
! with the extension .jar. If this is not true then go to step one of Deployment
! and start again.
!
! 3. Now when selecting any e-mail functions you will have to configure the
! properties first. There will be a button to configure this before sending
! e-mails.
!
! Deployment with JavaWebStart
! ----------------------------
! Using the webstart application the clients are automatically set up for use any
! any changes are automatically downloaded and ready for use.
!
! I also have scripts and or .bat set up to do the signing and copying to the
! intranet.
!
! I have included my sample .jnlp file that I use for deploying in JavaWebStart.
!
! <?xml version="1.0" encoding="utf-8"?>
! <!-- JNLP File for tn5250j Application -->
! <jnlp
! spec="0.2 1.0"
! codebase="http://xxx.xxx.xxx.xxx:8080/products/javawebstart/apps"
! href="tn5250j.jnlp">
! <information>
! <title>tn5250j</title>
! <vendor>Kenneth J. Pouncey</vendor>
! <homepage href="http://sourceforge.net/tn5250j"/>
! <description>tn5250j - 5250 emulator written in java</description>
! <description kind="short">tn5250j - 5250 emulator</description>
! <icon href="tnicon.jpg"/>
! <offline-allowed/>
! </information>
! <security>
! <all-permissions/>
! </security>
! <resources>
! <j2se version="1.3+" inital-heap-size="64m" max-heap-size="256m"/>
! <jar href="my5250.jar" main="true" download="eager"/>
! <jar href="activation.jar"/>
! <jar href="mail.jar"/>
! <jar href="mailapi.jar"/>
! <jar href="smtp.jar"/>
! </resources>
! <application-desc main-class="org.tn5250j.My5250"/>
! </jnlp>
!
! All these files are signed before coping to server.
!
! For instructions on Setting up and Using Java webstart please consult the
! experts website.
!
! Using emulator to send screen shots via e-mail
! ----------------------------------------------
!
! 1. From the emulator press Alt-e to get an input dialog to enter the following:
!
! To:
! Subject:
! Message:
! Attachment Name:
!
! 2. Press the Send button or Cancel.
!
! 3. Press the Configure button to configure the e-mail attributes.
!
!
! If you have any questions or suggestions please let me know. If you have code
! changes PLEASE PLEASE send them to me.
!
! Enjoy!!!
!
--- 1,107 ----
! E-mail README
! ------------------------------------------------------------------------------
!
! This version of the emulator includes support to send screen to e-mail.
!
! 1. Setting up e-mail support
! 2. Deployment
! 3. Deployment with JavaWebStart
! 4. Using emulator to send screen shots via e-mail
!
!
! Setting up e-mail support
! -------------------------
!
! 1. Download the e-mail api's from sun. You will need two packages.
!
! http://java.sun.com/products/javamail/
! http://java.sun.com/products/javabeans/glasgow/jaf.html
!
! 2. Unzip the files into there respective directories. I use the same directory
! names as provided within the zip files.
!
! Deployment
! -----------
!
! 1. Copy the file activation.jar from the /jaf-1.0.1 file to the SAME DIRECTORY as
! the my5250.jar.
!
! 2. Copy the files
! mail.jar
! mailapi.jar
! smtp.jar
!
! to the SAME DIRECTORY as the my5250.jar.
!
! If you list the directory where the my5250.jar file is you should see 4 files
! with the extension .jar. If this is not true then go to step one of Deployment
! and start again.
!
! 3. Now when selecting any e-mail functions you will have to configure the
! properties first. There will be a button to configure this before sending
! e-mails.
!
! Deployment with JavaWebStart
! ----------------------------
! Using the webstart application the clients are automatically set up for use any
! any changes are automatically downloaded and ready for use.
!
! I also have scripts and or .bat set up to do the signing and copying to the
! intranet.
!
! I have included my sample .jnlp file that I use for deploying in JavaWebStart.
!
! <?xml version="1.0" encoding="utf-8"?>
! <!-- JNLP File for tn5250j Application -->
! <jnlp
! spec="0.2 1.0"
! codebase="http://xxx.xxx.xxx.xxx:8080/products/javawebstart/apps"
! href="tn5250j.jnlp">
! <information>
! <title>tn5250j</title>
! <vendor>Kenneth J. Pouncey</vendor>
! <homepage href="http://sourceforge.net/tn5250j"/>
! <description>tn5250j - 5250 emulator written in java</description>
! <description kind="short">tn5250j - 5250 emulator</description>
! <icon href="tnicon.jpg"/>
! <offline-allowed/>
! </information>
! <security>
! <all-permissions/>
! </security>
! <resources>
! <j2se version="1.3+" inital-heap-size="64m" max-heap-size="256m"/>
! <jar href="my5250.jar" main="true" download="eager"/>
! <jar href="activation.jar"/>
! <jar href="mail.jar"/>
! <jar href="mailapi.jar"/>
! <jar href="smtp.jar"/>
! </resources>
! <application-desc main-class="org.tn5250j.My5250"/>
! </jnlp>
!
! All these files are signed before coping to server.
!
! For instructions on Setting up and Using Java webstart please consult the
! experts website.
!
! Using emulator to send screen shots via e-mail
! ----------------------------------------------
!
! 1. From the emulator press Alt-e to get an input dialog to enter the following:
!
! To:
! Subject:
! Message:
! Attachment Name:
!
! 2. Press the Send button or Cancel.
!
! 3. Press the Configure button to configure the e-mail attributes.
!
!
! If you have any questions or suggestions please let me know. If you have code
! changes PLEASE PLEASE send them to me.
!
! Enjoy!!!
!
Index: filetransfers.txt
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/filetransfers.txt,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -C2 -d -r1.1.1.1 -r1.2
*** filetransfers.txt 10 Apr 2002 19:46:09 -0000 1.1.1.1
--- filetransfers.txt 16 Jun 2005 04:41:16 -0000 1.2
***************
*** 1,125 ****
! File Transfers README
! ------------------------------------------------------------------------------
!
! This version of the emulator will allow the downloading of file information from
! an as400. It will be formatted as an HTML table with the headers being the
! field names.
!
! ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ----
!
! I have only been able to test with with OS/400 V4R5 so if there are any problems
! with offsets of fields please let me know
!
! ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ----
!
! Modifications for this release 0.4.14 adds:
! -------------------------------------------
! - Selection of decimal separator to use for numbers
! - KSpreadSheet file filter
! - OpenOffice file filter
!
! *** Note *** for the filters if the numbers do not show up correctly
! try downloading with the other decimal separator.
!
! Modifications for this release 0.4.9 adds:
! ------------------------------------------
! - File browser for selecting local file
! - Fix for Signed Numeric fields
! - Transfer progression panel
! - Ouput panel of commands and responses from OS400
! - Transfers are executed in threads to keep user interface from locking up
! - Support for member transfer and size information used for transfer progress
! - Local file is appended with the correct extension of the output format
! for instance in this release we only support HTML so the file will
! be appended with .html if not specified
! - Testing for fields transferred if correct or not.
! - Field types tested:
!
! A
! A R DWNLOAD
! A FIELD1 10A COLHDG('Field 1............
! A FIELD2 10P 0 COLHDG('Field 2............
! A FIELD3 10P 3 COLHDG('Field 3............
! A FIELD4 10S 0 COLHDG('Field 4............
! A FIELD5 10S 3 COLHDG('Field 5............
! A FIELD6 10B 0 COLHDG('Field 6............
! A FIELD7 10B 0 COLHDG('Field 7............
! A FIELD8 5F 0 COLHDG('Field 7............
! A FIELD9 5F 3 COLHDG('Field 8............
! A FIELD10 L COLHDG('Field 9............
! A FIELD11 T COLHDG('Field 10...........
! A FIELD12 Z COLHDG('Field 11...........
! A FIELD13 6H COLHDG('Field 12...........
!
!
! *** NOTE *** I do not know if I am downloading everything correctly. Please
! check the files for accuracy and let me know of any problems.
!
! Navigating File Transfer Panel
! =========================================
!
! Right click on session screen pulls up a menu as follows:
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > :
! :---------------------:
! : Transfer File... :
! :---------------------:
! : Connect/Disconnect :
! :=====================:
!
! After getting the popup menu you will see an option for Transfer File... Select
! the menu item and you will be presented with a screen to supply the transfer
! parameters.
!
! The following information is requested.
!
! System Name - The DNS name or IP address of the system that you want to connect
! download files from
!
! File Name - The host file name that you want to download. The default root
! directory is probably QGPL so you will have to supply the full
! name of the file in the format of LIBRARY/FILE.MEMBER
!
! User Id - User Id for security signon
!
! Password - Password for the user.
!
! PC File Name - The local file name where the data is to be placed. The default
! directory is the path of the emulator. If you want to place
! it somewhere else you will need to specify the full path name
! where to place it.
!
! The file is in HTML format so you will probably want to name
! the file with and extension of .htm or .html
!
! Browse Button - Select button to pull up the file browser
!
! Decimal separator - Select the decimal separator to be used for formatting
! numbers.
!
! If you have any questions or suggestions please let me know.
!
! The source code is a mess as usual so I will be adding comments sometime in the
! future as well.
!
! Enjoy!!!
!
--- 1,125 ----
! File Transfers README
! ------------------------------------------------------------------------------
!
! This version of the emulator will allow the downloading of file information from
! an as400. It will be formatted as an HTML table with the headers being the
! field names.
!
! ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ----
!
! I have only been able to test with with OS/400 V4R5 so if there are any problems
! with offsets of fields please let me know
!
! ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ---- ---- NOTE ----
!
! Modifications for this release 0.4.14 adds:
! -------------------------------------------
! - Selection of decimal separator to use for numbers
! - KSpreadSheet file filter
! - OpenOffice file filter
!
! *** Note *** for the filters if the numbers do not show up correctly
! try downloading with the other decimal separator.
!
! Modifications for this release 0.4.9 adds:
! ------------------------------------------
! - File browser for selecting local file
! - Fix for Signed Numeric fields
! - Transfer progression panel
! - Ouput panel of commands and responses from OS400
! - Transfers are executed in threads to keep user interface from locking up
! - Support for member transfer and size information used for transfer progress
! - Local file is appended with the correct extension of the output format
! for instance in this release we only support HTML so the file will
! be appended with .html if not specified
! - Testing for fields transferred if correct or not.
! - Field types tested:
!
! A
! A R DWNLOAD
! A FIELD1 10A COLHDG('Field 1............
! A FIELD2 10P 0 COLHDG('Field 2............
! A FIELD3 10P 3 COLHDG('Field 3............
! A FIELD4 10S 0 COLHDG('Field 4............
! A FIELD5 10S 3 COLHDG('Field 5............
! A FIELD6 10B 0 COLHDG('Field 6............
! A FIELD7 10B 0 COLHDG('Field 7............
! A FIELD8 5F 0 COLHDG('Field 7............
! A FIELD9 5F 3 COLHDG('Field 8............
! A FIELD10 L COLHDG('Field 9............
! A FIELD11 T COLHDG('Field 10...........
! A FIELD12 Z COLHDG('Field 11...........
! A FIELD13 6H COLHDG('Field 12...........
!
!
! *** NOTE *** I do not know if I am downloading everything correctly. Please
! check the files for accuracy and let me know of any problems.
!
! Navigating File Transfer Panel
! =========================================
!
! Right click on session screen pulls up a menu as follows:
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > :
! :---------------------:
! : Transfer File... :
! :---------------------:
! : Connect/Disconnect :
! :=====================:
!
! After getting the popup menu you will see an option for Transfer File... Select
! the menu item and you will be presented with a screen to supply the transfer
! parameters.
!
! The following information is requested.
!
! System Name - The DNS name or IP address of the system that you want to connect
! download files from
!
! File Name - The host file name that you want to download. The default root
! directory is probably QGPL so you will have to supply the full
! name of the file in the format of LIBRARY/FILE.MEMBER
!
! User Id - User Id for security signon
!
! Password - Password for the user.
!
! PC File Name - The local file name where the data is to be placed. The default
! directory is the path of the emulator. If you want to place
! it somewhere else you will need to specify the full path name
! where to place it.
!
! The file is in HTML format so you will probably want to name
! the file with and extension of .htm or .html
!
! Browse Button - Select button to pull up the file browser
!
! Decimal separator - Select the decimal separator to be used for formatting
! numbers.
!
! If you have any questions or suggestions please let me know.
!
! The source code is a mess as usual so I will be adding comments sometime in the
! future as well.
!
! Enjoy!!!
!
Index: readme.txt
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/readme.txt,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -d -r1.18 -r1.19
*** readme.txt 13 Mar 2004 16:55:29 -0000 1.18
--- readme.txt 16 Jun 2005 04:41:16 -0000 1.19
***************
*** 6,9 ****
--- 6,40 ----
fields etc.....
+ Changes to last release since forever and a day
+ ------------------------------------------------------------------------------
+ **** JDK Version WARNING *****
+ I am only going to release versions compiled with JDK 1.4 if you need a 1.3
+ version please download the sources and compile it or from CVS.
+ *******************************
+
+ I truthfully can not remember all that has happened since the last release
+ so will only list here some of what I remember and the most important.
+
+ First and foremost lots of bug fixes
+ Second the whole code base has been refactored to run in headless mode:
+ 1) You do not need to have the gui to have access to the data stream
+ Can you say screen scraping? Well hopefully it all works.
+ 2) A ProtocolBean has been added for this.
+ 3) A SessionBean has been added for this.
+ 4) The code now uses events for all this information so you can write your
+ own listeners to these events. There are some people that have used this for
+ such work so ask on the mailing list and am sure some samples can be
+ given or at least help with it. The events are in org.tn5250j.event
+
+ Logging modules have been added for log4j or built in console support. You
+ can reference this on the Connection panel under the Logging Panel
+
+ New session properties have been added. Take a look at the options for more
+ on this.
+
+ Anything else please ask on the mailing lists. Hope you enjoy.
+
+ ==============================================================================
+
Changes since 0.5.7 pre release 3
------------------------------------------------------------------------------
Index: tn5250jMsgs.properties
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/tn5250jMsgs.properties,v
retrieving revision 1.40
retrieving revision 1.41
diff -C2 -d -r1.40 -r1.41
*** tn5250jMsgs.properties 8 Jun 2005 19:52:10 -0000 1.40
--- tn5250jMsgs.properties 16 Jun 2005 04:41:16 -0000 1.41
***************
*** 1,532 ****
! # Session Selection literals
! ss.title=Connect
! ss.optConnect=&Connect
! ss.optCancel=Cancel
! ss.optAdd=&Add
! ss.optDone=Done
! ss.optEdit=&Properties
! ss.optDelete=&Remove
! ss.optApply=Apply
! ss.labelShowMe=Show this dialog at startup
[...1035 lines suppressed...]
! # as400 toolbox does not exist
! messages.noAS400Toolbox=This option not available because the Java AS400 Toolbox can \
! not be found.\nPlease place it in the CLASSPATH to have access to this function.
!
! # signoff verification message
! messages.signOff=Session not on signon screen.\nContinue?
!
! # key already mapped replace it warning
! messages.mapKeyWarning=<html>This key sequence is already mapped to : \
! <br><center><font color=#ffffdd>{0}</font></center><br>This \
! will replace the current mapping of the key.<br>Would you like to replace this?</html>
!
! # Warning for Null capable fields within file
! messages.nullFieldWarning=<html>Files that allow Null capable fields may not work\
! <br><br>Below are a list of these fields:</br></br></html>
!
! # Security Access Denied messages
! messages.SADTitle="Insufficient priviledges"
! messages.SADMessage=Applet has insufficient priviledges to continue please grant \
! these to continue.\n\n
Index: applet.txt
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/applet.txt,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -C2 -d -r1.1.1.1 -r1.2
*** applet.txt 10 Apr 2002 19:46:05 -0000 1.1.1.1
--- applet.txt 16 Jun 2005 04:41:16 -0000 1.2
***************
*** 1,63 ****
! Applet README
! ------------------------------------------------------------------------------
!
! This version of the emulator includes an applet version of the emulator to be
! embedded in a webbrowser.
!
! Big thanks goes to Bob Fludder at http://www.businessvision.au for testing and
! helping with this. He is suppose to write a how to and/or deployment for the
! applet version of the emulator.
!
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
! Help is needed here with information and or changes to the code to allow a
! seemless integration. There are probably bugs in there so please be nice when
! reporting them ;-)
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
!
! Browsers Tested
! ---------------
! Netscape
!
! Plugins Tested
! --------------
! 1.3.1
! 1.4 beta 3
!
! One thing about the 1.4 beta 3 plugin is that it allows a signed jar to be
! loaded and the proper authority is prompted for the certificate. Once accepted
! the certificate is then saved thus saving the deployment, installation and
! importing of keys/signatures to each of the desktops. Very Very nice.
!
! Deployment
! -----------
! There are to applet html files that are included:
!
! My5250App.html
! My5250AppPlugin.html
!
!
! I am going to have to refer you to the experts at the discussion forum of sun
! at the following:
!
! http://forum.java.sun.com/thread.jsp?forum=63&thread=174214
!
! This has the best information on signing and deploying applets. This being my
! first applet program I am at a lost for help on deployment for the different
! browsers and I do not have the time to test them all.
!
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
! Help is needed here with information and or changes to the code to allow a
! seemless integration. There are probably bugs in there so please be nice when
! reporting them ;-)
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
!
! Applet Parameters
! -----------------
! All command line options are supported for applet parameters except for the
! -f argument for file properties. Looking for suggestion here!!!!!!!!
!
! If you have any questions or suggestions please let me know. If you have code
! changes PLEASE PLEASE send them to me.
!
! Enjoy!!!
!
--- 1,63 ----
! Applet README
! ------------------------------------------------------------------------------
!
! This version of the emulator includes an applet version of the emulator to be
! embedded in a webbrowser.
!
! Big thanks goes to Bob Fludder at http://www.businessvision.au for testing and
! helping with this. He is suppose to write a how to and/or deployment for the
! applet version of the emulator.
!
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
! Help is needed here with information and or changes to the code to allow a
! seemless integration. There are probably bugs in there so please be nice when
! reporting them ;-)
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
!
! Browsers Tested
! ---------------
! Netscape
!
! Plugins Tested
! --------------
! 1.3.1
! 1.4 beta 3
!
! One thing about the 1.4 beta 3 plugin is that it allows a signed jar to be
! loaded and the proper authority is prompted for the certificate. Once accepted
! the certificate is then saved thus saving the deployment, installation and
! importing of keys/signatures to each of the desktops. Very Very nice.
!
! Deployment
! -----------
! There are to applet html files that are included:
!
! My5250App.html
! My5250AppPlugin.html
!
!
! I am going to have to refer you to the experts at the discussion forum of sun
! at the following:
!
! http://forum.java.sun.com/thread.jsp?forum=63&thread=174214
!
! This has the best information on signing and deploying applets. This being my
! first applet program I am at a lost for help on deployment for the different
! browsers and I do not have the time to test them all.
!
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
! Help is needed here with information and or changes to the code to allow a
! seemless integration. There are probably bugs in there so please be nice when
! reporting them ;-)
! --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE --- --- NOTE ---
!
! Applet Parameters
! -----------------
! All command line options are supported for applet parameters except for the
! -f argument for file properties. Looking for suggestion here!!!!!!!!
!
! If you have any questions or suggestions please let me know. If you have code
! changes PLEASE PLEASE send them to me.
!
! Enjoy!!!
!
Index: COPYING
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/COPYING,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -C2 -d -r1.1.1.1 -r1.2
*** COPYING 10 Apr 2002 19:46:09 -0000 1.1.1.1
--- COPYING 16 Jun 2005 04:41:16 -0000 1.2
***************
*** 1,346 ****
! GNU GENERAL PUBLIC LICENSE
! Version 2, June 1991
!
! Copyright (C) 1989, 1991 Free Software Foundation, Inc.
! 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
! Everyone is permitted to copy and distribute verbatim copies
! of this license document, but changing it is not allowed.
!
! Preamble
!
! The licenses for most software are designed to take away your
! freedom to share and change it. By contrast, the GNU General Public
! License is intended to guarantee your freedom to share and change free
! software--to make sure the software is free for all its users. This
! General Public License applies to most of the Free Software
! Foundation's software and to any other program whose authors commit to
! using it. (Some other Free Software Foundation software is covered by
! the GNU Library General Public License instead.) You can apply it to
! your programs, too.
!
! When we speak of free software, we are referring to freedom, not
! price. Our General Public Licenses are designed to make sure that you
! have the freedom to distribute copies of free software (and charge for
! this service if you wish), that you receive source code or can get it
! if you want it, that you can change the software or use pieces of it
! in new free programs; and that you know you can do these things.
!
! To protect your rights, we need to make restrictions that forbid
! anyone to deny you these rights or to ask you to surrender the rights.
! These restrictions translate to certain responsibilities for you if you
! distribute copies of the software, or if you modify it.
!
! For example, if you distribute copies of such a program, whether
! gratis or for a fee, you must give the recipients all the rights that
! you have. You must make sure that they, too, receive or can get the
! source code. And you must show them these terms so they know their
! rights.
!
! We protect your rights with two steps: (1) copyright the software, and
! (2) offer you this license which gives you legal permission to copy,
! distribute and/or modify the software.
!
! Also, for each author's protection and ours, we want to make certain
! that everyone understands that there is no warranty for this free
! software. If the software is modified by someone else and passed on, we
! want its recipients to know that what they have is not the original, so
! that any problems introduced by others will not reflect on the original
! authors' reputations.
!
! Finally, any free program is threatened constantly by software
! patents. We wish to avoid the danger that redistributors of a free
! program will individually obtain patent licenses, in effect making the
! program proprietary. To prevent this, we have made it clear that any
! patent must be licensed for everyone's free use or not licensed at all.
!
! The precise terms and conditions for copying, distribution and
! modification follow.
!
!
! GNU GENERAL PUBLIC LICENSE
! TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
!
! 0. This License applies to any program or other work which contains
! a notice placed by the copyright holder saying it may be distributed
! under the terms of this General Public License. The "Program", below,
! refers to any such program or work, and a "work based on the Program"
! means either the Program or any derivative work under copyright law:
! that is to say, a work containing the Program or a portion of it,
! either verbatim or with modifications and/or translated into another
! language. (Hereinafter, translation is included without limitation in
! the term "modification".) Each licensee is addressed as "you".
!
! Activities other than copying, distribution and modification are not
! covered by this License; they are outside its scope. The act of
! running the Program is not restricted, and the output from the Program
! is covered only if its contents constitute a work based on the
! Program (independent of having been made by running the Program).
! Whether that is true depends on what the Program does.
!
! 1. You may copy and distribute verbatim copies of the Program's
! source code as you receive it, in any medium, provided that you
! conspicuously and appropriately publish on each copy an appropriate
! copyright notice and disclaimer of warranty; keep intact all the
! notices that refer to this License and to the absence of any warranty;
! and give any other recipients of the Program a copy of this License
! along with the Program.
!
! You may charge a fee for the physical act of transferring a copy, and
! you may at your option offer warranty protection in exchange for a fee.
!
! 2. You may modify your copy or copies of the Program or any portion
! of it, thus forming a work based on the Program, and copy and
! distribute such modifications or work under the terms of Section 1
! above, provided that you also meet all of these conditions:
!
! a) You must cause the modified files to carry prominent notices
! stating that you changed the files and the date of any change.
!
! b) You must cause any work that you distribute or publish, that in
! whole or in part contains or is derived from the Program or any
! part thereof, to be licensed as a whole at no charge to all third
! parties under the terms of this License.
!
! c) If the modified program normally reads commands interactively
! when run, you must cause it, when started running for such
! interactive use in the most ordinary way, to print or display an
! announcement including an appropriate copyright notice and a
! notice that there is no warranty (or else, saying that you provide
! a warranty) and that users may redistribute the program under
! these conditions, and telling the user how to view a copy of this
! License. (Exception: if the Program itself is interactive but
! does not normally print such an announcement, your work based on
! the Program is not required to print an announcement.)
!
!
! These requirements apply to the modified work as a whole. If
! identifiable sections of that work are not derived from the Program,
! and can be reasonably considered independent and separate works in
! themselves, then this License, and its terms, do not apply to those
! sections when you distribute them as separate works. But when you
! distribute the same sections as part of a whole which is a work based
! on the Program, the distribution of the whole must be on the terms of
! this License, whose permissions for other licensees extend to the
! entire whole, and thus to each and every part regardless of who wrote it.
!
! Thus, it is not the intent of this section to claim rights or contest
! your rights to work written entirely by you; rather, the intent is to
! exercise the right to control the distribution of derivative or
! collective works based on the Program.
!
! In addition, mere aggregation of another work not based on the Program
! with the Program (or with a work based on the Program) on a volume of
! a storage or distribution medium does not bring the other work under
! the scope of this License.
!
! 3. You may copy and distribute the Program (or a work based on it,
! under Section 2) in object code or executable form under the terms of
! Sections 1 and 2 above provided that you also do one of the following:
!
! a) Accompany it with the complete corresponding machine-readable
! source code, which must be distributed under the terms of Sections
! 1 and 2 above on a medium customarily used for software interchange; or,
!
! b) Accompany it with a written offer, valid for at least three
! years, to give any third party, for a charge no more than your
! cost of physically performing source distribution, a complete
! machine-readable copy of the corresponding source code, to be
! distributed under the terms of Sections 1 and 2 above on a medium
! customarily used for software interchange; or,
!
! c) Accompany it with the information you received as to the offer
! to distribute corresponding source code. (This alternative is
! allowed only for noncommercial distribution and only if you
! received the program in object code or executable form with such
! an offer, in accord with Subsection b above.)
!
! The source code for a work means the preferred form of the work for
! making modifications to it. For an executable work, complete source
! code means all the source code for all modules it contains, plus any
! associated interface definition files, plus the scripts used to
! control compilation and installation of the executable. However, as a
! special exception, the source code distributed need not include
! anything that is normally distributed (in either source or binary
! form) with the major components (compiler, kernel, and so on) of the
! operating system on which the executable runs, unless that component
! itself accompanies the executable.
!
! If distribution of executable or object code is made by offering
! access to copy from a designated place, then offering equivalent
! access to copy the source code from the same place counts as
! distribution of the source code, even though third parties are not
! compelled to copy the source along with the object code.
!
!
! 4. You may not copy, modify, sublicense, or distribute the Program
! except as expressly provided under this License. Any attempt
! otherwise to copy, modify, sublicense or distribute the Program is
! void, and will automatically terminate your rights under this License.
! However, parties who have received copies, or rights, from you under
! this License will not have their licenses terminated so long as such
! parties remain in full compliance.
!
! 5. You are not required to accept this License, since you have not
! signed it. However, nothing else grants you permission to modify or
! distribute the Program or its derivative works. These actions are
! prohibited by law if you do not accept this License. Therefore, by
! modifying or distributing the Program (or any work based on the
! Program), you indicate your acceptance of this License to do so, and
! all its terms and conditions for copying, distributing or modifying
! the Program or works based on it.
!
! 6. Each time you redistribute the Program (or any work based on the
! Program), the recipient automatically receives a license from the
! original licensor to copy, distribute or modify the Program subject to
! these terms and conditions. You may not impose any further
! restrictions on the recipients' exercise of the rights granted herein.
! You are not responsible for enforcing compliance by third parties to
! this License.
!
! 7. If, as a consequence of a court judgment or allegation of patent
! infringement or for any other reason (not limited to patent issues),
! conditions are imposed on you (whether by court order, agreement or
! otherwise) that contradict the conditions of this License, they do not
! excuse you from the conditions of this License. If you cannot
! distribute so as to satisfy simultaneously your obligations under this
! License and any other pertinent obligations, then as a consequence you
! may not distribute the Program at all. For example, if a patent
! license would not permit royalty-free redistribution of the Program by
! all those who receive copies directly or indirectly through you, then
! the only way you could satisfy both it and this License would be to
! refrain entirely from distribution of the Program.
!
! If any portion of this section is held invalid or unenforceable under
! any particular circumstance, the balance of the section is intended to
! apply and the section as a whole is intended to apply in other
! circumstances.
!
! It is not the purpose of this section to induce you to infringe any
! patents or other property right claims or to contest validity of any
! such claims; this section has the sole purpose of protecting the
! integrity of the free software distribution system, which is
! implemented by public license practices. Many people have made
! generous contributions to the wide range of software distributed
! through that system in reliance on consistent application of that
! system; it is up to the author/donor to decide if he or she is willing
! to distribute software through any other system and a licensee cannot
! impose that choice.
!
! This section is intended to make thoroughly clear what is believed to
! be a consequence of the rest of this License.
!
!
! 8. If the distribution and/or use of the Program is restricted in
! certain countries either by patents or by copyrighted interfaces, the
! original copyright holder who places the Program under this License
! may add an explicit geographical distribution limitation excluding
! those countries, so that distribution is permitted only in or among
! countries not thus excluded. In such case, this License incorporates
! the limitation as if written in the body of this License.
!
! 9. The Free Software Foundation may publish revised and/or new versions
! of the General Public License from time to time. Such new versions will
! be similar in spirit to the present version, but may differ in detail to
! address new problems or concerns.
!
! Each version is given a distinguishing version number. If the Program
! specifies a version number of this License which applies to it and "any
! later version", you have the option of following the terms and conditions
! either of that version or of any later version published by the Free
! Software Foundation. If the Program does not specify a version number of
! this License, you may choose any version ever published by the Free Software
! Foundation.
!
! 10. If you wish to incorporate parts of the Program into other free
! programs whose distribution conditions are different, write to the author
! to ask for permission. For software which is copyrighted by the Free
! Software Foundation, write to the Free Software Foundation; we sometimes
! make exceptions for this. Our decision will be guided by the two goals
! of preserving the free status of all derivatives of our free software and
! of promoting the sharing and reuse of software generally.
!
! NO WARRANTY
!
! 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
! FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
! OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
! PROVIDE THE PROGRAM "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. THE ENTIRE RISK AS
! TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
! PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
! REPAIR OR CORRECTION.
!
! 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
! WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
! REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
! INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
! OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
! TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
! YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
! PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
! POSSIBILITY OF SUCH DAMAGES.
!
! END OF TERMS AND CONDITIONS
!
!
! How to Apply These Terms to Your New Programs
!
! If you develop a new program, and you want it to be of the greatest
! possible use to the public, the best way to achieve this is to make it
! free software which everyone can redistribute and change under these terms.
!
! To do so, attach the following notices to the program. It is safest
! to attach them to the start of each source file to most effectively
! convey the exclusion of warranty; and each file should have at least
! the "copyright" line and a pointer to where the full notice is found.
!
! <one line to give the program's name and a brief idea of what it does.>
! Copyright (C) <year> <name of author>
!
! This program is free software; you can redistribute it and/or modify
! it under the terms of the GNU General Public License as published by
! the Free Software Foundation; either version 2 of the License, or
! (at your option) any later version.
!
! This program is distributed in the hope that it will be useful,
! but WITHOUT ANY WARRANTY; without even the implied warranty of
! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
! GNU General Public License for more details.
!
! You should have received a copy of the GNU General Public License
! along with this program; if not, write to the Free Software
! Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
!
!
! Also add information on how to contact you by electronic and paper mail.
!
! If the program is interactive, make it output a short notice like this
! when it starts in an interactive mode:
!
! Gnomovision version 69, Copyright (C) year name of author
! Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
! This is free software, and you are welcome to redistribute it
! under certain conditions; type `show c' for details.
!
! The hypothetical commands `show w' and `show c' should show the appropriate
! parts of the General Public License. Of course, the commands you use may
! be called something other than `show w' and `show c'; they could even be
! mouse-clicks or menu items--whatever suits your program.
!
! You should also get your employer (if you work as a programmer) or your
! school, if any, to sign a "copyright disclaimer" for the program, if
! necessary. Here is a sample; alter the names:
!
! Yoyodyne, Inc., hereby disclaims all copyright interest in the program
! `Gnomovision' (which makes passes at compilers) written by James Hacker.
!
! <signature of Ty Coon>, 1 April 1989
! Ty Coon, President of Vice
!
! This General Public License does not permit incorporating your program into
! proprietary programs. If your program is a subroutine library, you may
! consider it more useful to permit linking proprietary applications with the
! library. If this is what you want to do, use the GNU Library General
! Public License instead of this License.
!
--- 1,346 ----
! GNU GENERAL PUBLIC LICENSE
! Version 2, June 1991
!
! Copyright (C) 1989, 1991 Free Software Foundation, Inc.
! 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
! Everyone is permitted to copy and distribute verbatim copies
! of this license document, but changing it is not allowed.
!
! Preamble
!
! The licenses for most software are designed to take away your
! freedom to share and change it. By contrast, the GNU General Public
! License is intended to guarantee your freedom to share and change free
! software--to make sure the software is free for all its users. This
! General Public License applies to most of the Free Software
! Foundation's software and to any other program whose authors commit to
! using it. (Some other Free Software Foundation software is covered by
! the GNU Library General Public License instead.) You can apply it to
! your programs, too.
!
! When we speak of free software, we are referring to freedom, not
! price. Our General Public Licenses are designed to make sure that you
! have the freedom to distribute copies of free software (and charge for
! this service if you wish), that you receive source code or can get it
! if you want it, that you can change the software or use pieces of it
! in new free programs; and that you know you can do these things.
!
! To protect your rights, we need to make restrictions that forbid
! anyone to deny you these rights or to ask you to surrender the rights.
! These restrictions translate to certain responsibilities for you if you
! distribute copies of the software, or if you modify it.
!
! For example, if you distribute copies of such a program, whether
! gratis or for a fee, you must give the recipients all the rights that
! you have. You must make sure that they, too, receive or can get the
! source code. And you must show them these terms so they know their
! rights.
!
! We protect your rights with two steps: (1) copyright the software, and
! (2) offer you this license which gives you legal permission to copy,
! distribute and/or modify the software.
!
! Also, for each author's protection and ours, we want to make certain
! that everyone understands that there is no warranty for this free
! software. If the software is modified by someone else and passed on, we
! want its recipients to know that what they have is not the original, so
! that any problems introduced by others will not reflect on the original
! authors' reputations.
!
! Finally, any free program is threatened constantly by software
! patents. We wish to avoid the danger that redistributors of a free
! program will individually obtain patent licenses, in effect making the
! program proprietary. To prevent this, we have made it clear that any
! patent must be licensed for everyone's free use or not licensed at all.
!
! The precise terms and conditions for copying, distribution and
! modification follow.
!
!
! GNU GENERAL PUBLIC LICENSE
! TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
!
! 0. This License applies to any program or other work which contains
! a notice placed by the copyright holder saying it may be distributed
! under the terms of this General Public License. The "Program", below,
! refers to any such program or work, and a "work based on the Program"
! means either the Program or any derivative work under copyright law:
! that is to say, a work containing the Program or a portion of it,
! either verbatim or with modifications and/or translated into another
! language. (Hereinafter, translation is included without limitation in
! the term "modification".) Each licensee is addressed as "you".
!
! Activities other than copying, distribution and modification are not
! covered by this License; they are outside its scope. The act of
! running the Program is not restricted, and the output from the Program
! is covered only if its contents constitute a work based on the
! Program (independent of having been made by running the Program).
! Whether that is true depends on what the Program does.
!
! 1. You may copy and distribute verbatim copies of the Program's
! source code as you receive it, in any medium, provided that you
! conspicuously and appropriately publish on each copy an appropriate
! copyright notice and disclaimer of warranty; keep intact all the
! notices that refer to this License and to the absence of any warranty;
! and give any other recipients of the Program a copy of this License
! along with the Program.
!
! You may charge a fee for the physical act of transferring a copy, and
! you may at your option offer warranty protection in exchange for a fee.
!
! 2. You may modify your copy or copies of the Program or any portion
! of it, thus forming a work based on the Program, and copy and
! distribute such modifications or work under the terms of Section 1
! above, provided that you also meet all of these conditions:
!
! a) You must cause the modified files to carry prominent notices
! stating that you changed the files and the date of any change.
!
! b) You must cause any work that you distribute or publish, that in
! whole or in part contains or is derived from the Program or any
! part thereof, to be licensed as a whole at no charge to all third
! parties under the terms of this License.
!
! c) If the modified program normally reads commands interactively
! when run, you must cause it, when started running for such
! interactive use in the most ordinary way, to print or display an
! announcement including an appropriate copyright notice and a
! notice that there is no warranty (or else, saying that you provide
! a warranty) and that users may redistribute the program under
! these conditions, and telling the user how to view a copy of this
! License. (Exception: if the Program itself is interactive but
! does not normally print such an announcement, your work based on
! the Program is not required to print an announcement.)
!
!
! These requirements apply to the modified work as a whole. If
! identifiable sections of that work are not derived from the Program,
! and can be reasonably considered independent and separate works in
! themselves, then this License, and its terms, do not apply to those
! sections when you distribute them as separate works. But when you
! distribute the same sections as part of a whole which is a work based
! on the Program, the distribution of the whole must be on the terms of
! this License, whose permissions for other licensees extend to the
! entire whole, and thus to each and every part regardless of who wrote it.
!
! Thus, it is not the intent of this section to claim rights or contest
! your rights to work written entirely by you; rather, the intent is to
! exercise the right to control the distribution of derivative or
! collective works based on the Program.
!
! In addition, mere aggregation of another work not based on the Program
! with the Program (or with a work based on the Program) on a volume of
! a storage or distribution medium does not bring the other work under
! the scope of this License.
!
! 3. You may copy and distribute the Program (or a work based on it,
! under Section 2) in object code or executable form under the terms of
! Sections 1 and 2 above provided that you also do one of the following:
!
! a) Accompany it with the complete corresponding machine-readable
! source code, which must be distributed under the terms of Sections
! 1 and 2 above on a medium customarily used for software interchange; or,
!
! b) Accompany it with a written offer, valid for at least three
! years, to give any third party, for a charge no more than your
! cost of physically performing source distribution, a complete
! machine-readable copy of the corresponding source code, to be
! distributed under the terms of Sections 1 and 2 above on a medium
! customarily used for software interchange; or,
!
! c) Accompany it with the information you received as to the offer
! to distribute corresponding source code. (This alternative is
! allowed only for noncommercial distribution and only if you
! received the program in object code or executable form with such
! an offer, in accord with Subsection b above.)
!
! The source code for a work means the preferred form of the work for
! making modifications to it. For an executable work, complete source
! code means all the source code for all modules it contains, plus any
! associated interface definition files, plus the scripts used to
! control compilation and installation of the executable. However, as a
! special exception, the source code distributed need not include
! anything that is normally distributed (in either source or binary
! form) with the major components (compiler, kernel, and so on) of the
! operating system on which the executable runs, unless that component
! itself accompanies the executable.
!
! If distribution of executable or object code is made by offering
! access to copy from a designated place, then offering equivalent
! access to copy the source code from the same place counts as
! distribution of the source code, even though third parties are not
! compelled to copy the source along with the object code.
!
!
! 4. You may not copy, modify, sublicense, or distribute the Program
! except as expressly provided under this License. Any attempt
! otherwise to copy, modify, sublicense or distribute the Program is
! void, and will automatically terminate your rights under this License.
! However, parties who have received copies, or rights, from you under
! this License will not have their licenses terminated so long as such
! parties remain in full compliance.
!
! 5. You are not required to accept this License, since you have not
! signed it. However, nothing else grants you permission to modify or
! distribute the Program or its derivative works. These actions are
! prohibited by law if you do not accept this License. Therefore, by
! modifying or distributing the Program (or any work based on the
! Program), you indicate your acceptance of this License to do so, and
! all its terms and conditions for copying, distributing or modifying
! the Program or works based on it.
!
! 6. Each time you redistribute the Program (or any work based on the
! Program), the recipient automatically receives a license from the
! original licensor to copy, distribute or modify the Program subject to
! these terms and conditions. You may not impose any further
! restrictions on the recipients' exercise of the rights granted herein.
! You are not responsible for enforcing compliance by third parties to
! this License.
!
! 7. If, as a consequence of a court judgment or allegation of patent
! infringement or for any other reason (not limited to patent issues),
! conditions are imposed on you (whether by court order, agreement or
! otherwise) that contradict the conditions of this License, they do not
! excuse you from the conditions of this License. If you cannot
! distribute so as to satisfy simultaneously your obligations under this
! License and any other pertinent obligations, then as a consequence you
! may not distribute the Program at all. For example, if a patent
! license would not permit royalty-free redistribution of the Program by
! all those who receive copies directly or indirectly through you, then
! the only way you could satisfy both it and this License would be to
! refrain entirely from distribution of the Program.
!
! If any portion of this section is held invalid or unenforceable under
! any particular circumstance, the balance of the section is intended to
! apply and the section as a whole is intended to apply in other
! circumstances.
!
! It is not the purpose of this section to induce you to infringe any
! patents or other property right claims or to contest validity of any
! such claims; this section has the sole purpose of protecting the
! integrity of the free software distribution system, which is
! implemented by public license practices. Many people have made
! generous contributions to the wide range of software distributed
! through that system in reliance on consistent application of that
! system; it is up to the author/donor to decide if he or she is willing
! to distribute software through any other system and a licensee cannot
! impose that choice.
!
! This section is intended to make thoroughly clear what is believed to
! be a consequence of the rest of this License.
!
!
! 8. If the distribution and/or use of the Program is restricted in
! certain countries either by patents or by copyrighted interfaces, the
! original copyright holder who places the Program under this License
! may add an explicit geographical distribution limitation excluding
! those countries, so that distribution is permitted only in or among
! countries not thus excluded. In such case, this License incorporates
! the limitation as if written in the body of this License.
!
! 9. The Free Software Foundation may publish revised and/or new versions
! of the General Public License from time to time. Such new versions will
! be similar in spirit to the present version, but may differ in detail to
! address new problems or concerns.
!
! Each version is given a distinguishing version number. If the Program
! specifies a version number of this License which applies to it and "any
! later version", you have the option of following the terms and conditions
! either of that version or of any later version published by the Free
! Software Foundation. If the Program does not specify a version number of
! this License, you may choose any version ever published by the Free Software
! Foundation.
!
! 10. If you wish to incorporate parts of the Program into other free
! programs whose distribution conditions are different, write to the author
! to ask for permission. For software which is copyrighted by the Free
! Software Foundation, write to the Free Software Foundation; we sometimes
! make exceptions for this. Our decision will be guided by the two goals
! of preserving the free status of all derivatives of our free software and
! of promoting the sharing and reuse of software generally.
!
! NO WARRANTY
!
! 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
! FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
! OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
! PROVIDE THE PROGRAM "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. THE ENTIRE RISK AS
! TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
! PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
! REPAIR OR CORRECTION.
!
! 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
! WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
! REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
! INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
! OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
! TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
! YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
! PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
! POSSIBILITY OF SUCH DAMAGES.
!
! END OF TERMS AND CONDITIONS
!
!
! How to Apply These Terms to Your New Programs
!
! If you develop a new program, and you want it to be of the greatest
! possible use to the public, the best way to achieve this is to make it
! free software which everyone can redistribute and change under these terms.
!
! To do so, attach the following notices to the program. It is safest
! to attach them to the start of each source file to most effectively
! convey the exclusion of warranty; and each file should have at least
! the "copyright" line and a pointer to where the full notice is found.
!
! <one line to give the program's name and a brief idea of what it does.>
! Copyright (C) <year> <name of author>
!
! This program is free software; you can redistribute it and/or modify
! it under the terms of the GNU General Public License as published by
! the Free Software Foundation; either version 2 of the License, or
! (at your option) any later version.
!
! This program is distributed in the hope that it will be useful,
! but WITHOUT ANY WARRANTY; without even the implied warranty of
! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
! GNU General Public License for more details.
!
! You should have received a copy of the GNU General Public License
! along with this program; if not, write to the Free Software
! Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
!
!
! Also add information on how to contact you by electronic and paper mail.
!
! If the program is interactive, make it output a short notice like this
! when it starts in an interactive mode:
!
! Gnomovision version 69, Copyright (C) year name of author
! Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
! This is free software, and you are welcome to redistribute it
! under certain conditions; type `show c' for details.
!
! The hypothetical commands `show w' and `show c' should show the appropriate
! parts of the General Public License. Of course, the commands you use may
! be called something other than `show w' and `show c'; they could even be
! mouse-clicks or menu items--whatever suits your program.
!
! You should also get your employer (if you work as a programmer) or your
! school, if any, to sign a "copyright disclaimer" for the program, if
! necessary. Here is a sample; alter the names:
!
! Yoyodyne, Inc., hereby disclaims all copyright interest in the program
! `Gnomovision' (which makes passes at compilers) written by James Hacker.
!
! <signature of Ty Coon>, 1 April 1989
! Ty Coon, President of Vice
!
! This General Public License does not permit incorporating your program into
! proprietary programs. If your program is a subroutine library, you may
! consider it more useful to permit linking proprietary applications with the
! library. If this is what you want to do, use the GNU Library General
! Public License instead of this License.
!
Index: macros.txt
===================================================================
RCS file: /cvsroot/tn5250j/tn5250j/src/macros.txt,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -C2 -d -r1.1.1.1 -r1.2
*** macros.txt 10 Apr 2002 19:44:55 -0000 1.1.1.1
--- macros.txt 16 Jun 2005 04:41:16 -0000 1.2
***************
*** 1,337 ****
! Macros README
! ------------------------------------------------------------------------------
!
! This version of the emulator will allow the recording of macros. There is
! still no way to remove macros or assign them to function keys yet. This will
! hopefully be done in the future. Unless someone wants to take a stab at it
! themselves. I will be more than happy to put anybody elses code in that fixes
! my mess.
!
! This is an update and the following part is to be followed for recording macros.
!
! Accessing, Recording and executing macros
! =========================================
!
! Right click on session screen pulls up a menu as follows:
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > :
! :---------------------:
! : Connect/Disconnect :
! :=====================:
!
! After getting the popup menu you will see an option for macros if you have
! followed the explanation above. When you place your cursor over the Macros
! item a list of all available macros will appear.
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > ::=====================:
! :---------------------:: Record... :
! : Connect/Disconnect ::---------------------:
! :=====================:: WRKACTJOB_BY_USER :
! :=====================:
!
! Clicking on Record will then prompt you with text box asking for the name of
! the macro. ** NOTE ** This can not contain blanks.
!
! 1) Start entering your information as you would normally.
! 2) When you are finish right click mouse and the following popup will be
! presented.
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > ::=====================:
! :---------------------:: Stop Recording :
! : Connect/Disconnect ::---------------------:
! :=====================:: WRKACTJOB_BY_USER :
! :=====================:
!
! 3) Select the option Stop Recording menu option.
!
! 4) Proceed to the following with right click and clicking on one of the submenu
! items will activate and execute the macro.
!
!
! NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE
! ================================================================================
! The following is deprecated unless you want to set macros up by hand or delete
! any previously setup macros.
! ================================================================================
! NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE
!
! So let's begin:
!
! First; create a file called macros in your emulator working path. You can use
! your favorite editor to do this but make sure you create it as a text file.
!
! Second; define your macros:
!
! The format of the macros file is as follows:
!
! Macro key = Keys to send to the emulator
! ------------------------ ------------------------------------------
! macro1.WRKACTJOB_BY_USER=wrkactjob[enter][nextword][nextword][pf16]
!
! Where:
!
! Macro Key -
! 1) Starts with macro# where # is a sequential number of the macro.
! For example the previous would is macro1 the next macro2 the next
! macro3 .... You get the idea.
!
! You do not have to keep the sequence for example:
! macro10
! macro20
! macro30
! macro40
!
! 2) The period '.' is required
!
! 3) A description that will be displayed. ** NOTE ** this can not
! contain blanks.
!
! Equals '=' - This indicates that the key is finished and the next will be
! the actual key(s)/commands of the macro.
!
! Keys to send - This is the key strokes and command mnemonics to be sent to the
! host for processing.
!
! The following defines the command mnemonics that can be sent to the
! host.
!
! Description Host command value
! --------------- ------------------
! BACK_SPACE [backspace]
! BACK_TAB [backtab]
! BEGIN_OF_FIELD [bof]
! CLEAR [clear]
! DELETE [delete]
! DOWN [down]
! COPY [copy]
! END_OF_FIELD [eof]
! ENTER [enter]
! ERASE_EOF [eraseeof]
! ERASE_FIELD [erasefld]
! FIELD_EXIT [fldext]
! FIELD_MINUS [field-]
! FIELD_PLUS [field+]
! HELP [help]
! HOME [home]
! INSERT [insert]
! KEYPAD_COMMA [keypad,]
! KEYPAD_MINUS [keypad-]
! KEYPAD_PERIOD [keypad.]
! KEYPAD0 [keypad0]
! KEYPAD1 [keypad1]
! KEYPAD2 [keypad2]
! KEYPAD3 [keypad3]
! KEYPAD4 [keypad4]
! KEYPAD5 [keypad5]
! KEYPAD6 [keypad6]
! KEYPAD7 [keypad7]
! KEYPAD8 [keypad8]
! KEYPAD9 [keypad9]
! LEFT [left]
! NEXT_WORD [nextword]
! PA1 [pa1]
! PA2 [pa2]
! PA3 [pa3]
! PASTE [paste]
! PAGE_DOWN [pgdown]
! PAGE_UP [pgup]
! PF1 [pf1]
! PF10 [pf10]
! PF11 [pf11]
! PF12 [pf12]
! PF13 [pf13]
! PF14 [pf14]
! PF15 [pf15]
! PF16 [pf16]
! PF17 [pf17]
! PF18 [pf18]
! PF19 [pf19]
! PF2 [pf2]
! PF20 [pf20]
! PF21 [pf21]
! PF22 [pf22]
! PF23 [pf23]
! PF24 [pf24]
! PF3 [pf3]
! PF4 [pf4]
! PF5 [pf5]
! PF6 [pf6]
! PF7 [pf7]
! PF8 [pf8]
! PF9 [pf9]
! PREVIOUS_WORD [prevword]
! PRINT [print]
! RESET [reset]
! RIGHT [right]
! SYSREQ [sysreq]
! TAB [tab]
! UP [up]
!
! Example:
! ========
! What we want to achieve here is is a macro that will show the jobs in the system
! sorted by the user.
!
! Lets take the following example and break it up into its parts.
!
! macro1.WRKACTJOB_BY_USER=wrkactjob[enter][nextword][nextword][pf16]
!
! macro1.WRKACTJOB_BY_USER=
! This is the macro# with sequential number of one (1) followed by the required
! period, description and equals sign terminating the key and macro description.
!
! wrkactjob[enter][nextword][nextword][pf16]
! This is actually what will be sent to the cursor position on the screen.
!
! 1) "wrkactjob" is the command to display the active jobs in the system
!
! 2) [enter] will be sent to the host to process the wrkactjob command
!
! 3) [nextword] will place the cursor on the next word of the display under
! the column Subsystem/Job
!
! 4) [nextword] will place the cursor on the next word of the display so that
! at the end of this command mnemonic the cursor is sitting under the
! column User
!
! Type options, press Enter.
! 2=Change 3=Hold 4=End 5=Work with 6=Release 7=Display message
! 8=Work with spooled files 13=Disconnect ...
!
! Opt Subsystem/Job User Type CPU % Function Status
! X
!
! Cursor should be here where X marks the spot.
!
! 5) [pf16] will then be sent to the host to tell it to sort the active jobs
! by user.
!
!
! Accessing and executing macros
! ==============================
!
! Right click on session screen pulls up a menu as follows:
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > :
! :---------------------:
! : Connect/Disconnect :
! :=====================:
!
! After getting the popup menu you will see an option for macros if you have
! followed the explanation above. When you place your cursor over the Macros
! item a list of all available macros will appear.
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > ::=====================:
! :---------------------:: WRKACTJOB_BY_USER :
! : Connect/Disconnect ::=====================:
! :=====================:
!
!
! Clicking on one of the submenu items will activate and execute the macro.
!
! That is all there is to it.
!
! If you have any questions or suggestions please let me know.
!
! ** NOTE *** this is only a work around until I can get a record function to
! interactively define the macros.
!
!
!
! Enjoy!!!
!
--- 1,337 ----
! Macros README
! ------------------------------------------------------------------------------
!
! This version of the emulator will allow the recording of macros. There is
! still no way to remove macros or assign them to function keys yet. This will
! hopefully be done in the future. Unless someone wants to take a stab at it
! themselves. I will be more than happy to put anybody elses code in that fixes
! my mess.
!
! This is an update and the following part is to be followed for recording macros.
!
! Accessing, Recording and executing macros
! =========================================
!
! Right click on session screen pulls up a menu as follows:
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > :
! :---------------------:
! : Connect/Disconnect :
! :=====================:
!
! After getting the popup menu you will see an option for macros if you have
! followed the explanation above. When you place your cursor over the Macros
! item a list of all available macros will appear.
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > ::=====================:
! :---------------------:: Record... :
! : Connect/Disconnect ::---------------------:
! :=====================:: WRKACTJOB_BY_USER :
! :=====================:
!
! Clicking on Record will then prompt you with text box asking for the name of
! the macro. ** NOTE ** This can not contain blanks.
!
! 1) Start entering your information as you would normally.
! 2) When you are finish right click mouse and the following popup will be
! presented.
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > ::=====================:
! :---------------------:: Stop Recording :
! : Connect/Disconnect ::---------------------:
! :=====================:: WRKACTJOB_BY_USER :
! :=====================:
!
! 3) Select the option Stop Recording menu option.
!
! 4) Proceed to the following with right click and clicking on one of the submenu
! items will activate and execute the macro.
!
!
! NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE
! ================================================================================
! The following is deprecated unless you want to set macros up by hand or delete
! any previously setup macros.
! ================================================================================
! NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE
!
! So let's begin:
!
! First; create a file called macros in your emulator working path. You can use
! your favorite editor to do this but make sure you create it as a text file.
!
! Second; define your macros:
!
! The format of the macros file is as follows:
!
! Macro key = Keys to send to the emulator
! ------------------------ ------------------------------------------
! macro1.WRKACTJOB_BY_USER=wrkactjob[enter][nextword][nextword][pf16]
!
! Where:
!
! Macro Key -
! 1) Starts with macro# where # is a sequential number of the macro.
! For example the previous would is macro1 the next macro2 the next
! macro3 .... You get the idea.
!
! You do not have to keep the sequence for example:
! macro10
! macro20
! macro30
! macro40
!
! 2) The period '.' is required
!
! 3) A description that will be displayed. ** NOTE ** this can not
! contain blanks.
!
! Equals '=' - This indicates that the key is finished and the next will be
! the actual key(s)/commands of the macro.
!
! Keys to send - This is the key strokes and command mnemonics to be sent to the
! host for processing.
!
! The following defines the command mnemonics that can be sent to the
! host.
!
! Description Host command value
! --------------- ------------------
! BACK_SPACE [backspace]
! BACK_TAB [backtab]
! BEGIN_OF_FIELD [bof]
! CLEAR [clear]
! DELETE [delete]
! DOWN [down]
! COPY [copy]
! END_OF_FIELD [eof]
! ENTER [enter]
! ERASE_EOF [eraseeof]
! ERASE_FIELD [erasefld]
! FIELD_EXIT [fldext]
! FIELD_MINUS [field-]
! FIELD_PLUS [field+]
! HELP [help]
! HOME [home]
! INSERT [insert]
! KEYPAD_COMMA [keypad,]
! KEYPAD_MINUS [keypad-]
! KEYPAD_PERIOD [keypad.]
! KEYPAD0 [keypad0]
! KEYPAD1 [keypad1]
! KEYPAD2 [keypad2]
! KEYPAD3 [keypad3]
! KEYPAD4 [keypad4]
! KEYPAD5 [keypad5]
! KEYPAD6 [keypad6]
! KEYPAD7 [keypad7]
! KEYPAD8 [keypad8]
! KEYPAD9 [keypad9]
! LEFT [left]
! NEXT_WORD [nextword]
! PA1 [pa1]
! PA2 [pa2]
! PA3 [pa3]
! PASTE [paste]
! PAGE_DOWN [pgdown]
! PAGE_UP [pgup]
! PF1 [pf1]
! PF10 [pf10]
! PF11 [pf11]
! PF12 [pf12]
! PF13 [pf13]
! PF14 [pf14]
! PF15 [pf15]
! PF16 [pf16]
! PF17 [pf17]
! PF18 [pf18]
! PF19 [pf19]
! PF2 [pf2]
! PF20 [pf20]
! PF21 [pf21]
! PF22 [pf22]
! PF23 [pf23]
! PF24 [pf24]
! PF3 [pf3]
! PF4 [pf4]
! PF5 [pf5]
! PF6 [pf6]
! PF7 [pf7]
! PF8 [pf8]
! PF9 [pf9]
! PREVIOUS_WORD [prevword]
! PRINT [print]
! RESET [reset]
! RIGHT [right]
! SYSREQ [sysreq]
! TAB [tab]
! UP [up]
!
! Example:
! ========
! What we want to achieve here is is a macro that will show the jobs in the system
! sorted by the user.
!
! Lets take the following example and break it up into its parts.
!
! macro1.WRKACTJOB_BY_USER=wrkactjob[enter][nextword][nextword][pf16]
!
! macro1.WRKACTJOB_BY_USER=
! This is the macro# with sequential number of one (1) followed by the required
! period, description and equals sign terminating the key and macro description.
!
! wrkactjob[enter][nextword][nextword][pf16]
! This is actually what will be sent to the cursor position on the screen.
!
! 1) "wrkactjob" is the command to display the active jobs in the system
!
! 2) [enter] will be sent to the host to process the wrkactjob command
!
! 3) [nextword] will place the cursor on the next word of the display under
! the column Subsystem/Job
!
! 4) [nextword] will place the cursor on the next word of the display so that
! at the end of this command mnemonic the cursor is sitting under the
! column User
!
! Type options, press Enter.
! 2=Change 3=Hold 4=End 5=Work with 6=Release 7=Display message
! 8=Work with spooled files 13=Disconnect ...
!
! Opt Subsystem/Job User Type CPU % Function Status
! X
!
! Cursor should be here where X marks the spot.
!
! 5) [pf16] will then be sent to the host to tell it to sort the active jobs
! by user.
!
!
! Accessing and executing macros
! ==============================
!
! Right click on session screen pulls up a menu as follows:
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > :
! :---------------------:
! : Connect/Disconnect :
! :=====================:
!
! After getting the popup menu you will see an option for macros if you have
! followed the explanation above. When you place your cursor over the Macros
! item a list of all available macros will appear.
!
! :=====================:
! : Copy :
! : Paste :
! : Paste Special :
! :---------------------:
! : Selected Columns XX :
! : Selected Rows XX :
! :---------------------:
! : Print Screen :
! :---------------------:
! : System Request :
! : Help :
! : Host Print :
! : Display Messages :
! :---------------------:
! : Hex Map :
! : Map Keys... :
! : Settings... :
! :---------------------:
! : Macros > ::=====================:
! :---------------------:: WRKACTJOB_BY_USER :
! : Connect/Disconnect ::=====================:
! :=====================:
!
!
! Clicking on one of the submenu items will activate and execute the macro.
!
! That is all there is to it.
!
! If you have any questions or suggestions please let me know.
!
! ** NOTE *** this is only a work around until I can get a record function to
! interactively define the macros.
!
!
!
! Enjoy!!!
!
-------------------------------------------------------
SF.Net email is sponsored by: Discover Easy Linux Migration Strategies
from IBM. Find simple to follow Roadmaps, straightforward articles,
informative Webcasts and more! Get everything you need to get up to
speed, fast. http://ads.osdn.com/?ad_id=7477&alloc_id=16492&op=click