From 8074f5db0cd8a3b2e60600da74679ed5ad6357cc Mon Sep 17 00:00:00 2001
From: Werner Lemberg <wl@gnu.org>
Date: Fri, 14 Aug 2020 09:09:13 +0200
Subject: [PATCH] Kleine Durchsicht der Dokumentation.

---
 dokumente/Alternativtrennungen.txt |  10 ++-
 dokumente/Gesangstext.txt          |   4 +-
 dokumente/MANIFEST                 |  16 +++-
 dokumente/Trennzeichen-HOWTO.txt   | 163 +++++++++++++++++++------------------
 4 files changed, 106 insertions(+), 87 deletions(-)

diff --git a/dokumente/Alternativtrennungen.txt b/dokumente/Alternativtrennungen.txt
index d6084eb..8a8c605 100644
--- a/dokumente/Alternativtrennungen.txt
+++ b/dokumente/Alternativtrennungen.txt
@@ -6,12 +6,13 @@ Maßgabe (Erkenntnis oder Empfinden) des Schreibers.
 Damit ist kein zwingender Grund vorhanden, alle Auszeichnungen des Dudens
 (oder anderer Wörterbücher) zu übernehmen.
 
-In der »Wortliste« werden Alternativtrennungen gekennzeichnet, wenn sie für
+In der „Wortliste“ werden Alternativtrennungen gekennzeichnet, wenn sie für
 hilfreich (oder zumindest unschädlich) für das Textverständnis und günstig
 für die Silbentrennung in Notentexten angesehen werden.
 
 Vorschläge 2018-11-14
 
+
 Alternativen gekennzeichnet
 ---------------------------
 
@@ -49,13 +50,14 @@ Kein Glottisschlag in üblicher Aussprache (wichtig im Notentext):
 
 egal
 ----
+
 Keine eindeutige Auswirkung auf Worterkennung oder Gesang.
 
-"amorphemische" Aussprache ohne Auswirkung im Gesang:
+„Amorphemische“ Aussprache ohne Auswirkung im Gesang:
 
   prä<g-nant # < lat. praegnans (schwanger)
 
-s-t und s-p bei verblasster Herkunft (beide Trennungen gleich schlecht):
+„s-t“ und „s-p“ bei verblasster Herkunft (beide Trennungen gleich schlecht):
 
   De<s-ti-na-ti.on
   Di<s-tanz
@@ -68,7 +70,7 @@ unklare Aussprache:
 
   San-t=i.a-go # [san tjago] oder [sant jago]
 
-kein Glottisschlag in üblicher Aussprache aber selten im Notentext und
+Kein Glottisschlag in üblicher Aussprache aber selten im Notentext und
 ggf. bessere Worterkennung bei morphemischer Trennung:
 
   Me-di<ä-vist # < lat. medium aevum (Mittelalter)
diff --git a/dokumente/Gesangstext.txt b/dokumente/Gesangstext.txt
index 41baef3..2169a04 100644
--- a/dokumente/Gesangstext.txt
+++ b/dokumente/Gesangstext.txt
@@ -25,7 +25,7 @@ und Trennungen zwischen Vokal und Halbvokal (vergleiche Trennstile.txt):
   :Liedtext:    „Ju-gend al-ler Na-tio-nen…“
 
   :Duden(2006): Mil-li-o-när
-  :Liedtext:    „Ich wär so gerne Mil-io-när“ (Prinzen)
+  :Liedtext:    „Ich wär so gerne Mill-io-när“ (Prinzen)
 
   :Duden(2006): Eman-zi-pa-ti-on
   :Liedtext:    „zum Zei-chen Dei-ner E-man-zi-pa-tion…“ (R. Mey)
@@ -61,9 +61,9 @@ abc:
   Silbentrennzwichen „-“
 
 
-
 Referenzen
 ----------
+
 An die Freude
   https://de.wikisource.org/wiki/Datei:De_Schauenburg_Allgemeines_Deutsches_Kommersbuch_078.jpg
 
