% jfig/doc/registration.txt  06.01.2003


1. Why should you register?
2. How to get a registration code
3. How to get a free registration code
4. How to use the registration code



------

1) Why should you register jfig?

Developing jfig took a lot of time and effort; answering questions
and bug reports takes even more. On the other hand, less then one
user in a thousand actually provides useful feedback or pays the 
shareware fee.

Therefore, unregistered versions of jfig will now display a "please 
register" dialog window as soon as the editor is used for more than
ten minutes. If you continue to use jfig, the dialog window will be
shown again from time to time, and the timeout delay will increase.

A few features of jfig are disabled in the un-registered version, too.
Registering jfig offers the following benefits:

* avoids your bad conscience for using un-licensed software
* gets rid of the annoying "registration reminder" dialog 
* offers a good opportunity to provide your own personal feedback
* increases your chances to get your questions answered

* layer manager enabled
* Manhattan and LaTeX geometry support for polylines
* mouse wheel support for the attribute controls, e.g. line width, 
  font size, depth, etc.  (requires JDK 1.4+)
* font configuration dialog

  and coming soon:
* interface to the FreeHep library for Java2D export to Postscript
  and PDF 
  






------

2) How to get a jfig registration code:

First, please read the license terms for jfig in menu->help->LICENSE.
If you agree, please send me a short letter with your request for a 
jfig registration code and add a cheque with the registration fee
(currently 30 EUR or 30 USD for a personal license).

Your letter should include the following information:

* your e-mail address (for sending the registration code).
* a cheque or (dollar/euro) bills with the registration fee.
  If sending a cheque, please add 10EUR/10USD for bank fees.

  and optionally:
* please indicate whether you want a receipt.
* your postal address (for sending the receipt and registration code).
* feedback about things you like or dislike about jfig.

For international (especially non-european) registration, you might 
prefer to send the fee in dollar bills instead of a cheque - which is
faster and saves me the very high bank fees for international cheques.
(However, such letters are sometimes lost, so you should use a plain
and sufficiently thick envelope. It is also probably better not to 
indicate "jfig registration" on the envelope...)
On request, I can also send you the IBAN for international money 
transfer.

Please address your letter to:

  Norman Hendrich
  Universitaet Hamburg
  FB Informatik
  Vogt-Koelln-Str. 30
  D-22527 Hamburg
  Germany

Please don't hesitate to contact me if you feel that your 
registration code or receipt is overdue.



------

3) How to get a free registration code:

If you provide useful information about jfig on new platforms,
detailed bug reports, propose new features, or send new code for
integration into jfig, you may receive a free registration code.
Just try it!



------

4) How to use the registration code:

Once you have registered, you will receive your personal registration 
code either per e-mail and/or via s-mail. Then do the following:

  0. If you are already using a personal jfig configuration file in
     your home directory (~/.jfigrc), proceed to step 7 and edit the
     configuration file directly. Otherwise, the following steps might 
     overwrite the contents of your configuration file.

  1. Start the jfig editor normally, e.g. double-click jfig2.jar

  2. Select menu->options->show properties to open the properties viewer.

  3. Browse through the list of properties until you find the entry
     for "jfig.gui.Editor.RegistrationKey".

  4. Replace the default value of "0000-0000-0000-0000-0000-0000" 
     with your personal registration code.

  5. Press the "Save as <home>/.jfigrc" command to write the jfig
     user configuration file to your home directory. 

  6. Exit and restart jfig. It should recognize your registration key
     and unlock all features.

If you already have a configuration file in your home directory, do the
following:

  7. Use your favorite text editor (e.g. emacs, vim, or Wordpad) to open
     your .jfigrc configuration file. Browse to the file and either 
     change or create the "jfig.gui.Editor.RegistrationKey" entry and
     enter your registration code. Save the file, then start jfig.

Please don't distribute your registration code!

Finally, note that adding the registration code to the system (=master)
configuration file (/jfig/jfig.cnf) inside the jfig2.jar archive will 
not work.



