@DATABASE "NewChange.guide"
@AUTHOR "Martin Wulffeld"

* $VER: NewChange.guide 1.3 (26.4.97)
* Copyright (C) 1996-1997 Martin Wulffeld

@NODE Main "NewChange guide documentation"
@{b}
                                   NewChange

                    Copyright © 1996-1997 Martin Wulffeld
                             All Rights Reserved

                     Version 1.3 - Release date 26.4.1997
  _________________________________________________________________________
@{ub}

  1. Legal issues

  1.1 - @{" Disclaimer                      " LINK Disclaimer}
  1.2 - @{" License                         " LINK License}

  2. Installation

  2.1 - @{" Installation                    " LINK Installation}
  2.2 - @{" Authenticity                    " LINK Authenticity}

  3. Introduction

  3.1 - @{" Introduction to NewChange       " LINK Introduction}
  3.2 - @{" Getting the newest version      " LINK GettingUpdates}

  4. Usage

  4.1 - @{" General usage                   " LINK Usage}
  4.2 - @{" The menus                       " LINK Menus}
  4.4 - @{" The CLI                         " LINK CLI}

  5. Registration

  5.1 - @{" How to register                 " LINK HowToRegister}
  5.2 - @{" What do I get if I register     " LINK WhatDoIGet}
  5.3 - @{" Registered users of NewChange   " LINK RegisteredUsers}

  6. Miscellaneous

  6.1 - @{" Acknowledgements                " LINK Acknowledgements}
  6.2 - @{" History                         " LINK History}
@ENDNODE

