Begriff: Diff-Archiv                            Binary Diff/Binary Patch

Die  Diff-Archive  kann man ganz einfach an ihrer Endung "bdf" erkennen,
wobei  es  meines  Wissens nach kein weiteres Programm fr Atari-Rechner
gibt,  das  eine  Datei  mit  der gleichen Endung erzeugt. Sollte dieser
Umstand  dennoch  mal  eintreten,  so ist das dennoch kein Problem, denn
Binary  Diff erkennt "seine" Archive eindeutig und weist falsche Archive
ntigenfalls mit einer Fehlermeldung zurck.

Mehrere  Archive  knnen  brigens ganz einfach zu einem einzigen Archiv
zusammengesetzt werden,  ohne  da  Binary  Diff  oder Binary Patch sich
darber  beschweren  wrden.  Man kann dies z.B. ausnutzen, um zwei oder
mehr Patches mit einem einzigen Archiv zu verbreiten.


Begriff: Kommentar                              Binary Diff/Binary Patch

Jedes  Archiv kann mehrere Kommentare beinhalten, die ausgegeben werden,
sobald  man  den  Inhalt  anzeigen,  auf  Fehler berprfen oder Dateien
aktualisieren lt.

Fr  den  Kommentartext  sind alle ASCII-Zeichen mit Ausnahme des ASCII-
Codes  0 erlaubt. Wird ein Kommentar einem Archiv hinzugefgt, so werden
alle  bereits existierenden Kommentare ohne Rckfrage entfernt und durch
einen einzigen Kommentar ersetzt.


Begriff: Kommentardatei                         Binary Diff/Binary Patch

Eine  Kommentardatei  sollte  man  einsetzen,  sobald  man  einen  mehr-
zeiligen  oder  umfangreichen  Kommentar einem Archiv hinzufgen mchte,
da  die  Kommandozeile einen mehrzeiligen Text nicht erlaubt. Der Inhalt
der  Datei  wird  dabei  unverndert  bernommen,  allerdings  sind  nur
maximal  1500  Zeichen  im Augenblick erlaubt, ansonsten erhlt man eine
Fehlermeldung.

Man  sollte  es  aber  nicht  bertreiben  und jetzt irgendwelche ASCII-
Grafiken  anstelle  sinnvoller Information einsetzen, denn der Kommentar
ist  dazu gedacht, dem Anwender des Diff-Archives wichtige Informationen
mitzuteilen, die beachtet werden sollten.


Begriff: Regulrer Ausdruck                     Binary Diff/Binary Patch

Alle  Dateinamen  knnen, sofern das gewhlte Kommando es erlaubt, nicht
nur  in  der blichen Schreibweise (z.B. 12345678.ABC) angegeben werden,
sondern auch unter Zuhilfenahme eines Regulren Ausdrucks.

Ein  Regulrer  Ausdruck  erlaubt  es,  neben den normalen Zeichen unter
Zuhilfenahme  von  Sonderzeichen ganze Auswahlgruppen mit einem einzigen
Ausdruck zu bestimmen.

Folgende Sonderzeichen sind definiert:

 Zeichen  Funktion

    \     Das folgende  Zeichen wird  direkt bernommen.  Damit ist es
          mglich, auch Sonderzeichen suchen zu lassen, ohne die damit
          verbundene Funktion innerhalb eines  Regulren Ausdrucks  zu
          aktivieren

    ?     Dieses Sonderzeichen ist ein  Platzhalter fr ein beliebiges
          Zeichen

    *     Der Stern ist ebenfalls ein Platzhalter, allerdings fr eine
          beliebig groe Anzahl an Zeichen, also auch kein Zeichen.

    [     Mit diesem Sonderzeichen kann man eine Zeichenklasse einlei-
          ten,  die mit einem "]" endet.  Innerhalb der  Zeichenklasse
          ist eine  simple  Aufzhlung  der zulssigen  Zeichen ebenso
          mglich wie die Angabe eines Bereiches oder die  Inverse der
          Zeichenklasse  durch das  Zeichen "^",  welches  unmittelbar
          hinter dem Zeichen "[" folgen mu ("[^...]").

    ]     Dieses Sonderzeichen beendet eine Zeichenklasse

