[Po4a-Devel] Suggestions for improvement of po4a documentatioon

Hello po4a developers, while updating the po4a translation I noticed the following potential improvements: po4a:122 ======== Current: "The provided directory must contain a set of PO files, each named F<XX.po> " "with C<XX> the ISO 639-1 of the language used in this file. The directory " Suggested improvement: "The provided directory must contain a set of PO files, each named F<XX.po> " "with C<XX> the ISO 639-1 code of the language used in this file (two or more letters). The directory " Rationale: e.g. pt_BR, or sr_Cyrl, or zh_CHS, or zh_Hant doc/po4a.7.pod:79 ================= Current: "Then, the I<manual editing> reported depicts the action of the translators, " "that modify the PO files to provide translations to every original string " "and paragraph. " Suggested improvement: "Then, the I<manual editing> block depicts the action of the translators, " "that modify the PO files to provide translations to every original string " "and paragraph. " Rationale: The paragraph is referring to the graphics which contains various blocks with actions. Also in "manual editing" nothing is reported. doc/po4a.7.pod:109 ================== Current: "You can also set the insertion I<mode> to the value C<before>, with a " "similar semantic: combining C<mode=before> with an C<endboundary> will put " "the addendum just B<after> the matched boundary, that the last potential " "boundary line before the C<position>. Combining C<mode=before> with an " "C<beginboundary> will put the addendum just B<before> the matched boundary, " "that the last potential boundary line before the C<position>." Suggested improvement: "You can also set the insertion I<mode> to the value C<before>, with a " "similar semantic: combining C<mode=before> with an C<endboundary> will put " "the addendum just B<after> the matched boundary, that is the last potential " ~~ "boundary line before the C<position>. Combining C<mode=before> with an " "C<beginboundary> will put the addendum just B<before> the matched boundary, " "that is the last potential boundary line before the C<position>." ~~ Rationale: Missing verb in the clause after the comma started with "that". Alternatively (if the meaning remains the same?) In both cases the word "that" could be deleted. Greetings Helge -- Dr. Helge Kreutzmann debian(a)helgefjell.de Dipl.-Phys. http://www.helgefjell.de/debian.php 64bit GNU powered gpg signed mail preferred Help keep free software "libre": http://www.ffii.de/