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

@NODE main "NewPassword Dokumentation"
@SMARTWRAP
@{b}NewPassword 1.9 @{AMIGAGUIDE}@{ub}

Achtung! Dieses Guide nutzt Funktionen der Version 40 des amigaguide.datatype,
der mit dem AmigaOS 3.1 Betriebssystem mitgeliefert wird. Wenn ihr eine
ältere Version haben solltet, könnte dieses Guide an manchen Stellen teilweise
nicht so gut aussehen, wie es geplant geplant.

Ach ja, da wär noch was. Wenn ihr beim Durchlesen dieses Guides Fehler finden
solltet, würde ich mich freuen, wenn sie @{"mir" link AL } dies per E-Mail mitteilen würdet,
denn niemand ist perfekt. Noch was, mein Ausdruck war noch nie der beste,
bitte seht 'drüber weg.
@{CODE}

@{" Copyright " link COPYRIGHT}              Copyright und sowas !!!
@{" Einführung " link INTRO}             Was ist NewPassword ?
@{" Erfordernisse " link REQUIRE}          Was braucht man ?
@{" Installation " link INSTALL}           Wie installiert man es ?
@{" Anwendung " link USAGE}              Was muß man tun, damit's endlich läuft ?
@{" Zukünftiges " link FUTURE }            Was kommt noch ?
@{" Geschichte " link HISTORY }             Wie alles begann !!!
@{" Autor " link AL }                  Wo muß man sich bei Fehlern hinwenden ?
@ENDNODE

@NODE COPYRIGHT "Copyright und sowas"
@SMARTWRAP
@{b}Copyright@{ub}


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


NewPassword ist absolut Freeware. Du kannst es jedem, der es will weitergeben,
solange alle Dateien in unveränderter Form erhalten bleiben und kein Profit damit
gemacht wird.


