@database ProRen.guide
@author "Michael Praschl"
@(c) "Copyright © 1996 by Michael Praschl"
@$VER: ProRen.guide 1.32 (8/12/96)

@node Main "Deutsche Dokumentation zu ProRen V1.32"

  @{b}@{u}ProRen V1.32@{uu}
  @{fg shine}Author: Michael "PRO" Praschl
  Copyright © 1996 by Michael Praschl
  @{fg shadow}
  @{"EMailWare     " link EMailWare} - Bitte registrieren Sie sich (kostenlos)
  @{ub}
  @{" Einführung   " link Introduction}          Worum geht's ?
  @{" Installation " link Installation}          Ganz einfach !
  @{" Anforderungen" link Requirements}          Was brauch ich ?

  @{" Benutzung    " link Usage}          Was muß ich machen ?

  @{" Garantien    " link Warranty}          Gibt's nicht !
  @{" Rechtliches  " link Distribution}          Distribution
  @{" Copyright    " link Copyright}          BGui, ReqTools, ...
  @{" Registrieren " link Register}          Schnell und gratis

  @{" Bugreports   " link BugReports}          Und Vorschläge
  @{" Updates      " link Updates}          Aminet & Homepage

  @{" Fähigkeiten  " link Features}          Tolle Sachen
  @{" Zukunft      " link ToDo}          Was noch zu tun ist

  @{" Danksagungen " link Thanks}          und an alle, die ProRen benutzen
  @{" Autor        " link Author}          Meine Adresse
@endnode
@node Introduction "Einführung"
@{fg shine}Worum geht's?@{fg shadow}

ProRen  ist  ein  Programm,  das geschrieben wurde, um Dateien umzubenennen.
Jetzt  können Sie sagen, daß das auch der Rename-Befehl der Shell macht, und
damit  haben  Sie Recht.  Aber ProRen kann viel mehr als Rename.

Ein kleines Beispiel zur Verdeutlichung:
     @{fg shine}alter Name@{fg shadow}                        @{fg shine}neuer Name@{fg shadow}
     Hansi.iff                         BildNummer.001
     UlrichsKopf.br                    BildNummer.002
     Petra                             BildNummer.003
     Logo1                             Bildnummer.004
     Logo2                             Bildnummer.005
     Portrait_von_mir                  BildNummer.006


Zweite Möglichkeit:
     @{fg shine}alter Name@{fg shadow}                        @{fg shine}neuer Name@{fg shadow}
     Pic.000                           Anim.010
     Pic.001.iff                       Anim.011
     Picture.2.jpg                     Anim.012
     Bild.0003                         Anim.013
     Pic.5                             Anim.014 oder Anim.015 (wählbar)


Im ersten Beispiel ist "BildNummer." der  Basisname,  "001"  bis  "004"  der
Index.  Bei ProRen setzen sich die neuen Namen aus dem Basisnamen und dem 1-
bis 6-stelligen Index zusammen.

Im zweiten Beispiel wurde der Index um 10 nach oben verschoben.

Die Namen der Quelldateien sind bis auf folgende Einschränkungen beliebig:
  * Wenn an allen Namen eine Zahl hängt, darf keine Zahl 2x vorkommen
  * Die Zahl darf nicht größer als 999999 sein
  * Von einer Negativen Zahl wird der Absolutbetrag gewählt.

Da  die  Änderungen  abgespeichert werden, können sie durch einen Knopfdruck
wieder  rückgängig  gemacht  werden.   Aus  alledem  ergeben  sich  folgende
Möglichkeiten:

Die Einzelbilder einer Animation bestehen aus Basisname und Nummer.
  * Sie  haben  (für  unterschiedliche  Szenen) unterschiedliche  Basisnamen
    verwendet.  Mit   ProRen ist  es  möglich,  die  Basisnamen  einheitlich
    umzubenennen, ohne daß  Sie händisch 1000 Dateien bearbeiten müssten.
  * Sie möchten nach einem Frame eine andere Sequenz einfügen.  ProRen  ver-
    schiebt die Nummern ab dem betreffenden Frame.
  * Sie haben viele Bilder, die Sie alle ins gleiche Format bringen möchten.
    ProRen gibt allen Bildern Name und Nummer, ein Arexx-Script übergibt die
    Bilder  der  Reihe  nach  an ImageFX, wo sie alle ins gleiche Format ge-
    bracht,  und  unter  dem  gleichen  Namen  (Name und Nummer) gespeichert
    werden.  ProRen  gibt  den  Dateien  mit Hilfe des @{"Rückgängig" link UndoGadget}-Gadgets wieder
    ihre alten Namen.
    Das  ArexxScript gehört  zur Zeit noch auf meine  ToDo-Liste, ebenso wie
    ein ArexxPort. ;-)
  * Sie  finden  sicher auch andere Anwendungsbeispiele, ProRen ist ja nicht
    nur auf Animationen  anwendbar,  obwohl gerade  in diesem  Bereich viele
    Dateien mit Index vorkommen.

