@DATABASE NewPassword_English.guide
@$VER: NewPassword_English.guide 1.9 (12.02.98)
@Author Alexander Lärz
@(C) ©1997-1998

@NODE main "NewPassword Documentation"
@SMARTWRAP
@{b}NewPassword 1.8 @{AMIGAGUIDE}@{ub}


Note that the @{" author's " link AL } native language is german, so
please forgive bad spelling, grammar mistakes and so on. Or better
correct them and contact @{" me " link AL }.


Attention! This guide is designed for the version 40 of the
amigaguide.datatype which is supplied with AmigaOS 3.1. Under other
versions this guide may look very terrible.
@{CODE}

@{" Copyright " link COPYRIGHT}              Copyright and disclamer
@{" Introduction " link INTRO}           What is it ?
@{" Requirements " link REQUIRE}           What does it need ?
@{" Installation " link INSTALL}           How to install ?
@{" Usage " link USAGE}                  How to use ?
@{" Future " link FUTURE }                 What is comeing next ?
@{" History " link HISTORY }                What was done ?
@{" Author " link AL }                 Where to send bug reports ?
@ENDNODE

@NODE COPYRIGHT "Copyright and disclamer"
@SMARTWRAP
@{b}Copyright@{ub}


(c) Copyright 1997-1998 @{" Alexander Lärz " link AL }


NewPassword is Freeware. You can give it to anybody you want as long as
all the files are complete, in an unchanged form and you don't make any
profit with it.


@{b}Standard Disclamer@{ub}


THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDER 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.


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
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.

@ENDNODE

@NODE INTRO "Introduction"
@SMARTWRAP
@{b}Introdution@{ub}


NewPassword is a Password-Protection-Tool for your Amiga.

@{CODE}
Features
  - easy to use
  - shell support
  - ToolType support
  - encode by typing password
  - NewPassword will not appear after a WarmStart when typed in
    correct password
  - encoding the saved password
@ENDNODE

@NODE REQUIRE "Requirements"
@SMARTWRAP
@{b}Requirements@{ub}


NewPassword needs at least Kickstart 3.0 and it should work on every
computer with at least Kickstart 3.0 or higher.
@ENDNODE

@NODE INSTALL "Installation of NewPassword"
@SMARTWRAP
@{b}How to install NewPassword@{ub}


Currently there is no installer script. To install NewPassword simply copy
the whole drawer where you want.
The mainprogramm You could copy to your WBStartup to start it by booting.
You also could add it to your User-Startup (See @{" Usage " link USAGE }).

@ENDNODE

@NODE USAGE "Usage"
@{b}Usage@{ub}

When you start NewPassword you could see a small Window with a StringGadget
and with the text "Change me." in it. You also could see two Buttons named
"OK" and "Save". The Save Button is disabled until you've typed in the
correct Password. When you've typed in the correct Password you could press
the OKButton,the CloseGadget or Enter to quit the programm. Now you also
could change the Password and saves it. When you first start NewPassword
you haven't a saved Passwordfile, so the default Password is "Change Me.",
then you could change your Password and saves it there where you want.
(See @{ " Tooltypes "link TTYPES } or @{ " Shell " link Shell } for change your passwordfile.)
If you haven't defined the Path and the File where your Password will be
saved, the Password will be saved to the default File "Envarc:password.prefs".
It's important, that you delete your prefs-file because the new version of
NewPassword couldn't handle the old files.

 @{" Shell " link SHELL }
 @{" Tooltypes " link TTYPES }

@ENDNODE

@NODE SHELL "Shell"
@{b}Shell@{ub}

NewPassword has a standart AmigaOS template.
It looks like this:

 PASSWORDFILE/K,NORESIDENT/S,NOENCODE/S,ENCODELETTER/K,FAULTSOUND/K:
 
@{u}PASSWORDFILE@{uu}
This defines the Path and File where your Password will be saved.
For example: NewPassword passwordfile=Work:pw.prefs

@{u}NORESIDENT@{uu}
If you use this under shell, NewPassword will appear after a WarmStart
also if you typed in the correct password before.

@{u}NOENCODE@{uu}
If you use this, you could see the real letters you've typed in.

