deploy: 6828882

Links.md

@@ -31,7 +31,6 @@
 * `tools/`
     * `grammarcheckers/`
         * [grammarchecker.cg3](tools-grammarcheckers-grammarchecker.cg3.html) ([src](https://github.com/giellalt/lang-apu/blob/main/tools/grammarcheckers/grammarchecker.cg3))
-            * `/`
     * `tokenisers/`
         * [tokeniser-disamb-gt-desc.pmscript](tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-apu/blob/main/tools/tokenisers/tokeniser-disamb-gt-desc.pmscript))
         * [tokeniser-gramcheck-gt-desc.pmscript](tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-apu/blob/main/tools/tokenisers/tokeniser-gramcheck-gt-desc.pmscript))

Makefile.in

@@ -978,9 +978,14 @@ $(foreach f,$(DOCSRC_XEROX),$(eval $(call make_md_files,$(f))))
 $(foreach f,$(DOCSRC_CG3),$(eval $(call make_md_files_cg3,$(f))))
 
 # Collect all target files into one big MD file:
+# Remove the VPATH prefix to create the header for each file/chapter:
 $(ALLINONE_MD_PAGE): $(VPATH_MDFILES)
-	$(AM_V_GEN)printf "# $(GLANGUAGE) description \n\nAll documents in one file\n\n" \
-	| cat - $(VPATH_MDFILES) > $@
+	$(AM_V_GEN)printf "# $(GLANGUAGE) language model documentation\n\nAll doc-comment documentation in one large file.\n" > $@
+	for f in $(VPATH_MDFILES); do \
+		header=$${f#"$(top_srcdir)/docs/"};\
+		printf "\n---\n\n# $$header \n\n" >> $@ ;\
+		cat $$f >> $@ ;\
+	done
 
 $(LINKS):
 	$(AM_V_GEN)for doc2md in $(DOCSRC_MDFILES) ; do \
@@ -998,24 +1003,32 @@ $(LINKS):
 		if test "x$$d1" != "x$$oldd1" ; then \
 			echo "* \`$$d1/\`" ;\
 			oldd1=$$d1 ;\
+			oldd2="";\
+			oldd3="";\
+			oldd4="";\
 		fi ; \
 		if test "x$$d2" = x ; then \
 			echo "    * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
 		elif test "x$$d2" != "x$$oldd2" ; then \
 			echo "    * \`$$d2/\`" ;\
 			oldd2=$$d2 ;\
+			oldd3="";\
+			oldd4="";\
+			oldd5="";\
 		fi ; \
 		if test "x$$d3" = x -a "x$$d2" != x; then \
 			echo "        * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
 		elif test "x$$d3" != "x$$oldd3" ; then \
 			echo "        * \`$$d3/\`" ;\
 			oldd3=$$d3 ;\
+			oldd4="";\
 		fi ; \
 		if test "x$$d4" = x -a "x$$d3" != x ; then \
 			echo "            * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\
 		elif test "x$$d4" != "x$$oldd4" ; then \
 			echo "            * \`$$d4/\`" ;\
 			oldd4=$$d4 ;\
+			oldd5="";\
 		fi ; \
 		if test "x$$d5" = x -a "x$$d4" != x ; then \
 			echo "                * [$$docname]($$html) ([src]($(REPOURL)/$$doc))" ;\

apu.md

@@ -1,6 +1,10 @@
-# Apurinã description 
+# Apurinã language model documentation
 
-All documents in one file
+All doc-comment documentation in one large file.
+
+---
+
+# src-cg3-functions.cg3.md 
 
 
 
@@ -170,7 +174,14 @@ These were the set types.
 ## HNOUN MAPPING
 
 * * *
-<small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-apu/blob/main/src/cg3/functions.cg3)</small>Adjective inflection
+
+<small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-apu/blob/main/src/cg3/functions.cg3)</small>
+
+---
+
+# src-fst-morphology-affixes-adjectives.lexc.md 
+
+Adjective inflection
 The Apurinã language adjectives compare.
 
 * * *
@@ -179,6 +190,8 @@ The Apurinã language adjectives compare.
 
 ---
 
+# src-fst-morphology-affixes-adverbs.lexc.md 
+
 Adverb inflection
 The APURINÃ language adverbs compare.
 
@@ -188,6 +201,8 @@ The APURINÃ language adverbs compare.
 
 ---
 
+# src-fst-morphology-affixes-nouns.lexc.md 
+
 Noun inflection
 The APURINÃ language nouns inflect in cases.
 
@@ -199,6 +214,8 @@ Suffixes
 
 ---
 
+# src-fst-morphology-affixes-prefixes.lexc.md 
+
 Prefixes
 Prefixes in the Apurinã language are bound to beginning of other words.
 
@@ -208,6 +225,8 @@ Prefixes in the Apurinã language are bound to beginning of other words.
 
 ---
 
+# src-fst-morphology-affixes-pronouns.lexc.md 
+
 Noun inflection
 The APURINÃ language nouns inflect in cases.
 
@@ -217,6 +236,8 @@ The APURINÃ language nouns inflect in cases.
 
 ---
 
+# src-fst-morphology-affixes-propernouns.lexc.md 
+
 Proper noun inflection
 The Apurinã language proper nouns inflect in the same cases as regular
 nouns, but with a colon (':') as separator.
@@ -227,6 +248,8 @@ nouns, but with a colon (':') as separator.
 
 ---
 
+# src-fst-morphology-affixes-symbols.lexc.md 
+
 
 # Symbol affixes
 
@@ -236,6 +259,8 @@ nouns, but with a colon (':') as separator.
 
 ---
 
+# src-fst-morphology-affixes-verbs.lexc.md 
+
 Verb inflection
 Prefixes
 
@@ -250,6 +275,8 @@ aiatapanhika
 
 ---
 
+# src-fst-morphology-phonology.twolc.md 
+
 =================================== !
 # The Apurinã morphophonological/twolc rules file 
 =================================== !
@@ -325,6 +352,8 @@ Rule: **nasalization with -Ntxi y:ĩ**
 
 ---
 
+# src-fst-morphology-root.lexc.md 
+
 
 INTRODUCTION TO MORPHOLOGICAL ANALYSER OF Apurinã LANGUAGE.
 
@@ -486,6 +515,8 @@ word classes, or optionally from prefixes:
 
 ---
 
+# src-fst-morphology-stems-adjectives.lexc.md 
+
 Adjectives
 Adjectives in the Apurinã language describe things.
 
@@ -495,6 +526,8 @@ Adjectives in the Apurinã language describe things.
 
 ---
 
+# src-fst-morphology-stems-adverbs.lexc.md 
+
 Adverbs
 Adverbs in the APURINÃ language describe things.
 
@@ -504,6 +537,8 @@ Adverbs in the APURINÃ language describe things.
 
 ---
 
+# src-fst-morphology-stems-exceptions.lexc.md 
+
 Exceptions are quite strange word-forms. the ones that do not fit anywhere 
 else. This file contains all enumerated word forms that cannot reasonably be
 created from lexical data by regular inflection. Usually there should be next
@@ -517,6 +552,8 @@ compounding scheme or possibly many end applications.
 
 ---
 
+# src-fst-morphology-stems-nouns.lexc.md 
+
 Nouns
 Nouns in the Apurinã language are things.
 
@@ -528,6 +565,8 @@ These need further classification 2020-05-10
 
 ---
 
+# src-fst-morphology-stems-numerals.lexc.md 
+
 Numerals
 Numerals in the Apurinã language are numbers.
 
@@ -537,6 +576,8 @@ Numerals in the Apurinã language are numbers.
 
 ---
 
+# src-fst-morphology-stems-pronouns.lexc.md 
+
 Pronouns
 Pronouns in the Apurinã language are references to things.
 
@@ -546,6 +587,8 @@ Pronouns in the Apurinã language are references to things.
 
 ---
 
+# src-fst-morphology-stems-propernouns.lexc.md 
+
 Proper nouns
 Proper nouns in the Apurinã language are People and places.
 
@@ -555,6 +598,8 @@ Proper nouns in the Apurinã language are People and places.
 
 ---
 
+# src-fst-morphology-stems-verbs.lexc.md 
+
 Verbs
 Verbs in APURINÃ language are actions.
 
@@ -566,6 +611,8 @@ More test verbs 2020-05-10
 
 ---
 
+# src-fst-phonetics-txt2ipa.xfscript.md 
+
 
 
 retroflex plosive, voiceless			t`  ʈ	    0288, 648 (` = ASCII 096)
@@ -733,6 +780,8 @@ retracted tongue root			_q
 
 ---
 
+# src-fst-transcriptions-transcriptor-abbrevs2text.lexc.md 
+
 
 
 We describe here how abbreviations are in Apurinã are read out, e.g.
@@ -753,6 +802,8 @@ For example:
 
 ---
 
+# src-fst-transcriptions-transcriptor-numbers-digit2text.lexc.md 
+
 
 
 % komma% :,      Root ;
@@ -767,6 +818,8 @@ For example:
 
 ---
 
+# tools-grammarcheckers-grammarchecker.cg3.md 
+
 
 [ L A N G U A G E ]  G R A M M A R   C H E C K E R
 
@@ -1064,7 +1117,14 @@ expression **WORD - premodifiers**.
 ### Grammarchecker sets
 
 * * *
-<small>This (part of) documentation was generated from [tools/grammarcheckers/grammarchecker.cg3](https://github.com/giellalt/lang-apu/blob/main/tools/grammarcheckers/grammarchecker.cg3)</small># Tokeniser for apu
+
+<small>This (part of) documentation was generated from [tools/grammarcheckers/grammarchecker.cg3](https://github.com/giellalt/lang-apu/blob/main/tools/grammarcheckers/grammarchecker.cg3)</small>
+
+---
+
+# tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.md 
+
+# Tokeniser for apu
 
 Usage:
 ```
@@ -1127,6 +1187,8 @@ Finally we mark as a token any sequence making up a:
 
 ---
 
+# tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.md 
+
 # Grammar checker tokenisation for apu
 
 Requires a recent version of HFST (3.10.0 / git revision>=3aecdbc)
@@ -1190,6 +1252,8 @@ Finally we mark as a token any sequence making up a:
 
 ---
 
+# tools-tokenisers-tokeniser-tts-cggt-desc.pmscript.md 
+
 # TTS tokenisation for smj
 
 Requires a recent version of HFST (3.10.0 / git revision>=3aecdbc)
@@ -1251,6 +1315,3 @@ Needs hfst-tokenise to output things differently depending on the tag they get
 * * *
 
 <small>This (part of) documentation was generated from [tools/tokenisers/tokeniser-tts-cggt-desc.pmscript](https://github.com/giellalt/lang-apu/blob/main/tools/tokenisers/tokeniser-tts-cggt-desc.pmscript)</small>
-
----
-

index.md

@@ -50,7 +50,6 @@ Below is an autogenerated list of documentation pages built from structured comm
 * `tools/`
     * `grammarcheckers/`
         * [grammarchecker.cg3](tools-grammarcheckers-grammarchecker.cg3.html) ([src](https://github.com/giellalt/lang-apu/blob/main/tools/grammarcheckers/grammarchecker.cg3))
-            * `/`
     * `tokenisers/`
         * [tokeniser-disamb-gt-desc.pmscript](tools-tokenisers-tokeniser-disamb-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-apu/blob/main/tools/tokenisers/tokeniser-disamb-gt-desc.pmscript))
         * [tokeniser-gramcheck-gt-desc.pmscript](tools-tokenisers-tokeniser-gramcheck-gt-desc.pmscript.html) ([src](https://github.com/giellalt/lang-apu/blob/main/tools/tokenisers/tokeniser-gramcheck-gt-desc.pmscript))

src-cg3-functions.cg3.md

@@ -166,4 +166,5 @@ These were the set types.
 ## HNOUN MAPPING
 
 * * *
-<small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-apu/blob/main/src/cg3/functions.cg3)</small>
+
+<small>This (part of) documentation was generated from [src/cg3/functions.cg3](https://github.com/giellalt/lang-apu/blob/main/src/cg3/functions.cg3)</small>

src-fst-morphology-affixes-adjectives.lexc.md

@@ -4,6 +4,3 @@ The Apurinã language adjectives compare.
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/adjectives.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/adjectives.lexc)</small>
-
----
-

src-fst-morphology-affixes-adverbs.lexc.md

@@ -4,6 +4,3 @@ The APURINÃ language adverbs compare.
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/adverbs.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/adverbs.lexc)</small>
-
----
-

src-fst-morphology-affixes-nouns.lexc.md

@@ -6,6 +6,3 @@ Suffixes
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/nouns.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/nouns.lexc)</small>
-
----
-

src-fst-morphology-affixes-prefixes.lexc.md

@@ -4,6 +4,3 @@ Prefixes in the Apurinã language are bound to beginning of other words.
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/prefixes.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/prefixes.lexc)</small>
-
----
-

src-fst-morphology-affixes-pronouns.lexc.md

@@ -4,6 +4,3 @@ The APURINÃ language nouns inflect in cases.
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/pronouns.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/pronouns.lexc)</small>
-
----
-

src-fst-morphology-affixes-propernouns.lexc.md

@@ -5,6 +5,3 @@ nouns, but with a colon (':') as separator.
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/propernouns.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/propernouns.lexc)</small>
-
----
-

src-fst-morphology-affixes-symbols.lexc.md

@@ -4,6 +4,3 @@
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/symbols.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/symbols.lexc)</small>
-
----
-

src-fst-morphology-affixes-verbs.lexc.md

@@ -9,6 +9,3 @@ aiatapanhika
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/affixes/verbs.lexc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/affixes/verbs.lexc)</small>
-
----
-

src-fst-morphology-phonology.twolc.md

@@ -70,6 +70,3 @@ Rule: **nasalization with -Ntxi y:ĩ**
 * * *
 
 <small>This (part of) documentation was generated from [src/fst/morphology/phonology.twolc](https://github.com/giellalt/lang-apu/blob/main/src/fst/morphology/phonology.twolc)</small>
-
----
-