@endnode
@node Usage "Benutzung"
ProRen verfügt über eine graphische Benutzeroberfläche. Sämtliche Eingaben
werden über Intuition-@{"Gadgets" link Gadgets} und @{"Menüs" link Menus} vorgenommen.
Das Fenster paßt sich automatisch an den eingestellten  Zeichensatz  an  und
kann  (fast)  nach  Belieben  vergrößert werden. Über @{"ToolTypes" link ToolTypes}, lassen sich
weiter Angaben festlegen und zum Verzeichniswechseln kann man auch ein  Icon
in das Fenster fallen lassen.

@endnode
@node Gadgets "Gadgets"

Die Gadgets des Hauptfensters:

  @{"                   ProRen                    " link About}

  @{"Basisname                       " link BaseNameGadget}  @{"   Start   " link NumberGadget}
  @{"Erweiterung                     " link ExtensionNameGadget}

  @{"                 Verzeichnis                 " link DrawerGadget}
  @{"          Dateiliste          " link FileListGadget}    @{" Laufwerke " link DrivesGadget}
  @{"                              " link FileListGadget}    @{" Mutterv.  " link ParentGadget}
  @{"                              " link FileListGadget}    @{"  Muster   " link PatternGadget}
  @{"                              " link FileListGadget}    @{"  Anders   " link InvertGadget}
  @{"                              " link FileListGadget}    @{"   Keine   " link NoneGadget}
  @{"                              " link FileListGadget}    @{"   Alle    " link AllGadget}

  @{"  Ende  " link Quit}      @{"  Rückgängig  " link UndoGadget}     @{"  Beginnen  " link StartGadget}


und des Einstellungsfensters:
 #=======#     +------+     +-------------+        +-------------+
 #Vorgang#     |Fehler|     |Verschiedenes|        |Registrierung|
 #=======#-----+------+-----+-------------+--------+-------------+
 |@{" TempName " link TempNameGadget}   @{"Fehlername" link ErrNameGadget}   @{"   Index suchen    " link SearchGadget}   @{"Benutzername" link UserName} |
 |@{" Stellen  " link DigitsGadget}   @{"Bei Fehler" link ErrModeGadget}   @{" Rückgängig aktiv  " link UndoActiveGadget}   @{" Reg. Code  " link RegCode} |
 |@{"Bei Lücken" link GapModeGadget}                 @{"Sicherheitsabfragen" link RequestGadget}                |
 +---------------------------------------------------------------+
                @{" Benutzen " link UseSetGadget}   @{"  Abbruch  " link CancelSetGadget}
@endnode
@node About "Über ..."
Es öffnet sich ein Fenster mit ein paar Informationen über ProRen

@endnode
@node UndoGadget "Wiederherstellung alter Namen"
Mit  dem  Rückgängig-Gadget  wird  die  Wiederherstellung  der  alten  Namen
eingeleitet.  Dazu  müssen alle Dateien, deren Name wiederhergestellt werden
soll in der @{"Dateiliste" link FileListGadget} markiert werden.

@endnode
@node DrawerGadget "Verzeichnis"
Das Verzeichnis bestimmt, wo sich die Dateien, die  Sie  umbenennen  wollen,
befinden.  Die  Dateien  dieses  Verzeichnisses  werden  in  der  @{"Dateiliste" link FileListGadget}
gezeigt.

Alle umzubenennenden  Dateien  müssen  im  gleichen  Verzeichnis  sein,  und
bleiben auch in eben diesem.

@endnode
@node PatternGadget "DateiMuster"
Das Dateimuster beschreibt alle Dateien,  die  in  der  @{"Dateiliste" link FileListGadget}  sichtbar
sind.

Beispiele:
@{fg shine}#?[a-z]@{fg shadow} sind alle Dateien, deren Name mit einem Buchstaben aufhört.
@{fg shine}#?[0-9]@{fg shadow}  beschreibt  zu  Beispiel  alle Dateien, deren Name mit einer Ziffer
endet.
@{fg shine}Bild-[1-2][0-9][0-9]@{fg shadow} sind alle Dateien, deren BasisName "Bild-" ist, und mit
einem Bindestrich von einer Nummer zwischen 100 und 299 getrennt ist.

@endnode
@node BaseNameGadget "Der BasisName"
Der BasisName ist der vordere, immer gleichbleibende Teil der neuen Namen.
Sinnvolle Beispiele:

  @{fg shine}Anim.@{fg shadow}
  @{fg shine}Picture.@{fg shadow}
  @{fg shine}Frame_@{fg shadow}

In Verbindung mit der angehängten Nummer ergeben sich dann die vollständigen
neuen Dateinamen.

@endnode
@node ExtensionNameGadget "Die Erweiterung"
Die optionale Erweiterung wird, falls  angegeben,  an  die  neuen  Dateinamen
angehängt und zwar hinter den Index: "Frame.001.jpg".