diff --git a/dokumente/MANIFEST b/dokumente/MANIFEST
index d7ad4f9..4cd66ab 100644
--- a/dokumente/MANIFEST
+++ b/dokumente/MANIFEST
@@ -8,12 +8,26 @@ index.md
 # nach HTML konvertiert werden.
 
 README.wortliste
-# -*- coding: utf-8 -*-
 # Beschreibt das Wortlistenformat.
 
+Trennzeichen-HOWTO.txt
+# Ein Leitfaden für Bearbeiter der „wortliste“-Datei.
+
+Trennstile.txt
+# Ausführliche Beschreibung von verschiedenen Trennstilen, die großteils
+# im Skript „sprachauszug.py“ implementiert sind.
+
 new-patterns
 # Spartanische Anleitung zum Erzeugen und Installieren neuer Trennmuster.
 
+Alternativtrennungen.txt
+# Diskutiert alternative Trennungen, welche hilfreich für das
+# Textverständnis und günstig für die Silbentrennung in Notentexten sein
+# können.
+
+Gesangstext.txt
+# Dokumentiert Trennungen in Notentexten und deren Unterstützung in Software.
+
 Praefixassimilation.txt
 # Enthält eine Zusammenstellung assimilierter griechisch-lateinischer Präfixe
 # und dokumentiert deren Behandlung bei der Trennstellenauszeichnung in der
diff --git a/dokumente/Trennzeichen-HOWTO.txt b/dokumente/Trennzeichen-HOWTO.txt
index e668966..520a3cd 100644
--- a/dokumente/Trennzeichen-HOWTO.txt
+++ b/dokumente/Trennzeichen-HOWTO.txt
@@ -40,14 +40,14 @@ Zwingende Gründe
 
   | Kor<re<lation # nicht Kor-re<lation, da Ko- + (re- + lation)
 
-bei "Wahlfreiheit"
+bei „Wahlfreiheit“
 ~~~~~~~~~~~~~~~~~~
 
-Ist der Fugentrenner ist hilfreich für
+Ist der Fugentrenner hilfreich für
 
-- dem Leser (Vorzugstrennung für leichteres Sinnerfassen oder Vorlesen),
-- die maschinelle Verarbeitung (Trenstil-Filter, Ligaturaufbruch, Langes-S)?
-- den Wortlisteneditor (Einfachheit, Systematik)
+- den Leser (Vorzugstrennung für leichteres Sinnerfassen oder Vorlesen),
+- die maschinelle Verarbeitung (Trenstil-Filter, Ligaturaufbruch, Lang-s),
+- den Wortlisteneditor (Einfachheit, Systematik)?
 
 Abwägen der Argumente:
 
@@ -65,11 +65,10 @@ Abwägen der Argumente:
 
   - Bedeutung erschließt sich aus der Bedeutung der Teile
 
-    | Di<pte-ren # griech. (Zweiflügler)
+    | Di<pte-ren  # griech. (Zweiflügler)
     | Ko-ni<fe-re # < lat. cōnus (Zapfen) + ferre (tragen)
 
-  - Trennstelle nach dem 2. Buchstaben günstiger als die
-    folgende
+  - Trennstelle nach dem 2. Buchstaben günstiger als die folgende
 
     | en<har-mo-nisch # Vorzugstrennung en-harmonisch
     | ir<re-gu-lär    # Vorzugstrennung ir-regulär
@@ -79,8 +78,8 @@ Abwägen der Argumente:
 
 * für „einfache“ Trennzeichen („-“):
 
-  - Wahrnehmung als „einfach“ (Teile wenig bekannt,
-    Bedeutung nicht aus den Teilen hergeleitet)
+  - Wahrnehmung als „einfach“ (Teile wenig bekannt, Bedeutung nicht aus den
+    Teilen hergeleitet)
 
     | Ap-pe-tit # trotz < lat. appetitus < adpetō < ad- + petō.
     | Ap-pa-rat # trotz < lat. apparatus < ad- + parare
@@ -92,22 +91,21 @@ Abwägen der Argumente:
 
   - Ligaturen erlaubt
 
