trans-coord/gnun/server/gnun ChangeLog doc/gnun...

[Pavel Kharitonov]

CVSROOT:        /sources/trans-coord
Module name:    trans-coord
Changes by:     Pavel Kharitonov <ineiev>       14/06/28 05:43:16

Modified files:
        gnun/server/gnun: ChangeLog 
        gnun/server/gnun/doc: gnun.texi 

Log message:
        (Concepts): Fix a typo.
        (report): Add an anchor to `priorities.mk'.
        (Main Variables) <ROOT>: Update.
        (New Translation): Add more details on how to find POTs;
        add more @cindices.
        (Files and Directories): Add `compendium.pot' and `priorities.mk'
        to the diagram; fix indents.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/trans-coord/gnun/server/gnun/ChangeLog?cvsroot=trans-coord&r1=1.418&r2=1.419
http://cvs.savannah.gnu.org/viewcvs/trans-coord/gnun/server/gnun/doc/gnun.texi?cvsroot=trans-coord&r1=1.100&r2=1.101

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/trans-coord/trans-coord/gnun/server/gnun/ChangeLog,v
retrieving revision 1.418
retrieving revision 1.419
diff -u -b -r1.418 -r1.419
--- ChangeLog   27 Jun 2014 16:53:27 -0000      1.418
+++ ChangeLog   28 Jun 2014 05:43:16 -0000      1.419
@@ -2,6 +2,13 @@
 
        * GNUmakefile (mark-outdated): Insert SSI variables
        correctly (broken since 2014-04-28).
+       * doc/gnun.texi (Concepts): Fix a typo.
+       (report): Add an anchor to `priorities.mk'.
+       (Main Variables) <ROOT>: Update.
+       (New Translation): Add more details on how to find POTs;
+       add more @cindices.
+       (Files and Directories): Add `compendium.pot'
+       and `priorities.mk' to the diagram; fix indents.
        * NEWS: Update.
 
 2014-06-27  Pavel Kharitonov  <address@hidden>

Index: doc/gnun.texi
===================================================================
RCS file: /sources/trans-coord/trans-coord/gnun/server/gnun/doc/gnun.texi,v
retrieving revision 1.100
retrieving revision 1.101
diff -u -b -r1.100 -r1.101
--- doc/gnun.texi       27 Jun 2014 16:05:05 -0000      1.100
+++ doc/gnun.texi       28 Jun 2014 05:43:16 -0000      1.101
@@ -190,7 +190,7 @@
 First, GNUN extracts all translatable strings from the original English
 article @address@hidden into
 @address@hidden@footnote{A special group of templates, so
-called optional-templates, have names like
+called optional templates, have names like
 @address@hidden  The PO file for them is still
 @address@hidden@var{lang}.po}.  @xref{optional-templates}.}.  The
 resulting file is suitable for manipulation with the various GNU
@@ -672,6 +672,7 @@
 reasons GNUN is being developed, if you recall.
 
 @cindex priorities.mk
address@hidden
 When present, @file{priorities.mk} defines four classes of articles by
 priority: @var{priority-articles} for the most important translations,
 @var{important-articles} for the second priority level,
@@ -873,10 +874,10 @@
 @cindex articles in root directory, defining
 @cindex defining articles in the root dir
 @item ROOT
-Add here articles that are in the server root, like @file{home.html},
address@hidden and @file{provide.html}.  Always write only the
+Add here articles that are in the server root, like @file{home.html}
+and @file{keepingup.html}.  Always write only the
 basename of the article, i.e. if you add these two articles, the value
-of @code{ROOT} should be @code{keepingup provide}.  This is true for
+of @code{ROOT} should be @code{home keepingup}.  This is true for
 all the variables that expect values in the form of article names.
 
 @cindex ALL_DIRS
@@ -1421,15 +1422,22 @@
 
 @node New Translation
 @section Starting a New Translation
address@hidden starting translation
address@hidden initializing PO files
 @cindex translation, new
 @cindex new translation
 
 To start a new translation, the most simple way is to copy the
-existing POT as @address@hidden, where @var{lang} is your
-language code.  For example, to prepare for a new translation of the
-essay @uref{https://www.gnu.org/philosophy/free-sw.html}, you can
-simply @code{cd philosophy/po; cp free-sw.pot
address@hidden and then edit the latter.  If
+existing POT as @address@hidden@var{lang}.po}, where @var{lang} is your
+language code.  The name of the POT is @address@hidden or,
+when you are translating an optional template, @address@hidden
+(@pxref{optional-templates}).  All these files are situated in the
address@hidden/} subdirectory of the directory containing the HTML file
+of the article.  @xref{Files and Directories}, for more info on GNUN
+directory layout.  For example, to prepare for a new translation
+of the essay @uref{https://www.gnu.org/philosophy/free-sw.html}
+in Manx, you can simply @code{cd philosophy/po; cp free-sw.pot
+free-sw.gv.po} and then edit the latter.  If
 @file{free-sw.pot} does not exist it is because either the article is
 not yet ``templated'' (i.e. migrated to the new style), or the GNUN
 maintainers have not yet added it to the value of the appropriate
@@ -2027,6 +2035,7 @@
 
 @node Files and Directories
 @section Files and Directories 
address@hidden GNUN directory layout
 
 This is a brief diagram of @dfn{www} working copy; note that in this
 section we don't describe the files out of GNUN control, including the
@@ -2077,14 +2086,14 @@
   |  +--sitemap.html #/@@         +--GNUmakefile * #
   |  address@hidden @@      +--config.mk * #
   |  +--po/                      +--gnun.mk #
-  |  |  |                        +--languages.txt #
-  |  |  +--sitemap.pot @@         +--compendia/
-  |  |  +--sitemap.proto * @@     |
-  |  |  address@hidden %          address@hidden #
-  |  |  |                        address@hidden @@
-  |  |  +--body-include-2.pot @@       +--excluded.pot #
-  |  |  +--body-include-2.proto * @@
-  |  |  address@hidden %
+  |  |  |                        +--priorities.mk #
+  |  |  +--sitemap.pot @@         +--languages.txt #
+  |  |  +--sitemap.proto * @@     +--compendia/
+  |  |  address@hidden %          |
+  |  |  |                             address@hidden #
+  |  |  +--body-include-2.pot @@       address@hidden @@
+  |  |  +--body-include-2.proto * @@   +--compendium.pot @@
+  |  |  address@hidden %   +--excluded.pot #
   |  |  address@hidden
   |  |  
   |  +--body-include-2.html #
@@ -2155,6 +2164,10 @@
 The file that defines the list of files to build.  @xref{Main
 Variables}.
 
address@hidden server/gnun/priorities.mk
+This file defines the list of translation priorities.
address@hidden
+
 @item server/gnun/languages.txt
 Canonical names for languages.  @xref{languages.txt}.