Beispiele:

      \a      entspricht dem Buchstaben "a"
      \\       entspricht dem Zeichen "\"
      \*       entspricht dem Zeichen "*"

      ?        trifft auf alle Dateien und Verzeichnisse zu, die aus
               nur einem einzigen Buchstaben bestehen
      a?c      trifft z.B. auf "aac", "abc", "acc" usw. zu

      a*       trifft auf alle Dateien und Verzeichnisse zu, die mit
               dem Buchstaben "a" beginnen
      *a       trifft auf alle Dateien und Verzeichnisse zu, die mit
               dem Buchstaben "a" enden
      *a*      trifft auf alle Dateien und Verzeichnisse zu,  die in
               ihrem Namen den Buchstaben "a" aufweisen

      [a]      ist die kleinstmgliche Zeichenklasse. Sie umfat nur
               ein einziges Zeichen,  in diesem Fall  den Buchstaben
               "a".
      [a-f]    umfat alle Buchstaben von "a" bis "f"
      [a-f0-9] umfat alle Buchstaben von "a" bis "f" sowie die
               Ziffern von "0" bis einschlielich "9"
      [^a]     umfat alle Zeichen auer dem "a"
      [^a-f]   umfat alle Zeichen auer "a" bis "f"


Um  z.B. smtliche Dateien zu aktualisieren, die mit einem "a", "b" oder
"c" beginnen und die vom Typ "Resource" (Dateiendung "rsc") sind, reicht
folgender Regulrer Ausdruck aus:

      [a-c]*rsc

Smtliche Dateien,  die auf "Kosten90", "Kosten91", usw. lauten, und die
entwender vom  Typ  "Text"  (TXT) oder "Document" (DOC) sind, erhlt man
mit dem folgenden Ausdruck:

      *kosten9[0-9]*[td][xo][tc]


Begriff: Kurzform/Langform                      Binary Diff/Binary Patch

Unter der  Kurzform  versteht  man  ein  Kommando  bzw.  einen Schalter,
das/der aus  einem einzigen Buchstaben besteht.   Ein  Kommando  beginnt
dabei   immer   mit    einem  einzelnen  Minuszeichen  gefolgt  von  dem
Buchstaben, der das jeweilige    Kommando  auswhlt.    Schalter  knnen
getrennt  von  Kommandos  stehen  und    werden dann ebenfalls mit einem
einzelnen Minuszeichen   eingeleitet.      Mehrere   aufeinanderfolgende
Schalter knnen  zusammengesetzt  werden.  Dies  gilt auch fr Schalter,
die einem Kommando folgen.  Dabei wird nur das Kommando bzw.  der  erste
Schalter mit einem Minuszeichen eingeleitet.

Die  Langform beginnt immer mit zwei Minuszeichen gefolgt von mindestens
einem Buchstaben. Das Kommando oder der Schalter mu  nicht  vollstndig
ausgeschrieben werden.    Es  reicht  aus,  wenn  das  Kommando oder der
Schalter vom Namen her eindeutig ist.  Eine Besonderheit  gibt  es  noch
bei    den  Schaltern, die von einem Parameter begleitet werden: whrend
man bei  der Kurzform unmittelbar  hinter  den  Schalter  den  Parameter
angeben  kann,   mu man bei der Langform den Parameter durch mindestens
ein Leerzeichen  vom eigentlichen Schalternamen absetzen.

Kurzform und Langform kann man beliebig mischen, nur mu  eine  Langform
immer getrennt von dem Kommando oder den Schaltern angegeben werden.

Beispiele:

Die folgenden Beispiele sind jeweils identisch zueinander:

      bindiff -b 100000 test pfad.1 pfad.2
      bindiff -a -b 100000 test pfad.1 pfad.2
      bindiff -a -b100000 test pfad.1 pfad.2
      bindiff -ab100000 test pfad.1 pfad.2
      bindiff --add --buffer-size 100000 test pfad.1 pfad.2
      bindiff --ad --buf 100000 test pfad.1 pfad.2