@{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 "Einführung"
@SMARTWRAP
@{b}Introdution@{ub}


NewPassword ist ein kleines Programm, daß Deine Festplatte vor ungewollten
zugriffen schützen soll.

@{CODE}
Was ist besonders an NewPassword
  - einfache Handhabung
  - Shell-Unterstützung
  - ToolType-Unterstützung
  - Verschleierung der eingegebenen Buchstaben
  - NewPassword läuft im Hintergrund, so daß man bei einem Warstart des
    Computers das Passwort nicht erneut eingeben muß
  - codiertes Speichern des Passworts
@ENDNODE

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


NewPassword braucht eigentlich nur Kickstart 3.0 oder höher. Es sollte auf
jedem Computer mit Kickstart 3.0 oder höher laufen.
@ENDNODE

@NODE INSTALL "Installation von NewPassword"
@SMARTWRAP
@{b}Wie installiert man NewPassword ???@{ub}


Leider habe ich noch nicht die Zeit gefunden ein Install-Script zu schreiben,
aber es sollte trotzdem kein Problem sein NewPassword zu installieren.
Erst mal kopiert man die Schublade samt Inhalt dahin, wohin man sie haben
möchte. Das Programm könnte man ja dann in die WBStartup Schublade kopieren,
so daß es beim Anschalten des Computers automatisch geladen wird. Man könnte
aber auch eine Kommandozeile in seine User-Startup einfügen. Dazu schaue man
unter @{" Anwendung " link USAGE }.

@ENDNODE

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

Startet man NewPassword kann man zunächst ein kleines Fenster sehen, in dem
sich ein StringGadget mit der Aufforderung "Change Me." befindet. Weiterhin
sind da noch zwei Buttons, "OK" und "Save", wobei der Save-Button inaktiv
ist, solange man das richtige Passwort nicht eingegeben hat. Wenn man nach
endlosen Versuchen (kleiner Scherz) endlich das Passwort eingeben hat, kann
man den OK-Button, das CloseGadget oder Enter doppelt drücken, um das
Programm zu verlassen. Wenn man den OK-Button oder Enter nur einmal
betätigt, wird der Save-Button aktiviert und man kann ein neues Passwort
eingeben und abspeichern. Beim ersten Start von NewPasswort, ist das
Passwort "Change Me.", man kann es dann je nach Belieben ändern.
Zu den Einstellung, die NewPassword beinhaltet schaue unter Shell-Start
oder unter ToolType-Einträge nach.

 @{" Shell-Start " link SHELL }
 @{" ToolType-Einträge " link TTYPES }

@ENDNODE

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

NewPassword hat die übliche Argumentzeile, wie man es von den Befehlen des
Betriebssystems gewohnt ist.

So sieht's ungefähr aus:

 PASSWORDFILE/K,NORESIDENT/S,NOENCODE/S,ENCODELETTER/K,FAULTSOUND/K:
 
@{u}PASSWORDFILE@{uu}
Mit PASSWORDFILE gibt man den Pfad und die Datei an, auf die NewPassword
beim Laden und Speichern des Passworts zugreift. Gibt man keine Datei an,
wird das Passwort in Envarc unter password.prefs gespeichert.

Beispiel: NewPassword passwordfile=Work:pw.prefs

@{u}NORESIDENT@{uu}
Nutzt man NORESIDENT, muß man das Passwort bei jedem Warstart erneut
eingeben, auch wenn man es schon einmal eigegeben hat.

@{u}NOENCODE@{uu}
NOENCODE erlaubt es, die richtigen Zeichen zu sehen, die man eingibt.

@{u}ENCODELETTER@{uu}
Wenn man nicht NOENCODE nutzt, kann man mit ENCODELETTER ein Zeichen auswählen,
das anstatt der richtigen Zeichen kommt. Man kann hierfür alle Zeichen der
Tastatur nutzen.
Beispiel: NewPassword encodeletter=? or NewPassword encodeletter=#

@{u}FAULTSOUND@{uu}
Mit FAULTSOUND kann man eine Sounddatei angeben, die bei einem falschen Passwort
kommt. Wichtig ist dabei, daß die datatypes.library und ihre Datatypes richtig
installiert sind.

Einige Beispele:

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

@ENDNODE

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

Es gibt fünf ToolTypes.

@{u}PASSWORDFILE@{uu}
Mit PASSWORDFILE gibt man den Pfad und die Datei an, auf die NewPassword
beim Laden und Speichern des Passworts zugreift. Gibt man keine Datei an,
wird das Passwort in Envarc unter password.prefs gespeichert.

@{u}NORESIDENT@{uu}
Nutzt man NORESIDENT, muß man das Passwort bei jedem Warstart erneut
eingeben, auch wenn man es schon einmal eigegeben hat.

@{u}NOENCODE@{uu}
NOENCODE erlaubt es, die richtigen Zeichen zu sehen, die man eingibt.

@{u}ENCODELETTER@{uu}
Wenn man nicht NOENCODE nutzt, kann man mit ENCODELETTER ein Zeichen
auswählen, das anstatt der richtigen Zeichen kommt. Man kann hierfür
alle Zeichen der verwenden.

@{u}FAULTSOUND@{uu}
Mit FAULTSOUND kann man eine Sounddatei angeben, die bei einem falschen
Passwort kommt. Wichtig ist dabei, daß die datatypes.library und ihre
Datatypes richtig installiert sind.


@ENDNODE

@NODE FUTURE "Zukünftiges"
@PREV USAGE
@SMARTWRAP
@{b}Zukünftiges@{ub}


Für die nächste Zeit plane ich folgende Verbesserungen.
@{CODE}
  - jeden Vorschlag, der von euch kommt, solange er sinnvoll ist
  - Übersetzung der Dokumentation in weitere Sprachen
  - vielleicht eine extra Version, die unter OS 2.0 lauffähig ist
  - ein Install-Script

@ENDNODE

@NODE HISTORY "Geschichtliches"
@{b}Wie alles begann !!!@{ub}

  @{b}Version 1.1 (10.08.97)@{ub}
    - erste Veröffentlichung im Aminet

  @{b}Version 1.2 (30.08.97)@{ub}
    - neue Funktionen, wie die Funktion, die bewirkt, das NewPassword nach
      einem Warmstart nicht erneut aufgerufen wird oder die Funktion, die
      verhindert, daß man das richtige Passwort sieht.

  @{b}Version 1.3 (31.10.97)@{ub}
    - Behebung einiger Fehler, danke an Sebastian Bauer
    - Größenoptimierung

  @{b}Version 1.4 (02.11.97)@{ub}
    - Behebung einiger Fehler
    - codiertes Speichern des Passworts

  @{b}Version 1.5 (29.11.97)@{ub}
    - Behebung eines großen Fehlers in der Delbackward-Routine
    - Complierung mit SASC
    - Größenoptimierung

  @{b}Version 1.6 (10.12.97)@{ub}
    - Fehlerbehebung
    - Fehlerkorrektur im englischen Guide

  @{b}Version 1.7 (15.12.97)@{ub}
    - eigener Sound bei falschem Passwort

  @{b}Version 1.8 (17.01.98)@{ub}
    - Fehlerbehebung
    - Größenoptimierung
    - deutsche Dokumentation

  @{b}Version 1.9 (12.02.98)@{ub}
    - Fehlerbehebung beim Creenwechsel zwischen NewPassword und der
      Workbench, man kann kein anderes Programm mehr starten (Danke an
      HAKAN)

@ENDNODE

@NODE AL "Wie bin ich erreichbar ?"
@{b}Autor@{ub}


@SMARTWRAP
Obwohl dies die achte veröffentlichte Version ist, ist es durchaus möglich,
daß das Programm noch Fehler hat ! Wenn ihr welche findet oder Vorschläge
habt, wie man NewPassword noch verbessern kann, kontaktiert mich.

Ach noch aws. Ich würde mich freuen, wenn jemand ein Icon für NewPassword
zeichnen könnte, da meins nicht so besonders schön ist, denn ich bin nicht
Leonardo da Vinci.  ;-)

@{CODE}

Meine Adresse:
   Alexander Lärz
   Neustädter Str. 45
   07768 Kahla
   Deutschland

@{BODY}
Ich bin auch über E-Mail ereichbar.
Meine E-Mailadresse lautet: alexlaerz@t-online.de

P.S. Besucht die HomePage eines Freundes, vielleicht kennt ihr ihn oder eines
     seiner Programme wie SimpleFind oder PS. Auf der HomePage gibt's die
     neusten Versionen von SimpleFind und SimplePac (ein Pacmanclone).
     http://home.t-online.de/home/sebauer/

@ENDNODE