-    | Af-fekt       # trotz < lat. afficere < ad- + facere
-    | as-similiert  # trotz < lat. ad- + similāre, da ſſ-Ligatur in Fraktur
-    | of-fe-rie-ren    # keine Vorzugstrennung
-    | Ac-ce-le-ran-do  # keine Vorzugstrennung
-    | Il-lus-tra-tion  # keine Vorzugstrennung, ll-Ligatur im Fraktursatz
+    | Af-fekt         # trotz < lat. afficere < ad- + facere
+    | as-similiert    # trotz < lat. ad- + similāre, da ſſ-Ligatur in Fraktur
+    | of-fe-rie-ren   # keine Vorzugstrennung
+    | Ac-ce-le-ran-do # keine Vorzugstrennung
+    | Il-lus-tra-tion # keine Vorzugstrennung, ll-Ligatur im Fraktursatz
 
-  - im Fraktursatz ſ am Silbenende (im Gegensatz zum Schluss-s in
-    Wörtern wie aus<tre-ten):
+  - im Fraktursatz „ſ“ am Silbenende (im Gegensatz zum Schluss-s in
+    Wörtern wie „aus<tre-ten“):
 
-    | Des-sert         # Deſſert
-    | Abs-trakt        # Abſtrakt (in de-1901 Abs-trakt)
-    | os-ten-ta-tiv    # oſtentativ, trotz < lat. ostendere < ob- + tendō
-    | as-similiert     # aſſimiliert
+    | Des-sert      # Deſſert
+    | Abs-trakt     # Abſtrakt (in de-1901 Abs-trakt)
+    | os-ten-ta-tiv # oſtentativ, trotz < lat. ostendere < ob- + tendō
+    | as-similiert  # aſſimiliert
     
 
-
 Präfix oder Teilwort
 --------------------
 
@@ -133,7 +131,7 @@ Baustelle:
 Zusammengesetzte Präfixe???
 
 Derzeit gibt es 15 komplexe vorangestellte Konfixe, die mit
-"<<" abgeteilt sind bei 50 Vorkommen von "<<":
+„<<“ abgeteilt sind bei 50 Vorkommen von „<<“:
 
   all<er-go                   # < All<er-go<<lo-gie +0×
   an<äs-the-si·o              # < An<äs-the-si·o<<lo-gie +0×
@@ -164,8 +162,6 @@ und dem eigenständigen Grundwort
   -myelitis       # Myelitis
 
 
-
-
 unterdrückte Trennungen
 -----------------------
 
@@ -174,26 +170,27 @@ keine Trennung
 
 Trennzeichen stehen nur dort, wo auch getrennt werden darf.
 
-* Fugen_, an denen nicht getrennt wird werden nicht markiert.
+* Fugen_, an denen nicht getrennt wird, werden nicht markiert.
 
-  Das betrifft die meisten Suffixe (im Deutschen nach
-  „Sprechsilbenregel“ getrennt),
+  Das betrifft die meisten Suffixe (im Deutschen nach „Sprechsilbenregel“
+  getrennt),
 
-  | An<ord-nung  # An- + ordn + -ung
-  | nö-tig       # Not + -ig
+  | An<ord-nung # An- + ordn + -ung
+  | nö-tig      # Not + -ig
 
   und einige Präfixe auf „s“, welches „nicht mehr als Silbenauslaut
   empfunden“ und in gebrochenen Schriften mit Lang-s geschrieben wird
   (Duden 71, K44):
 
-  | obſolet    ob-so-let         # trotz < lat. obsoletus < obs- + alesco,
-  | tranſitiv  tran-si-tiv       # trotz < lat. trāns- + īre,
-  | Abſzeſs    Ab-szess;Ab-szeß  # trotz < lat. abs + cēdere,
+  | obſolet    ob-so-let        # trotz < lat. obsoletus < obs- + alesco,
+  | tranſitiv  tran-si-tiv      # trotz < lat. trāns- + īre,
+  | Abſzeſs    Ab-szess;Ab-szeß # trotz < lat. abs + cēdere,
+
 
 Gesangstext
 ~~~~~~~~~~~
 
