For English installation instructions, see end of this file.


**************
**  German  **
**************
Es folgen Installationshinweise für die experimentellen
deutschen Trennmuster.  Die Installation der Trennmuster für die
traditionelle Rechtschreibung des in der Schweiz gebräuchlichen
Standarddeutschs wird nicht ausdrücklich erwähnt, kann aber
analog erfolgen.  TeX benötigt dann jedoch zusätzlichen
Speicherplatz für die Trennmuster.

Die folgenden Installationswege werden beschrieben:

1. teilautomatisierte Installation in MiKTeX mit Hilfe der
   Paketverwaltung,
2. manuelle Installation in MiKTeX mit graphischer Oberfläche,
3. manuelle Installation in MiKTeX auf der Kommandozeile,
4. manuelle Installation in TeX Live auf der Kommandozeile.

Nachfolgend ist <datum> jeweils durch die ISO-Notation des
Datums der Trennmusterdateien zu ersetzen (JJJJ-MM-TT).


*************************************************
**  Teilautomatisierte Installation in MiKTeX  **
**  mit Paketverwaltung                        **
*************************************************
Das Paket ist zunächst mit der Paketverwaltung
"Browse Packages" zu installieren.  Danach ist Schritt C der
manuellen Installation in MiKTeX mit graphischer Oberfläche
zu befolgen (siehe nächster Abschnitt).


***************************************
**  Manuelle Installation in MiKTeX  **
**  mit graphischer Oberfläche       **
***************************************
Die Installation der experimentellen Trennmuster erfordert
drei Schritte:

A. Die Trennmuster- und Wrapperdateien sollten in die
  folgenden Verzeichnisse innerhalb eines lokalen
  TEXMF-Baums kopiert werden:

     tex\generic\dehyph-exptl\dehyphn-x-<datum>.pat
     tex\generic\dehyph-exptl\dehyphn-x-<datum>.tex
     tex\generic\dehyph-exptl\dehypht-x-<datum>.pat
     tex\generic\dehyph-exptl\dehypht-x-<datum>.tex

 Die verbleibenden Dateien können in das Verzeichnis

     doc\generic\dehyph-exptl\

 kopiert werden.


B. Aktualisieren der File Name Database:

   Programm 'Settings'
     -->  Reiter 'General'
       -->  Knopf 'Refresh FNDB'


C. Anlegen der Sprachen und Erstellen der Formatdateien:

   Programm 'Settings'
     -->  Reiter 'Languages'
       -->  Knopf 'New'
         -->  Feld 'Language Name' : german-x-<datum>
         -->  Feld 'Synonyms' : german-x-latest
         -->  Feld 'Hyphenation File' : <texmfbaum>\tex\generic\dehyph-exptl\dehypht-x-<datum>.tex
         -->  Box 'Load the hyphenation file' : aktiv
         -->  Knopf 'OK'
       -->  Knopf 'New'
         -->  Feld 'Language Name' : ngerman-x-<datum>
         -->  Feld 'Synonyms' : ngerman-x-latest
         -->  Feld 'Hyphenation File' : <texmfbaum>\tex\generic\dehyph-exptl\dehyphn-x-<datum>.tex
         -->  Box 'Load the hyphenation file' : aktiv
         -->  Knopf 'OK'
       Vorhandene Synonyme [n]german-x-latest anderer Sprachen
         sind gegebenenfalls zu entfernen.
       -->  Knopf 'Ok'
     -->  Meldung 'To apply the new settings, it is necessary to rebuild the format files.'
       -->  Knopf 'OK'

    Wenn der letzte Schritt mit der Meldung

      >TeX capacity exceeded, sorry [pattern memory=XXX]

    oder

      >TEX capacity exceeded, sorry [pattern memory ops=XXX]

    fehlschlägt, so müssen Sie andere Sprachen deaktivieren
    oder die Parameter trie_size und trie_op_size anpassen.
    Bitte lesen Sie dazu die Dokumentation Ihrer
    TeX-Verteilung oder fragen Sie jemanden, der das Problem
    lösen kann.