Achtung:
Wenn diese Dateien weiter umbenannt werden sollen, muß in  den  Einstellungen
@{"Index  Suchen" link SearchGadget} aktiv sein, da sonst die Reihenfolge durcheinander kommen kann,
da die Dateien alphabetisch sortiert werden würden, und nicht nach dem Index.
In  diesem  Fall  würde  allerdings gefragt werden, ob die Dateien ohne Index
umbenannt werden sollen.
@endnode
@node NumberGadget "StartNummer"
Die  Startnummer  bildet  gemeinsam  mit  dem  @{"Basisnamen" link BaseNameGadget}  den  ersten neuen
Dateinamen.   Dazu  wird  sie  an  den  Basisnamen angehängt.  Aus wievielen
Stellen  (mit  führenden  Nullen)  die  Zahl  besteht, kann im @{"Stellen" link DigitsGadget}-Gadget
eingestellt  werden.   Die nächste Zahl ist im Normalfall um eins erhöht, es
sei  denn,  es war die Zahl am @{fg shine}zweiten@{fg shadow} alten Dateinamen um mehr als 1 größer
als  die  Zahl  am  @{fg shine}ersten@{fg shadow}  alten  Dateinamen.   In diesem Fall wird je nach
Einstellung entschieden, ob die Lücke erhalten werden  soll,  oder   ob  die
neue  Zahl  um  1 größer als die alte Zahl sein soll. Diese Einstellung wird
am @{"Lücken" link GapModeGadget}-Gadget vorgenommen.

@endnode
@node TempNameGadget "Temporärer Basisname"
ProRen ermöglicht es beispielsweise, Dateien mit einem beliebigen Basisnamen
und  den  Nummern von <000 - 009> nach <005 - 014> zu verschieben, aber auch
von  <010  - 019> nach <005 - 014> zu verschieben.  Damit dies ohne Probleme
vor  sich  geht  (dh.   damit  010 nicht nach 009 umbenannt wird, obwohl 009
existiert)  werden  zuerst  alle  Dateien temporär umbenannt.  Der Basisname
dieses  temporären  Namens  wird  im  TempName-Gadget  festgelegt  und  kann
eigentlich immer auf "tmp." stehen. Falls Sie aber (unwahrscheinlicherweise)
Dateien  mit  den  Namen  tmp.   haben sollten, so ändern sie den temporären
Basisnamen bitte entsprechend.

Siehe auch: @{"Turbomodus" link TurboMode}
@endnode
@node ErrNameGadget "Fehlername"
Sollte es vorkommen, daß ProRen eine Datei nicht umbenennen kann, da bereits
eine  Datei mit dem neuen Namen existiert, wird mit oder ohne Nachfrage (der
Einstellung im @{"Fehler" link ErrModeGadget}-Gadget entsprechend)

a) die bereits existierende Datei umbenannt, oder
b) der Vorgang komplett abgebrochen.

Soll die existierende Datei umbenannt werden, ist ihr neuer  Basisname  der
Text,  der  im Fehlername-Gadget steht. Wird die Umbenennung der Datei erst
nach einer  Abfrage  vorgenommen,  wird  in  dem  Requester  der  ErrorName
vorgeschlagen. Dieser kann dann natürlich geändert werden.

@endnode
@node GapModeGadget "Lücken"
Wenn  Sie  beliebige  Dateien,  mit  @{fg shine}und@{fg shadow}  ohne  Nummern, umbenennen, ist das
Lücken-Gadget  uninteressant.   Ebenso,  wenn  zwar alle Dateien nummeriert
sind,  aber  keine  Nummern  fehlen.   Interessant  wird  es erst, wenn alle
Dateien nummeriert sind, und Lücken auftreten:

Pic.xxx            (xxx = <000-009>)
Pic.yyy            (yyy = <020-024>)
Pic.zzz            (zzz = <030-039>)

Wie man sieht fehlen die Dateien mit den Nummern <010-019> und <025-029>; es
gibt also Lücken.

Wenn  nun  der  Vorgang des umbenennens beginnt, hängt es vom Lücken-Gadget
ab,  was  passiert,  wenn  die  Dateien Pic.020 und Pic.030 umbenannt werden
sollen.

Steht das Lücken-Gadget auf @{fg shine}Abbruch@{fg shadow} so wird der Vorgang gar nicht erst
begonnen, sondern sofort abgebrochen.  Es wird keine einzige Datei umbenannt.

Nehmen  wir  für  die  Möglichkeiten  @{fg shine}Behalten@{fg shadow},  @{fg shine}Löschen@{fg shadow}  und @{fg shine}Fragen@{fg shadow} an, daß die
@{"Startnummer" link NumberGadget} 100 ist.

@{fg shine}Behalten@{fg shadow} bedeutet, daß <000-009> in <100-109> umbenannt wird,
                   <020-024> in <120-124> und
                   <030-039> in <130-139>.
Die Lücken werden also in ihrer Größe beibehalten.

Mit @{fg shine}Löschen@{fg shadow} werden diese Lücken gelöscht. Das heißt, daß die Dateien
                   <000-009> in <100-109>,
                   <020-024> in <110-114> und
                   <030-039> in <115-124> umbenannt werden.
Die   Lücken  werden  geschlossen,  man  hat  eine  vollständige  Reihe  von
nummerierten Dateien vorliegen.