-* Wo nur im Gesangstext getrennt wird steht „·“ oder „<·“.
+* Wo nur im Gesangstext getrennt wird, steht „·“ oder „<·“.
 
   | A·bend=a·b<i-tur  # einbuchstabige Silben am Wortrand
   | Form=a<·spekt
@@ -218,8 +215,6 @@ es sei denn, die Trennung soll im Gesangstext unterdrückt werden:
   | Thy-mi.an  # Schwankungsfall (meist zwei Sprechsilben)
 
 
-
-
 Details, Motivation und Hintergrundinformationen
 ================================================
 
@@ -232,15 +227,15 @@ An der Grenze funktionstragender Einheiten (Morpheme) gelten besondere
 Regeln für Aussprache, Typographie und Orthographie.
 
 Diese besondere Qualität wird in der Trennliste durch unterschiedliche
-Zeichen für die "Kategorie" der Trennstelle gekennzeichnet:
+Zeichen für die „Kategorie“ der Trennstelle gekennzeichnet:
 
-  „=“   zwischen Teilwörtern: Wort=fu-ge
+  =   zwischen Teilwörtern: Wort=fu-ge
 
-  „<“   nach Präfix, Konfix oder Verbalpartikel: Vor<sil-be, auf<zäh-len
+  <   nach Präfix, Konfix oder Verbalpartikel: Vor<sil-be, auf<zäh-len
 
-  „>“   vor Suffix: Gleich>heit, Freund>schaf-ten
+  >   vor Suffix: Gleich>heit, Freund>schaf-ten
 
-  „·“   Randtrennung, die nur im Gesangstext_ getrennt werden darf
+  ·   Randtrennung, die nur im Gesangstext_ getrennt werden darf
 
 
 Fugenmerkmale
@@ -263,8 +258,7 @@ Nach *Präfix* und *Teilwörtern* erfolgt normalerweise eine Aussprachezäsur:
   | auf<atmen   [ˈaʊ̯fˌʔaːtmən]
   | Feier=abend [ˈfaɪ̯ɐˌʔaːbn̩t]
 
-Bei *Suffixen* folgt die Aussprache den Regeln für einfache
-Wörter.
+Bei *Suffixen* folgt die Aussprache den Regeln für einfache Wörter.
 
 * verbundene Aussprache, kein Glottisschlag
 
@@ -279,13 +273,14 @@ Wörter.
 
 Worttrennung
 """"""""""""
+
 Zwischen *Präfixen* und *Teilwörtern* darf stets getrennt werden, auch
 
-* vor einem Vokal: auf<atmen, Feier=abend
-* vor mehr als einem Konsonanten: An<trag, ab<steigen (auch NR)
-* zwischen st: aus<tragen (auch AR)
+* vor einem Vokal: auf<atmen, Feier=abend,
+* vor mehr als einem Konsonanten: An<trag, ab<steigen (auch NR),
+* zwischen „st“: aus<tragen (auch AR).
 
-dabei wird in der Regel keine Rücksicht auf die Aussprache genommen:
+Dabei wird in der Regel keine Rücksicht auf die Aussprache genommen:
 
   war=um, Dia<spora, Heliko<pter
 
@@ -295,8 +290,8 @@ der Fuge sind nur für Vokale im Gesangstext erlaubt:
   Fei-er=a·bend, zo·o<lo-gisch, Vi-de·o<spiel
 
 Die aktuelle Rechtschreibung erlaubt alternativ Trennungen wie in einfachen
-Wörtern, wenn Wörter "nicht mehr als Zusammensetzung empfunden oder erkannt
-werden":
+Wörtern, wenn Wörter „nicht mehr als Zusammensetzung empfunden oder erkannt
+werden“:
 
   He-li-ko>p-ter
 
@@ -309,8 +304,10 @@ Gelegentlich stimmen Silbengrenze und Morphemgrenze überein:
 
   höf>lich, drei>fach, Astero>id
 