***************************************
**  Manuelle Installation in MiKTeX  **
**  auf der Kommandozeile            **
***************************************
Achtung: Die manuelle Installation in MiKTeX wird nicht
empfohlen, da die Datei language.dat in der Regel automatisch
verwaltet wird, hier jedoch von Hand Änderungen vorgenommen
werden.  Es kann daher bei späteren (unabhängigen) Updates zu
Problemen kommen!

Die manuelle Installation der experimentellen Trennmuster
erfordert vier Schritte:

A. siehe Schritt A im Abschnitt "Manuelle Installation in
  MiKTeX mit graphischer Oberfläche".


B. Anlegen der Sprachen:

 1. Ermitteln des Pfades der Datei language.dat:

     >findtexmf language.dat

    Falls das Ergebnis des obigen Kommandos ein Pfad zu einem
    lokalen TEXMF-Baum ist, existiert bereits eine lokale
    Kopie der Datei language.dat.  Springe zu Punkt B.3.

 2. Eine lokale Kopie von language.dat existiert bisher nicht.
    Kopiere die Datei aus dem in Schritt B.1 erhaltenen Pfad
    in einen lokalen TEXMF-Baum, zum Beispiel nach

      C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\MiKTeX\2.7\tex\generic\config\language.dat

 3. Öffne die Datei language.dat aus dem lokalen TEXMF-Baum in
    einem Editor.

 4. Falls vorhanden, entferne Zeilen

 =german-x-latest
 =ngerman-x-latest

 5. Füge am Ende der Datei die folgenden Zeilen hinzu:

 german-x-<datum> dehypht-x-<datum>.tex
 =german-x-latest
 ngerman-x-<datum> dehyphn-x-<datum>.tex
 =ngerman-x-latest

 6. Datei language.dat speichern und schließen.


C. Aktualisieren der File Name Database:

   Kommando

     >initexmf --update-fndb

   aufrufen.


D. Anlegen der Formatdateien:

   Kommando

     >initexmf --dump

   aufrufen.

   Wenn dieses Kommando mit der Meldung

     >TeX capacity exceeded, sorry [pattern memory=XXX]

   oder

     >TEX capacity exceeded, sorry [pattern memory ops=XXX]

   fehlschlägt, so müssen Sie andere Sprachen in der Datei
   language.dat deaktivieren oder die Parameter trie_size
   und trie_op_size anpassen.  Bitte lesen Sie dazu die
   Dokumentation Ihrer TeX-Verteilung oder fragen Sie
   jemanden, der das Problem lösen kann.


*****************************************
**  Manuelle Installation in TeX Live  **
**  auf der Kommandozeile              **
*****************************************
Achtung: Die manuelle Installation in TeX Live wird nicht
empfohlen, da die Datei language.dat in der Regel automatisch
verwaltet wird, hier jedoch von Hand Änderungen vorgenommen
werden.  Es kann daher bei späteren (unabhängigen) Updates zu
Problemen kommen!

In TeX Live ist dieses Paket bereits vorinstalliert und
ohne weitere Vorkehrungen nutzbar.

Die Installation der experimentellen Trennmuster erfordert
vier Schritte:

A. Die Trennmuster- und Wrapperdateien sollten in die
  folgenden Verzeichnisse innerhalb eines lokalen
  TEXMF-Baums kopiert werden:

     tex/generic/dehyph-exptl/dehyphn-x-<datum>.pat
     tex/generic/dehyph-exptl/dehyphn-x-<datum>.tex
     tex/generic/dehyph-exptl/dehypht-x-<datum>.pat
     tex/generic/dehyph-exptl/dehypht-x-<datum>.tex

 Die verbleibenden Dateien können in das Verzeichnis

     doc/generic/dehyph-exptl/

 kopiert werden.