Ist  @{fg shine}Fragen@{fg shadow}  eingestellt,  wird bei jeder Lücke gefragt, ob sie geschlossen
werden  soll  oder  nicht.   Zusätzlich  kann  auch noch abgebrochen werden,
obwohl  bereits  einige Dateien einen neuen Namen haben.  Das kann natürlich
trotz des Abbruchs @{"Rückgängig" link UndoGadget} gemacht werden.

@endnode
@node ErrModeGadget "Fehlerbehandlung"
Über das ErrMode-Gadget wird eingestellt, wie sich ProRen verhält, wenn eine
Datei  nicht  umbenannt werden konnte, weil bereits eine Datei mit dem neuen
Namen  existierte.   Hierzu  gibt  es  die  Einstellungen  @{fg shine}Umbenennen@{fg shadow}, @{fg shine}Abruch@{fg shadow}
und @{fg shine}Fragen@{fg shadow}.

Nehmen  wir  an,  daß  "tmp.123" nicht in "Pic.123" umbenannt werden konnte,
weil Pic.123 schon existiert:

Ist  @{fg shine}Abbruch@{fg shadow}  eingestellt,  wird  auf  der  Stelle abgebrochen, die Änderungen
können natürlich @{"Rückgängig" link UndoGadget} gemacht werden.

@{fg shine}Umbenennen@{fg shadow}  gibt  an,  das  "Pic.123"  umbenannt  werden soll in "err.123"
(falls im @{"Fehlername" link ErrNameGadget}-Gadget  "err."  steht),  danach  wird  nochmals versucht,
"tmp.123" in "Pic.123" umzubenennen.

Mit  @{fg shine}Fragen@{fg shadow} werden Sie gefragt, ob "Pic.123" umbenannt werden soll, oder ob
der Vorgang abgebrochen werden soll.  Wenn Sie umbenennen wollen, können Sie
auch  den  neuen  Namen für "Pic.123" angeben, "err.123" wird in diesem Fall
vorgeschlagen.

Konnte  eine  Datei nicht umbenannt werden, obwohl keine Datei mit dem neuen
Namen  existierte, erscheint ein Requester, in dem eine Fehlermeldung steht.
Sie  können  dann  versuchen  weiterzumachen,  oder  abbrechen.   Bevor  sie
weitermachen,  sollten  Sie  aber versuchen, den Fehler zu beheben.  Was Sie
dazu tun müssen, hängt von der Art des Fehlers ab und kann der Dokumentation
zum Rename-Befehl der Shell entnommen werden.

@endnode
@node DigitsGadget "Anzahl der Stellen"
Der  neue  Name  einer Datei setzt sich bekanntlich aus Basisnamen und einer
Nummer   zusammen.    Wieviele  Stellen  diese  Nummer  hat,  läßt  sich  im
Stellen-Gadget  einstellen.   Hat  die  aktuelle  Zahl  weniger  Stellen, als
eingestellt,  wird  sie  mit führenden Nullen erweitert.  Bei 4 Stellen wird
also  aus 326 die Zahl 0326.  Ist die Zahl zu groß, um mit der eingestellten
Anzahl  Stellen  dargestellt  zu werden, wird die Einstellung ignoriert, und
die Zahl so angehängt, wie sie ist.

Die folgenden Beispiele sollten Klarheit schaffen

    Basisname | Zahl | Stellen | Neuer Name
    ---------------------------------------
    Anim.     |   83 |    4    | Anim.0083
    Pic_      |  123 |    3    | Pic_123
    Bild-     | 4321 |    2    | Bild-4321

@endnode
@node Quit "ProRen beenden"
ProRen  kann über das @{fg shine}Schließsymbol@{fg shadow} des Fensters, den @{fg shine}Menüpunkt Quit@{fg shadow} und das
@{fg shine}Quit-Gadget@{fg shadow} verlassen werden.