@NODE Disclaimer "Disclaimer"

 @{b}Disclaimer@{ub}

     THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED BY
  APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "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 PROGRAMS IS WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU
  ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

     IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  REDISTRIBUTE THE PROGRAMS 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 PROGRAMS
  (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 PROGRAMS TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
  OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
@ENDNODE

@NODE License "License"

 @{b}License@{ub}

  This license applies to the product called `NewChange', a program for the
  Amiga computer, published by Martin Wulffeld under the concepts of
  SHAREWARE, and the accompanying documentation, example files and
  anything else that comes with the original distribution. The terms
  `program' and `NewChange' below, refer to this product. The licensee is
  addressed as `you'.

   - You may copy and distribute verbatim copies of the program's
     executable code and documentation as you receive it, in any
     medium, provided that you conspicuously and appropriately publish
     only the original, unmodified program, with all copyright notices
     and disclaimers of warranty intact and including all the
     accompanying documentation, example files and anything else that
     came with the original.

   - You may not copy and/or distribute this program without the
     accompanying documentation and other additional files that came
     with the original.  You may not copy and/or distribute modified
     versions of this program.

   - You may not copy, modify, sublicense, distribute or transfer the
     program except as expressly provided under this license.  Any
     attempt otherwise to copy, modify, sublicense, distribute or
     transfer the program is void, and will automatically terminate
     your rights to use the program under this license.  However,
     parties who have received copies, or rights to use copies, from
     you under this license will not have their licenses terminated so
     long as such parties remain in full compliance.

   - By copying, distributing and/or using the program you indicate your
     acceptance of this license to do so, and all its terms and
     conditions.

   - Each time you redistribute the program, the recipient automatically
     receives a license from the original licensor to copy, distribute
     and/or use 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 may not disassemble, decompile, re-source or otherwise reverse
     engineer the program.

   - You may use the program for as long as you want without registering.

   - You agree to cease distributing the program and data involved if
     requested to do so by the author.

   - You may charge a fee to recover distribution costs.  The fee for
     diskette distribution may not be more than the cost to obtain a
     public domain diskette from Fred Fish.
@ENDNODE

@NODE Installation "Installation"

 @{b}Installation@{ub}

  Click on the installer icon to start the installation.

  If you want to manually install NewChange you should simply copy the
  libraries to your @{b}LIBS:@{ub} assign and then install the other files
  wherever you want.
@ENDNODE

@NODE Authenticity "Authenticity"

 @{b}Authenticity@{ub}

  All executables and main documentation are PGP signed with my key
  (below).

  To check if the files are authentic first save the key below to a
  separate file. Start PGP with the filename of that separate file and
  add my key to your keyring. Now you are ready to check the files with
  my key.

  To check a signed file start PGP with the '.sig' file as the first
  argument and as the second argument the file which is related to the
  '.sig' file.

  E.g.: 1:> PGP NewChange.sig NewChange

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: 2.6ui (Amiga)

mQCNAjAWEggAAAEEAMBONVPwDx1sHsnh5Cg8lR7duuVh4I0uT3q/aI1EpqBEUsSp
WGDx0h1JBKWrqBVKR1mT7Wtrm5x4rImTurKsjXtK4hCJHhJXPFj0bxjNiGijDVfq
eEt6Pj2n7sghc/bSMH71sUx8FZEa2//hAAPIL9a5+2CxrFT/OaKcaztHngaFAAUR
tClNYXJ0aW4gV3VsZmZlbGQgPHd1bGZmZWxkQGRhdGFzaG9wcGVyLmRrPokAlQIF
EDEdhyGinGs7R54GhQEBTmgEALsIIEbtKTcRIBx350d3KCHi5iwsu16B6caWbHB1
TjP6i/FM+uBahFLiRVQ4nO3+vJaCPkY4Nz46Lq7EREOf/dDIKCNhQ/9+mGr9colA
RSKWkeo13Y/mrqBXqiRVy/zHfr0Xi7aKcdCFKJz56bU11F1hxYnO5KIPPFI0x368
AWSwiQBVAgUQMDe59PAvc1PolDZ1AQFitAH+JZ90vXfyayYOm+oOnBYpLklwYDin
V+VXyW15cr/ztIbp5qsLtJIdot7ZLGlcreX32dLZ/ZI9+4HZmkBdYbJY8okAlQIF
EDAZt0ks4QNKTF7hCQEBvJsD/RqagFqMHv43qVTqsFh2ZaaLUdgouQaZ/gm4VCOL
aQYL1vRGdXoyq+ENGAmRecqQsh5kZv3sLAvvjG2tjnR5Sz4gbxaC6PMiISRpY7kx
Rx6o7HlYMQr+/UqJcGLadbhrb4pyosvwXmi3VWDRh3ornPYzY58zFh1Dae5bN/pv
mu0K
=wjFw
-----END PGP PUBLIC KEY BLOCK-----
@ENDNODE

@NODE Introduction "Introduction to NewChange"

 @{b}Introduction@{ub}

  NewChange is copyright © 1996 Martin Wulffeld. All Rights Reserved.

  It uses the ReqTools library which is copyright © Nico François.

  NewChange requires at least Kickstart 3.0.

 @{b}Background@{ub}

  I wrote this commodity handler because I was fed up with the old and
  ugly Exchange. I wanted full keyboard support and a command line
  interface and NewChange is the final product. I am quite pleased with
  its functionality and I hope you will be too.
@ENDNODE

@NODE GettingUpdates "Getting updates of NewChange"

 @{b}Getting updates@{ub}

  Whenever a new version of NewChange is released it will be found on:

   - @{b}Mister O@{ub}:

     Node #1 +45 39664623 24H USR 33K6
     Node #2 +45 39664624 24H USR 33K6
     Node #3 +45 39551977 24H Lasat 28K8
     Node #4 +45 39551978 ISDN and voice

   - @{b}My homepage at@{ub}:
   
     http://www.geocities.com/SiliconValley/Heights/7222

   - On @{b}Aminet@{ub} in the 'util/cdity' directory.
@ENDNODE

@NODE Usage "How to use NewChange"

 @{b}Usage@{ub}

  @{b}Starting@{ub}

   To start NewChange click on its icon or start it from a Shell. If it is
   the very first time you start NewChange you should see its interface
   (GUI). If not you might have configured it not to pop up at start.
   Therefore, you have to press the popkey which by default is 'control
   alt help'. If this also does not work it is possible that you have
   changed the popkey sequence. The settings file 'NewChange.prefs'
   located in 'ENVARC:NewChange/' is readable ASCII so you can as a last
   resort find the popkey sequence there. Just locate the line with the
   CXPOPKEY and find out what the popkey is.
   
  @{b}GUI@{ub}
  
   Scrolling in the listview is possible by using the keyboard. This is
   one the features that the original Exchange did not have and inspired
   me to code NewChange.

   Use the up and down cursor keys to move the current selected entry. By
   holding down 'alt' you will scroll two times. Hold down 'shift' a page
   will be scrolled. Use 'control' to move to either the top or bottom.

   You should at once become familiar with the buttons to the right side
   of the listview. They have the exact same function as the original
   Exchange.
@ENDNODE  

@NODE Menus "The menus"

 @{b}Menus@{ub}

  @{" Project     " LINK MENU_Project}
  @{" Commodities " LINK MENU_Commodities}
  @{" Settings    " LINK MENU_Settings}
@ENDNODE  

@NODE MENU_Project "Project menu"

 @{b}The project menu@{ub}

  @{" Hide                   " LINK MI_Hide}

  @{" About                  " LINK MI_About}

  @{" Quit                   " LINK MI_Quit}
@ENDNODE  

@NODE MENU_Commodities "Commodities menu"

 @{b}The commodities menu@{ub}

  @{" Activate all   " LINK MI_ActivateAll}
  @{" Deactivate all " LINK MI_DeactivateAll}

  @{" Remove all     " LINK MI_RemoveAll}
@ENDNODE

@NODE MENU_Settings "Settings menu"

 @{b}The settings menu@{ub}

  @{" Edit... " LINK MI_Edit}

  @{" Save...          " LINK MI_SaveSettings}
@ENDNODE

@NODE MI_Hide "Project menu"

 @{b}Hide@{ub}

  Hides the interface. Press the popkey to make it appear.
@ENDNODE

@NODE MI_About "Project menu"

 @{b}About@{ub}

  Miscellaneous information on NewChange.
@ENDNODE

@NODE MI_Quit "Project menu"

 @{b}Quit@{ub}

  Quits NewChange. If settings have been changed and you have not saved them a
  requester will inform you about that and give you the possibility to
  either Save them, Quit or (only in some cases) Cancel quit.
@ENDNODE

@NODE MI_ActivateAll "Commodities menu"

 @{b}Activate all@{ub}

  Tries to activate all commodities. Most commodities will be affected,
  others not. Do not expect too much from this commodity feature.
@ENDNODE

@NODE MI_DeactivateAll "Commodities menu"

 @{b}Deactivate all@{ub}

  Tries to deactivate all commodities. Most commodities will be affected,
  others not. Do not expect too much from this commodity feature.
@ENDNODE

@NODE MI_RemoveAll "Commodities menu"

 @{b}Remove all@{ub}

  Tries to remove all commodities. Some commodities were perhaps not able
  to remove themselves so don't blame me if they still hang around :)
@ENDNODE

@NODE MI_Edit "Settings menu"

 @{b}Edit@{ub}

  Pressing @{b}Okay@{ub} affects NewChange immediately. Pressing @{b}Cancel@{ub} will abort
  the changes you have made.

  @{b}Minimum visible@{ub}

   Specifies the minimum number of commodities which should be shown in
   the listview.

  @{b}Listview scroller width@{ub}

   The width of the scroller in the listview.

  @{b}Doubleclick@{ub}

   Represents the action that will be performed when you doubleclick on a
   commodity in the listview.

    @{fg highlight}Show interface@{fg text}

     NewChange will try to show the commodity's interface. Not all
     commoditys has support for this function. You can see if it has by
     checking the state of the Show/Hide interface buttons to the right of
     the listview. If they are ghosted there is not support for interface
     functions.

    @{fg highlight}Hide interface@{fg text}

     NewChange will try to hide the commodity's interface. See above for
     further information.

    @{fg highlight}Toggle@{fg text}

     NewChange will toggle the activated state. If the commodity is
     activated it will be deactivated and so forth.

    @{fg highlight}Remove@{fg text}

     NewChange will try to remove the commodity.

    @{fg highlight}Nothing@{fg text}

     Nothing will happen.

  @{b}Return@{ub}

   Represents the action that will be performed when you press return
   while having selected a commodity in the listview.

   See above for a detailed description of the actions.

  @{b}Popkey@{ub}

   The popkey for NewChange. The default is 'control alt help'.

  @{b}Priority@{ub}
  
   This is the priority of the commodity.

  @{b}Pop up at start@{ub}

   If ticked NewChange will open its window when it is started. But if you
   have put NewChange in your WBStartup drawer you might not want it to
   pop up all the time. In that case you should not tick this option.
@ENDNODE

@NODE MI_SaveSettings "Settings menu"

 @{b}Save@{ub}

  Save settings. Settings are saved to 'ENV:NewChange/NewChange.prefs' and
  'ENVARC:NewChange/NewChange.prefs'.
@ENDNODE

@NODE CLI "The CLI"

 @{b}The CLI@{ub}

  You can type 'NewChange ?' to see the command line interface of NewChange.

  It looks like this:

  S=SHOW/K,H=HIDE/K,R=REMOVE/K,A=ACTIVATE/K,D=DEACTIVATE/K,T=TOGGLE/K,
  L=LIST/S,Q=QUIT/S

   @{b}SHOW@{ub} abbreviated S
   
    The commodities you want to show. You must write the name that is
    shown in the listview of NewChange.
   
    If you want to show more than one commodity you must separate the
    names with a vertical bar '|'.

    For example if you want to show PowerSnap and NewMenu you would at the
    command line write:
   
     NewChange S PowerSnap|NewMenu
   
   @{b}HIDE@{ub} abbreviated H

    The commodities you want to hide. You must write the name that is
    shown in the listview of NewChange and not the name of the program.
   
    If you want to hide more than one commodity you must separate the
    names with a vertical bar '|'.

    For example if you want to hide PowerSnap and NewMenu you would at the
    command line write:
   
     NewChange H PowerSnap|NewMenu
   
   @{b}REMOVE@{ub} abbreviated R

    The commodities you want to remove. You must write the name that is
    shown in the listview of NewChange and not the name of the program.
   
    If you want to remove more than one commodity you must separate the
    names with a vertical bar '|'.

    For example if you want to remove PowerSnap and NewMenu you would at
    the command line write:
   
     NewChange R PowerSnap|NewMenu
   
   @{b}ACTIVATE@{ub} abbreviated A

    The commodities you want to activate. You must write the name that is
    shown in the listview of NewChange and not the name of the program.
   
    If you want to activate more than one commodity you must separate the
    names with a vertical bar '|'.

    For example if you want to activate PowerSnap and NewMenu you would at
    the command line write:
   
     NewChange A PowerSnap|NewMenu
   
   @{b}DEACTIVATE@{ub} abbreviated D

    The commodities you want to deactivate. You must write the name that
    is shown in the listview of NewChange and not the name of the program.
   
    If you want to deactivate more than one commodity you must separate
    the names with a vertical bar '|'.

    For example if you want to deactivate PowerSnap and NewMenu you would
    at the command line write:
   
     NewChange D PowerSnap|NewMenu
   
   @{b}TOGGLE@{ub} abbreviated T

    The commodities you want to toggle. If a commodity is activated it
    will be deactivated. If it is deactivated it will be activated. You
    must write the name that is shown in the listview of NewChange and not
    the name of the program.
   
    If you want to toggle more than one commodity you must separate the
    names with a vertical bar '|'.

    For example if you want to toggle PowerSnap and NewMenu you would at
    the command line write:
   
     NewChange T PowerSnap|NewMenu
   
   @{b}LIST@{ub} abbreviated L

    Specifying this argument causes NewChange to write a list of the
    current available commodities.
   
   @{b}QUIT@{ub} abbreviated Q

    If you want NewChange to quit right after it has processed the command
    line arguments you should specify QUIT. Handy if you f.x. just want to
    remove a commodity.
@ENDNODE  

@NODE HowToRegister "HowToRegister"

 @{b}How to register NewChange@{ub}

  To register, FIRST fill out the registration form which is included in
  the distribution as @{b}NewChange.regform@{ub} and send it to me to one of the
  addresses below.

  THEN there are 3 ways you can send the registration fee to me.

  @{b}1.@{ub} The first and easiest way (in my opinion) is to send cash to my
     snailmail address below.

     But keep in mind that it is at your own risk if you do that. I cannot
     be responsible for lost letters. But just remember to wrap a piece
     of paper around the cash so the possibly corrupt mailman is unable
     to see what is inside the envelope.

     The registration fee may be one of the following:

       50,- DKR (Danish kroners)
       50,- SKR (Swedish kroners)
       50,- NKR (Norwegian kroners)
       15,- DEM (German D-mark)
       10,- USD (US-Dollars)
        5,- GBP (British pound sterling)

      or the same amount as 50 DKR in any other currency!

     No coins (except Danish) accepted!!

  @{b}2.@{ub} Eurocheque

     Send a Eurocheque payable to 'Martin Wulffeld' with the amount of
     50 DKR (Danish kroners).
     
     If you send any other kind of cheque please include an extra
     50 DKR since the bank charges outrageous fees.

  @{b}3.@{ub} Transfer the equivalent of 50,- DKR to my bank:

      Unibank
      Praestoe Afdeling
      Adelgade 76
      4720 Praestoe
      Denmark

      Name: Martin Wulffeld

      Reg. number:    0047
      Account number: 4482-600-846

  ========================================================================

  ASAP on receipt of your registration I will send a personalized keyfile
  to you on a disk. But things take time so please allow up to 8 weeks for
  delivery, thanks = absolute, extremely worst case. Usually from you
  sending the registration till you get the key will not take more than 2
  weeks.

  Put the keyfile in your L: assign or the path where NewChange is started
  from.

  You may not sell or give away the keyfile. The keyfile will make all
  (future) locked features available to you.

  ========================================================================

  - Snail mail: Martin Wulffeld
                Odensevej 121, 2 TV
                4700 Naestved
                Denmark

  - Internet:   wulffeld@post4.tele.dk

  - IRC:        As @{b}Alive@{ub} usually on Undernet or GalaxyNet.

  - FidoNet:    2:235/332.53

  - AmigaNet:   39:141/124.53

  - Phone:      +45 (55) 77 01 37
@ENDNODE

@NODE WhatDoIGet "What do I get?"

 @{b}If I register what do I get?@{ub}

  - A disk with the latest version of NewChange, Vinci, Xtruder, Leagues
    and other of my recent and noteworthy productions.
@ENDNODE

@NODE RegisteredUsers "Registered users"

 @{b}Registered users@{ub}

  In alphabetical order:

  - Börje Karlsson
@ENDNODE

@NODE Acknowledgements "Acknowledgements"

 @{b}Acknowledgements@{ub}

  Many thanks goes out to the betatesters who have done a great job
  testing NewChange:

   Alex Holst, Jakob Langgaard, Jens Heller Sørensen, Michael Harmsen
   Peter Jensen.

  Also thanks to Stefan Skotte, Uffe Holst, Søren Wind for suggestions.
@ENDNODE

@NODE History "History"

 @{b}History of NewChange@{ub}

  Version:

   @{" 1.0 " LINK VERS_10}
   @{" 1.1 " LINK VERS_11}
   @{" 1.2 " LINK VERS_12}
@ENDNODE

@NODE VERS_10 "Version 1.0  :  27.5.1996  :  24664 bytes"

  - First public release.
@ENDNODE

@NODE VERS_11 "Version 1.1  :   5.8.1996  :  26100 bytes"

 @{b}Changes@{ub}

  - Added @{b}LIST@{ub} CLI argument. @{fg highlight}Michael Harmsen@{fg text}.
  - The name of the control commodity is now NewChange instead of
    Exchange.
  - When the window is zoomed the title bar has a more acceptable width.
  - Added @{"Minimum visible" LINK MI_Edit} feature. I do not like the idea of having a
    sizable gadget since it would be impossible to have NewChange reside as
    a title bar.

 @{b}Bug fixes@{ub}

  - Forgot to update the information box after a window had been unzoomed.
  - If NewChange was hidden and changes in the commodity list occured it
    would cause enforcer hits. @{fg highlight}Alex Holst@{fg text}.
@ENDNODE

@NODE VERS_12 "Version 1.2  :  12.10.1996  :  26124 bytes"

 @{b}Bug fixes@{ub}

  - Fixed loading settings problem. Could not get the popkey correctly.
    @{fg highlight}Henrik Lauridsen@{fg text}.
  - Minor gadget ghost/unghost problem corrected.
@ENDNODE

@NODE VERS_13 "Version 1.3  :  26.4.1997  :  25860 bytes"

 @{b}Notes@{ub}

  - Added Italian, Dutch, Norwegian, Swedish and Finnish catalogs.
@ENDNODE