+
 Ligaturen
 """""""""
+
 Ligaturen werden nicht genutzt, wenn an einer Morphemgrenze getrennt werden
 darf:
 
@@ -321,23 +318,24 @@ Ausnahme: vollständig assimilierte Präfixe:
   | offensiv, Affekt
   | assimiliert, Illustration (im Fraktursatz)
 
-Ligaturen werden gesetzt bei „verlegter“ Sprachsilbengrenze vor Suffixen
+Ligaturen werden bei „verlegter“ Sprachsilbengrenze vor Suffixen gesetzt:
 
   häufig [ˈhɔɪ̯fɪç] trotz Hauf(en) + -ig
 
+
 S-Schreibung
 """"""""""""
+
 Vor Morphemgrenzen, an denen getrennt werden darf, wird in Fraktur ein
 Schluss-s geschrieben:
 
   Aus<ſage, Alles=wiſſer, Wachs>tum, Anders>ſon
 
-Im Silbenanlaut wird Lang-S geschrieben, auch vor Morphemgrenzen:
+Im Silbenanlaut wird Lang-s geschrieben, auch vor Morphemgrenzen:
 
   wach-ſen, flüſ-ſig
 
 
-
 „Verblasste“ Morphologie
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -349,17 +347,17 @@ aber nicht mehr als solche empfunden oder erkannt werden“. Dies betrifft
 insbesondere Lehnwörter und indirekt übernommene Verbindungen sowie
 Verbindungen mit assimiliertem Präfix.
 
-Dabei können einzelne oder mehrere der typischen Fugenmerkmale↗
-wegfallen:
+Dabei können einzelne oder mehrere der typischen Fugenmerkmale↗ wegfallen:
 
 Aussprache
 """"""""""
+
 Wegfall der Zäsur an der Morphemgrenze bei Konsonantendoppelung:
 
-  | aggressiv   [aɡʁɛˈsiːf]              versus  weggehen [ˈvɛkˌɡeːən]
-  | suggerieren [zʊɡeˈʁiːʁən]            versus  Fluggast [ˈfluːkˌɡast]
-  | Dessert     [dɛˈseːɐ̯] / [dɛˈsɛʁt]    versus  Aussage  [ˈaʊ̯sˌzaːɡə]
-  | Affekt      [aˈfɛkt] < ad- + facere  versus  Auffahrt [ˈaʊ̯fˌfaːɐ̯t]
+  | aggressiv   [aɡʁɛˈsiːf]              vs.  weggehen [ˈvɛkˌɡeːən]
+  | suggerieren [zʊɡeˈʁiːʁən]            vs.  Fluggast [ˈfluːkˌɡast]
+  | Dessert     [dɛˈseːɐ̯] / [dɛˈsɛʁt]    vs.  Aussage  [ˈaʊ̯sˌzaːɡə]
+  | Affekt      [aˈfɛkt] < ad- + facere  vs.  Auffahrt [ˈaʊ̯fˌfaːɐ̯t]
 
 Kein Glottisschlag bei vokalischem Anlaut:
 
@@ -373,17 +371,19 @@ Sprachsilben abweichend von der Fuge:
   | war=um      [vaˈʁʊm]
   | Helikopter  [heliˈkɔptɐ]
   | Hier<onymus [hi̯eˈʁonymʊs]
-  | abstrakt    [apˈstʁakt]    versus  Verdauungstrakt [fɛɐ̯ˈdaʊ̯ʊŋsˌtʁakt]
+  | abstrakt    [apˈstʁakt]    vs.  Verdauungstrakt [fɛɐ̯ˈdaʊ̯ʊŋsˌtʁakt]
+
 
 Worttrennung
 """"""""""""
+
 Die neue Rechtschreibung erlaubt sowohl einfache als auch morphologische
 Trennung, wenn zusammengesetzte Wörter „nicht mehr als solche empfunden oder
 erkannt werden“ (§113).
 
 Vereinzelte Fälle wurden schon vor 1996 nach Aussprache getrennt:
 