@endnode
@node StartGadget "Umbenennen beginnen"
Um Dateien  umzubenennen,  selektieren  Sie  alle  gewünschten  Dateien  in
der @{"Dateiliste"  link  FileListGadget}  und betätigen das StartGadget (Sie können auch Start aus
dem Menü wählen.

ProRen überprüft nun, ob Sie Dateien angewählt  haben,  die  keine  Zahl  am
Namen  haben. Wenn dies der Fall ist, werden Sie zur nochmaligen Bestätigung
aufgefordert, Sollte an jedem Namen eine Zahl hängen, und an zwei Namen  die
gleiche Zahl, bricht ProRen nach eine Fehlermeldung ab. Wenn es zwischen den
Zahlen Lücken gibt,  werden  Sie  ebenfalls  gefragt,  ob  Sie  weitermachen
möchten.  Ist  die  Fragerei  endlich  überstanden,  beginnt  ProRen mit der
Arbeit, zu der er eigentlich geschaffen wurde.

Gibt es Lücken, dann werden  als  erstes  werden  alle  Dateien  in  tmp.xxx
umbenannt,  um  Konflikte zu vermeiden. Während dieses Vorganges könnten Sie
auf eine Lücke aufmerksam gemacht und gefragt werden, ob Sie diese schließen
oder   offen   lassen  möchten.  Diese  Frage  wird  allerdings  automatisch
beantwortet, wenn im @{"Lücken" link GapModeGadget}-Gadget etwas  anderes  als  "Fragen"  eingestellt
ist. Im  zweiten  Durchlauf  erhalten  die  Dateien  ihren  richtigen  neuen
Basisnamen.

Da jede Datei zweimal umbenannt wird,  dauert  der  Vorgang  natürlich  auch
doppelt  so  lange, als wenn sie nur einmal umbenannt werden würde. Trotzdem
geht  es  natürlich  viel  schneller,  als  wenn  man  alle  Dateien  selbst
umbenennen müßte.

Gibt es keine Lücken, dann wird automatisch der  @{"Turbomodus" link TurboMode}  aktiviert,  der
doppelt so schnell ist, da ProRen die Dateien nur einmal umbenennen muß.
@endnode
@node Menus "Die Menüs"
ProRen  stellt  auch  ein  kleines PullDown-Menü zur Verfügung, über das ein
paar Funktionen erreichbar sind, die nicht im Fenster angeboten werden:

@{"Start" link StartGadget}            (entspricht dem StartGadget)
@{"Über" link About}            (entspricht dem ProRen-Gadget)
@{"Ende" link Quit}            (entspricht dem QuitGadget)

@{"Filenotes löschen" link ClearComments}

@{"Einstellungen ändern" link Gadgets}            (Es öffnet sich das Einstellungsfenster)
@{"Einstellungen speichern" link SaveSettings}

@endnode
@node SaveSettings "Einstellungen speichern"
Um  ProRen  noch  etwas komfortabler zu machen, sind sämtliche Einstellungen
speicherbar.  Über das Menü "Save Settings" werden die Inhalte aller Gadgets
in  der Datei ProRen.prf gespeichert.  Diese Datei ist eine ASCII-Datei, die
mit  einem Editor (Ed) geändert werden kann, was eigentlich nicht nötig sein
sollte, da das ja mit ProRen viel einfacher geht.

Siehe auch: @{"Tooltypes" link ToolTypes}
@endnode
@node Installation "Installation"
Die Installation erfolgt über den Installer von Commodore  und  dürfte  sich
somit als schwer erweisen.

@endnode
@node Requirements "Anforderungen"
Kickstart/Workbench Version 39+

Externe Libraries: · reqtools.library
                   · bgui.library      (nicht includiert => @{"Aminet & HomePage" link Updates})
                   · asl.library
                   · commodities.library  (sollten bei OS3.0+ dabei sein)

Min. 512k freien Speicher, wenn man 1 Mio.  Dateien  umbenennen  will,  wird
geringfügig  mehr  Speicher  benötigt.  Das  heißt  ~10  MB  (8-O), wenn ein
Datename 10 Zeichen lang ist. Aber wann benennt man  schon  soviele  Dateien
um?
@endnode
@node Warranty "Garantie"
Dieses Softwarepaket wird Ihnen zur Verfügung gestellt, so wie es ist,  ohne
Gewährleistung irgendeiner Art, sei es ausdrücklich oder implizit. Durch die
Benutzung von @{b}ProRen@{ub} sind Sie damit einverstanden, jegliches Risiko, das die
Verwendung von @{b}ProRen@{ub} mit sich bringt, selbst zu tragen.

In keinem Fall wird der Autor von @{b}ProRen@{ub} Ihnen  gegenüber  für  irgendwelche
Schäden    verantwortlich   sein,   einschließlich   jegliche   allgemeinen,
speziellen, zufälligen  oder  Folgeschäden  die  durch  korrekte  oder  auch
falsche Benutzung dieses Paketes oder Fehlern  in  der  Anleitung  entstehen
(einschließlich,  aber  nicht  beschränkt  auf  den  Verlust  von Daten oder
Verluste die durch Sie oder Dritte erlitten werden), auch dann  nicht,  wenn
der  Besitzer  oder  Dritte  auf die Möglichkeit solcher Schäden hingewiesen
wurden.

Natürlich ist @{b}ProRen@{ub} vor der  Veröffentlichung  ausgiebig  getestet  worden,
falls  Sie  aber dennoch Fehler in @{b}ProRen@{ub} finden sollten, bitte ich Sie, mir
dies mitzuteilen. Ich werden sie dann sobald wie möglich beheben.

Siehe auch @{"Bugreports" link BugReports}
@endnode
@node BugReports "Bugreports"
Wenn Sie einen Fehler in ProRen finden so sind Sie herzlich eingeladen,  mir
diesen  mitzuteilen.  Geben  Sie  bitte  auch  an  welche  Daten  sie in den
Eingabefeldern eingestellt haben, und welche Konfiguration Sie besitzen.

Schicken Sie den Report bitte an @{"meine Adresse" link Author}
Ich werde den Fehler so bald wie möglich beheben.

Ich bin Ihnen aber auch für Verbesserungsvorschläge und (konstruktive) Kritik
dankbar.
@endnode
@node Author "Meine Adresse"
Wenn Sie es wirklich nicht lassen können, schreiben Sie bitten an:
  Michael Praschl
  Hohe Warte 7-1-5
  1190 Wien
  AUSTRIA

oder (was mir lieber ist) an:
  EMail: e9525802@student.tuwien.ac.at

@endnode
@node EMailWare "EMailWare"
Dieses Programm ist EMailWare. Das heist, das Sie es frei verbreiten  dürfen,
solange Sie das Archiv bzw. die Verzeichnisse/Dateien nicht verändern.

Ausserdem sollten Sie sich (kostenlos) @{"registrieren" link Register} lassen!

Wenn Sie ProRen mit einem kommerziellen Produkt vertreiben wollen,  brauchen
Sie eine schriftliche Erlaubnis von @{"mir" link Author}.
@endnode
@node Distribution "Distribution"
Dieses Softwarepaket ist EMailWare. Es darf  nur  unverändert  weitergegeben
werden.  Es  dürfen weder Dateien aus dem Paket gelöscht werden, noch dürfen
welche hinzugefügt werden. Bitte @{"registrieren" link Register} Sie sich (gratis)!
@endnode
@node Features "Tolle Fähigkeiten"
 ProRen

  · benutzt bgui.library und reqtools.library
    deshalb ist es Font-Sensitiv, Fenster ist vergrößerbar
  · kann bis zu 1 000 000 Dateien in einem Zug umbenennen
  · ist viel schneller als Sie
  · alle Änderungen können rückgängig gemacht werden
  · auch englische Dokumentation im Paket
  · automatisierte Fehler-Korrektur
  · hat eine einfach zu benutzende Oberfläche
  · ist kein MUI-Programm

Neue Fähigkeiten in V1.3:
  · automatischer Turbomodus ist zweimal so schnell!
  · lokalisiert (+ deutscher Catalog)
  · unterstützt ToolTypes
  · Auswahl der Dateien noch einfacher
  · Rückgängig machen noch sicherer
  · AppWindow: Verzeichnis läßt sich durch das Fallenlassen eines Icons bestimmen
  · Fensterposition speicherbar
  · der alte Name kann nun noch eine Erweiterung (*.jpeg) hinter dem Index haben

Neu in V1.31:
  · ProRen ist jetzt EMailWare, lassen Sie sich bitte @{"registrieren" link Register} (gratis)
  · Verzeichnisse in der Dateiliste werden hell dargestellt
  · jeder Vorgang kann jederzeit abgebrochen werden (Rückgängig trotzdem möglich)

@endnode
@node ToDo "Todo"
 Was ich irgendwann noch machen möchte:

 · Arexx-Port (wenn gewünscht, bitte unbedingt schreiben!)
 · Einstellungs- und Porgressfenster sollten im Hauptfenster
   zentriert sein, ich kriegs einfach nicht hin.
@endnode
@node Copyright "Copyright"
  Copyrights

  BGUI          Copyright © 1993 - 1996 by Jan van den Baard
                                   1996 by Ian J. Einman (* "Cause it's for free,
                                                             free at last" :-) *)
  Reqtools      Copyright © 1991 - 1996 by Nico François
  MagicWB Icons Copyright © 1992 - 1996 by Martin Huttonloher
  Installer     Copyright © 1990 - 1991 by Commodore Amiga, Inc.
@endnode
@node Thanks "Danksagungen"
Danksagungen geht an:

 · @{b}Georg "Golmo" Leitner@{ub} für Logo, Icons und konstruktive Kritik und Beta-Testing
 · @{b}Andreas "Baal" Berger@{ub} für destruktive Kritik
 · @{b}Andreas Seebacher@{ub} für Idee, Vorschläge und Beta-Testing
 · @{b}allen anderen Beta-Testern@{ub}
 · @{b}Jabba Development@{ub} für die bgui.library
 · @{b}Ian J. Einman@{ub} dafür, daß er BGUI weiterentwickelt
 · @{b}Nico François@{ub} für dir reqtools.library
 · @{b}Wouter van Oortmerssen@{ub} für den AmigaE Compiler
 · @{b}dem Christkind@{ub}

  und allen die ein Danke verdient haben.
@endnode
@node FileListGadget "Die Dateiliste"
In dieser Liste werden alle Dateien des aktuellen @{"Verzeichnisses" link DrawerGadget},  die  dem
@{"Muster" link PatternGadget}  entsprechen, angezeigt. Hier können Sie alle Dateien auswählen, die
Sie umbenennen möchten (oder denen Sie den alten Namen geben möchten).

Desweiteren können  Sie  hier  eine  Liste  aller  Geräte  und  Zuweisungen
erhalten, indem Sie auf @{"Laufwerke" link DrivesGadget} clicken.
@endnode
@node DrivesGadget "Laufwerke anzeigen"
Nach einem  Druck  auf  das  Laufwerke-Gadget  zeigt  die  @{"Dateiliste" link FileListGadget}  alle
verfügbaren Laufwerke und Zuweisungen an.
@endnode
@node ParentGadget "Mutterverzeichnis"
Mit diesem Gadget gelangen Sie in das übergeordnete Verzeichnis.
@endnode
@node InvertGadget "Alles umdrehen"
Hiermit  können  Sie  alle  selektierten   Einträge   in   der   Dateiliste
deselektieren und umgekehrt (alle nicht selektierten werden selektiert).
@endnode
@node NoneGadget "Keine selektieren"
Mit diesem Gadget können sie alle Dateien deselektieren.
@endnode
@node AllGadget
Mit diesem Gadget können sie alle Dateien selektieren.
@endnode
@node UndoGadget "Rückgängigmachen"
Um bereits umbenannten Dateien ihre alten Namen zurückzugeben, brauchen  Sie
sie  nur  in  der  @{"Dateiliste link FileListGadget} zu markieren und auf das Rückgängig-Gadget zu
clicken. ProRen beginnt dann sofort mit der Arbeit.

Wenn diese Funktion während des Umbenennens deaktiviert war  (@{"Rückgängig" link UndoActiveGadget}  im
@{"Einstellungsfenster" link Gadgets}),  ist  es nicht möglich den Dateien ihre alten Namen zu
geben.
@endnode
@node SearchGadget "Index suchen"
Wenn dieses Gadget aktiv ist, kann nach dem Index der alten Namen noch  eine
Erweiterung  (*.jpeg)  stehen.  Diese  wird  dann abgeschnitten und kann von
Datei zu Datei unterschiedlich sein. Verwendet wird immer der letzte  Index,
das heißt im Namen "Anim-12_34.iff" wäre der Index 34.
@endnode
@node UndoActiveGadget "Rückgängig aktiv"
Damit ProRen die Namen der alten Dateien @{"wiederherstellen" link UndoGadget} kann,  werden  die
alten  Namen  als  Filenote  zur  jeweiligen  Datei  abgespeichert (und alte
Filenotes überschrieben). Sollten Sie jedoch aus einem bestimmten Grund  die
Filenotes  benötigen, so können Sie diese Funktion mit dem Rückgängig-Gadget
im Einstellungs Fenster abschalten. Die Filenotes bleiben dann erhalten, Sie
können   jedoch   die   alten   Namen   der  Dateien  nicht  mehr  (einfach)
wiederherstellen.
@endnode
@node RequestGadget "Sicherheitsabfrage"
Wenn Sie das BeginnenGadget  betätigt  haben,  werden  Sie  (abhängig  von  der
Situation) gefragt, ob Sie Dateien ohne Index umbenennen wollen, oder ob Sie
trotz der gefundenen Lücken fortfahren wollen.

Sollte keiner dieser Fälle eintreten, werden Sie einfach nur gefragt, ob Sie
weitermachen  wollen.  Diese  Frage  können Sie jedoch mit dem Fragen-Gadget
abstellen.
@endnode
@node UseSetGadget "Einstellungen benutzen"
Mit diesem Gadget übernehmen Sie die aktuellen Einstellungen.
@endnode
@node CancelSetGadget "Einstellungen abbrechen"
Hiermit werden alle Änderungen in den Einstellungen rückgängig  gemacht  und
das   Einstellungs-Fenster  geschlossen.  Auch  mit  dem  Schließsymbol  des
Fensters lassen sich die Einstellungen rückgängig machen.
@endnode
@node ClearComments "Filenotes löschen"
Wenn Sie zu den Leuten gehören, die nicht gerne Filenotes an  ihren  Dateien
haben, können Sie diese mit diesem Menüpunkt löschen. Wählen Sie dazu vorher
alle Dateien aus, von denen Sie den Filenote löschen wollen.
@endnode
@node ToolTypes "Piktogramm-Merkmale"
ProRen  liest  beim  Start  (von  der  Workbench)  die   Piktogramm-Merkmale
(Tooltypes),  um  so bestimmte Einstellungen  vorzunehmen.  Diese  Tooltypes
Alternativen zur Prefs-Datei, können also auch im  Einstellungsfenster  vor-
genommen werden. Folgende Tooltypes werden derzeit unterstützt:

  · PREFSFILE=name
      Pfad und Name der Voreinstellungsdatei. Sie wird als erstes eingelesen,
      zusätzliche Tooltypes überschreiben die jeweiligen Einstellungen.
      Diese Einstellung kann als einzige nur im Piktogramm geändert werden.
      Voreinstellung: "PROGDIR:ProRen.prf"

  · UNDO=<yes|no>
      damit läßt sich der Zustand des @{"Rückgängig" link UndoActiveGadget}-Gadgets im Einstellungs-
      fenster einstellen.
      Voreinstellung: yes

  · SEARCH=<yes|no>
      damit läßt sich der Zustand des @{"Suchen" link SearchGadget}-Gadgets einstellen.
      Voreinstellung: no

  · REQUEST=<yes|no>
      damit läßt sich der Zustand des @{"Fragen" link RequestGadget}-Gadgets einstellen.
      Voreinstellung: yes

  · START=<0-999999>
      damit läßt sich die voreingestellte @{"Startnummer" link NumberGadget} festlegen.
      Voreinstellung: 0

  · GAPMODE=<request|keep|delete|abort>
      dieses Merkmal legt den Zustand des @{"Lücken" link GapModeGadget}-Gadgets fest.
      Voreinstellung: request

  · ERRORMODE=<request|rename|abort>
      dieses Merkmal legt den Zustand des @{"Fehler" link ErrModeGadget}-Gadgets fest.
      Voreinstellung: request

  · PATTERN=dateimuster
      hier können Sie das voreingestellte @{"Dateimuster" link PatternGadget} angeben.
      Voreinstellung: "#?[0-9]"   (alle Dateien, die mit einer Ziffer enden)

  · BASENAME=name
      geben Sie hier den @{"Basisnamen" link BasenameGadget} an, den Sie gern voreingestellt hätten.
      Voreinstellung: "Anim."

  · DRAWER=verzeichnis
      geben Sie hier das @{"Verzeichnis" link DrawerGadget} an, das ProRen nach dem Start einliest.
      Voreinstellung: "SYS:"

  · TEMPNAME=name
      dieses Merkmal bestimmt den @{"temporären" link TempNameGadget} Namen.
      Voreinstellung: "tmp."

  · ERRORNAME=name
      dieses Merkmal bestimmt den @{"Fehlernamen" link ErrNameGadget}.
      Voreinstellung: "err."

  · DIGITS=<1-6>
      hier geben sie die voreingestellten Anzahl der @{"Stellen" link DigitsGadget} an.
      Voreinstellung: 3

  · USERNAME=<name>
      hier können Sie Ihren Namen eintragen, der für die Registrierung wichtig ist.
      Voreinstellung: NULL :-)

  · REGCODE=0
      wenn Sie registriert sind können Sie hier ihre Registriernummer eingeben,
      Voreinstellung: 0

  · WINDOWX=0, WINDOWY=0
      Diese Merkmale geben die Position des ProRen-Fensters auf dem Bild-
      schirm an.
      Voreinstellung: 0,0

  · WINDOWW=300, WINDOWH=400
      Diese Merkmale geben Breite und Höhe des ProRen-Fensters an. Sollten
      diese Werte zu groß, oder zu klein sein, werden sie automatisch
      korrigiert.
      Voreinstellung: 300,400
@endnode
@node TurboMode "automatischer Turbomodus"
Der  automatische  Turbomodus  wird  immer  dann  aktiviert,  wenn  es  beim
umbenennen  keine Lücken gibt. Es werden die Dateien dann nicht zweimal (auf
tmp. und dann auf den  Basisnamen),  sondern  nur  einmal  (gleich  auf  den
richtigen Namen) umbenannt. Dadurch benötigt ProRen auch nur halb soviel Zeit.

Wenn es Lücken gibt, werden die Dateien deshalb  zweimal  umbenannt,  da  es
nicht  100%ig  zu  entscheiden ist, ob es beim Umbenennen zu einer Kollision
kommen wird, oder nicht, vorallem dann, wenn der Benutzer  bei  jeder  Lücke
gefragt werden soll.
@endnode
@node Register "Registrieren"
ProRen ist EMailWare.

Wenn  Sie  dieses  Programm  öfters  benutzen,   lassen   Sie   sich   bitte
registrieren. Die Registrierung eins einfach und kostenlos. Sie brauchen mir
nur ein EMail schicken. Schreiben Sie keine Romane, ein einfaches "Ich heiße
Thomas  Muster  und  möchte mich für ProRen registrieren" reicht völlig. Sie
bekommen dann in den nächsten Tagen ein EMail mit  ihrem  Registrationscode,
den Sie einfach im @{"Einstellungsfenster" link Gadgets} eintragen.

Wenn  Sie  registriert  sind,  werden  Sie  nicht  mehr  dauernd  von  einem
Nervrequester gestört.

Wenn Sie keinen Internetzugang haben, können Sie  mir  auch  einen  normalen
Brief  schreiben, aber wenn ein Freund einen Internetzugang hat, dann bitten
Sie ihn um diesen Gefallen (Auslandsbriefmarken sind in Österreich  wirklich
sauteuer :-( ).

Hier die Liste der registrierten User (Danke):
  Marcel    Halbeisen   CH   (der Erste registrierte User überhaupt!)
  Pat       Kushko      CA
  Maurice   Powell      AU
  Colin     Thompson    COM  San Diego
  Michael   Ulbrich     DE
@endnode
@node UserName "BenutzerName"
In diesem Feld tragen Sie bitte Ihren Namen ein, der  ist  wichtig  für  die
@{"Registrierung" link Register}.
@endnode
@node RegCode "RegistrierungsCode"
Hier geben Sie bitte 6-stelligen Code ein, der Ihnen bei einer Registrierung
zugesandt wird.
@endnode
@node Updates "Wo krieg ich neue Versionen?"
Updates gibts im Aminet (gfx/misc) oder auf derHomePage von ProRen:
http://stud3.tuwien.ac.at/~e9525802/proren/
Die benötigten libraries können ebenfalls von der HomePage bezogen werden.
@endnode