@{u}ENCODELETTER@{uu}
If you haven't used NOENCODE in your command-line, you could define with
this command the letter which will appear when you type in your password.
For example: NewPassword encodeletter=? or NewPassword encodeletter=#

@{u}FAULTSOUND@{uu}
With faultsound you could define a filename for a sample which would be
played by incorrect password. Please note you must have installed the
datatypes.library and your dataytpes corectly.

Some commando-lines:

NewPassword passwordfile=Work:Hallo encodeletter=# faultsound=progdir:sound
NewPassword passwordfile=Work:Hallo noresident noencode

@ENDNODE

@NODE TTYPES "ToolTypes"
@{b}Tool Types@{ub}

There are four ToolTypes.

@{u}PASSWORDFILE@{uu}

Here you can specify the Path and the File where your Password will be
saved.
To change the ToolType select the Icon of NewPassword and select in the
WorkbenchMenue Icons->Information. Then you could cahnge the entry.
For example: PASSWORDFILE=Work:pw.prefs or PASSWORDFILE=WB_3.0:Hallo

@{u}NORESIDENT@{uu}

If you use this ToolType, NewPassword will appear after a WarmStart
also if you typed in the correct password before.

@{u}NONENCODE@{uu}

If you use this ToolType, you could see the real letters you've typed in.

@{u}ENCODELETTER@{uu}

If you haven't used NOENCODE as ToolType, you could define with this
ToolType the letter which will appear when you type in your password.
For example: ENCODELETTER=? or ENCODELETTER=#

{u}FAULTSOUND@{uu}

With faultsound you could define a filename for a sample which would be
played by incorrect password. Please note you must have installed the
datatypes.library and your dataytpes corectly.

@ENDNODE

@NODE FUTURE "Future"
@PREV USAGE
@SMARTWRAP
@{b}Future@{ub}


I plan to add following features:
@{CODE}
  - any suggentions of you, if I think they are good
  - a better guide, maybe in other languages
  - install-script

@ENDNODE

@NODE HISTORY "The long history of NewPassword"
@{b}History@{ub}

  @{b}Version 1.1 (10.08.97)@{ub}
    - first Aminet release

  @{b}Version 1.2 (30.08.97)@{ub}
    - new features like the not-appearing of NewPassword after a WarmStart
      and the appearing of an other letter when you types in your password,
      so that anybody else could see your password

  @{b}Version 1.3 (31.10.97)@{ub}
    - removed some bugs, thanks to Sebastian Bauer
    - made intern changes
    - optimized the programm

  @{b}Version 1.4 (02.11.97)@{ub}
    - removed some bugs
    - encoding the saved password

  @{b}Version 1.5 (29.11.97)@{ub}
    - removed bug in delbackward-rutine
    - compiled with SASC
    - optimized the lengh of NewPassword

  @{b}Version 1.6 (10.12.97)@{ub}
    - removed some little bugs
    - corrected mistakes in this guide

  @{b}Version 1.7 (15.12.97)@{ub}
    - own sound by incorrect password


  @{b}Version 1.8 (17.01.98)@{ub}
    - bug-removing
    - size-optimizing
    - german documentation

  @{b}Version 1.9 (12.02.98)@{ub}
    - removed bug when toggeling between NewPassword Screen and Workbench so
      that you couldn't start another program (thanks to HAKAN)

@ENDNODE

@NODE AL "How can you reach me ?"
@{b}Author@{ub}


@SMARTWRAP
Althogh this is the eigth release of NewPassword, it's possible that
there are some bugs! If you find some or have suggestions to improve 
NewPassword you should contact me.

I would be very pleased, if you could send me a really good Icon for
NewPassword 'cause my one is very ugly but I'm not Leonardo da Vinci, so
you must excuse that.  ;-)

@{CODE}

Address:
   Alexander Lärz
   Neustädter Str. 45
   07768 Kahla
   Germany

@{BODY}
I'm also within reach via E-Mail.
My E-Mail-Adress is: alexlaerz@t-online.de

P.S. Visit the homepage of good friend of mine. His name is Sebastian Bauer,
     maybe you know him or one of his programms like SimpleFind or PS.
     http://home.t-online.de/home/sebauer/

@ENDNODE