B. Anlegen der Sprachen:

 1. Ermitteln des Pfades der Datei language.dat:

     >kpsewhich language.dat

    Falls das Ergebnis des obigen Kommandos ein Pfad zu einem
    lokalen TEXMF-Baum ist, existiert bereits eine lokale
    Kopie der Datei language.dat.  Springe zu Punkt B.3.

 2. Eine lokale Kopie von language.dat existiert bisher nicht.
    Kopiere die Datei aus dem in Schritt B.1 erhaltenen Pfad
    in einen lokalen TEXMF-Baum, zum Beispiel nach

      <TeXLiveWurzel>/texmf-local/tex/generic/config/language.dat

 3. Öffne die Datei language.dat aus dem lokalen TEXMF-Baum in
    einem Editor.

 4. Falls vorhanden, entferne Zeilen

 =german-x-latest
 =ngerman-x-latest

 5. Füge am Ende der Datei die folgenden Zeilen hinzu:

 german-x-<datum> dehypht-x-<datum>.tex
 =german-x-latest
 ngerman-x-<datum> dehyphn-x-<datum>.tex
 =ngerman-x-latest

 6. Datei language.dat speichern und schließen.


C. Aktualisieren der File Name Database:

   Kommando

     >mktexlsr

   aufrufen.


D. Anlegen der Formatdateien:

   Kommando

     >fmtutil --refresh

   aufrufen.

   Wenn dieses Kommando mit der Meldung

     >TeX capacity exceeded, sorry [pattern memory=XXX]

   oder

     >TEX capacity exceeded, sorry [pattern memory ops=XXX]

   fehlschlägt, so müssen Sie andere Sprachen in der Datei
   language.dat deaktivieren oder die Parameter trie_size
   und trie_op_size in der Datei texmf.cnf anpassen.  Bitte
   lesen Sie dazu die Dokumentation Ihrer TeX-Verteilung oder
   fragen Sie jemanden, der das Problem lösen kann.


******************************************************
**  English installation instructions for TeX Live  **
******************************************************
The following installation instructions don't mention
hyphenation patterns for traditional orthography of Standard
German as used in Switzerland explicitly.  However,
installation is analogous to the discussed patterns.  Be
warned, that installing all patterns might cause memory
problems for TeX.

Note, in the remaining text <date> refers to the pattern file
date in ISO notation (YYYY-MM-DD)!

Installation of the dehyph-exptl package requires four steps:

A. Copy pattern and wrapper files to the following location
  within a local texmf tree:

     tex/generic/dehyph-exptl/dehyphn-x-<date>.pat
     tex/generic/dehyph-exptl/dehyphn-x-<date>.tex
     tex/generic/dehyph-exptl/dehypht-x-<date>.pat
     tex/generic/dehyph-exptl/dehypht-x-<date>.tex

  The remaining files can be copied to

     doc/generic/dehyph-exptl/


B. Modify file language.dat:

 1. Determine the location of language.dat:

     >kpsewhich language.dat

    If the resulting path already points to a local tree,
    jump right to step B.3.

 2. A local copy of language.dat doesn't exist, yet.  Copy the
    file that was output in step B.1 to a local texmf tree,
    e.g.,

      <TeXLiveRoot>/texmf-local/tex/generic/config/language.dat

 3. Open language.dat from the local texmf tree into an
    editor.

 4. If existent, remove the following lines

 =german-x-latest
 =ngerman-x-latest

 5. Add the following lines to the end of language.dat:

 german-x-<date> dehypht-x-<date>.tex
 =german-x-latest
 ngerman-x-<date> dehyphn-x-<date>.tex
 =ngerman-x-latest

 6. Save file language.dat and close the editor.


C. Refresh file name database:

   Execute command

     >mktexlsr


D. Rebuild format files:

   Execute command

     >fmtutil --refresh

   In case this command fails with error message

     >TeX capacity exceeded, sorry [pattern memory=XXX]

   or

     >TEX capacity exceeded, sorry [pattern memory ops=XXX]

   some languages have to be deactivated in language.dat or
   parameters trie_size and trie_op_size have to be enlarged
   (probably in file texmf.cnf).  Please refer to the
   documentation of your TeX distribution or ask a TeX wizard.


END.