-  | Hi.e-ro-ny-mus  trotz ἱερός + ὄνομα
+  | Hi.e-ro-ny-mus  trotz  ἱερός + ὄνομα
   | ab-strakt       trotz  < abs- + trahere
   | A·kro-nym       trotz  < ἄκρος + ὄνυμα
   | Ka-tho-de       trotz  < κάθοδος < κατα- + ὁδός (hodos)
@@ -391,49 +391,52 @@ Vereinzelte Fälle wurden schon vor 1996 nach Aussprache getrennt:
 
 Ligaturen
 """""""""
+
 Bei verlegter Trennstelle und vollständig assimilierten Präfixen werden
 Ligaturen auch über Morphemgrenzen gesetzt:
 
-  | abſtrakt  # ſt-Ligatur im Fraktursatz
-  | illegal   # ll-Ligatur im Fraktursatz
+  | abſtrakt # ſt-Ligatur im Fraktursatz
+  | illegal  # ll-Ligatur im Fraktursatz
   | offiziell
 
+
 S-Schreibung
 """"""""""""
-Ein S-Laut, der gemäß Aussprache und Worttrennung im Silbenanlaut auftritt
-wird auch vor der Morphemgrenze mit Lang-ſ geschrieben:
 
-  | abſtrakt    trotz < lat. abs- + trahere
-  | Deſſert     trotz < franz. dessert < lat. des- + servīre
-  | aſſimiliert trotz < lat. assimilāre < ad- similāre
+Ein S-Laut, der gemäß Aussprache und Worttrennung im Silbenanlaut auftritt
+wird auch vor der Morphemgrenze mit Lang-s geschrieben:
 
+  | abſtrakt     trotz  < lat. abs- + trahere
+  | Deſſert      trotz  < franz. dessert < lat. des- + servīre
+  | aſſimiliert  trotz  < lat. assimilāre < ad- similāre
 
 
 Eigenschaften der Trennzeichen
 ------------------------------
 
-Die folgenden Eingenschaften der Trennzeichen werden in Skripten zur
-Konsistenzprüfung, zum Ligaturaufbruch und zur Lang-S-Wandlung benutzt:
+Die folgenden Eigenschaften der Trennzeichen werden in Skripten zur
+Konsistenzprüfung, zum Ligaturaufbruch und zur Lang-s-Wandlung benutzt:
 
-* An Trennstellen, die den „einfachen“ Regeln widersprechen stehen
-  „<“, „=“ oder „>“.
+* An Trennstellen, die den „einfachen“ Regeln widersprechen, stehen „<“, „=“
+  oder „>“.
 
-* Vor den Morphemtrennern „<“, „=“ und „>“ wird stets ein Schluss-s gesetzt.
+* Vor den Morphemtrennern „<“, „=“ und „>“ wird stets ein Schluss-s
+  gesetzt.
 
 * Morphemtrenner verhindern die Bildung von Ligaturen.
 
-* Der Trennstil "hyphenmin3" (↗Trennstile.txt) entfernt Trennungen im
+* Der Trennstil „hyphenmin3“ (↗Trennstile.txt) entfernt Trennungen im
   Abstand 2 vom Wortrand
 
-    Ba-ga-tel-le              ->  Baga-telle
-    Fei-er=tags==zu<schlä-ge  ->  Feier-tags-zuschläge
+    Ba-ga-tel-le              →  Baga-telle
+    Fei-er=tags==zu<schlä-ge  →  Feier-tags-zuschläge
+
+  mit Ausnahme morphemischer oder günstiger Trennung am Wortanfang
 
-  mit Ausnahme morphemischer oder günstiger Trennung
-  am Wortanfang
+    Ab<bruch    →  Ab-bruch
+    Ei=sa-lat   →  Ei-salat
+    il--le-gal  →  il-le-gal
 
-    Ab<bruch       -> Ab-bruch
-    Ei=sa-lat      -> Ei-salat
-    il--le-gal     -> il-le-gal
 
 Referenzen
 ==========
-- 
2.11.4.GIT