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

[Pavel Kharitonov]

CVSROOT:        /sources/trans-coord
Module name:    trans-coord
Changes by:     Pavel Kharitonov <ineiev>       12/12/16 12:50:05

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

Log message:
        (Files and Directories): Add a short description of files.
        (New Translation): Add `GNUN Slots' anchor.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/trans-coord/gnun/server/gnun/ChangeLog?cvsroot=trans-coord&r1=1.319&r2=1.320
http://cvs.savannah.gnu.org/viewcvs/trans-coord/gnun/server/gnun/doc/gnun.texi?cvsroot=trans-coord&r1=1.71&r2=1.72

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/trans-coord/trans-coord/gnun/server/gnun/ChangeLog,v
retrieving revision 1.319
retrieving revision 1.320
diff -u -b -r1.319 -r1.320
--- ChangeLog   16 Dec 2012 09:29:44 -0000      1.319
+++ ChangeLog   16 Dec 2012 12:50:04 -0000      1.320
@@ -4,6 +4,9 @@
        not compared when the `www' translation was fuzzy.
        * po-msg-diff.in: Fix representation of space-only
        translations.
+       * gnun.texi (Files and Directories): Add a short description
+       of files.
+       (New Translation): Add `GNUN Slots' anchor.
 
 2012-12-14  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.71
retrieving revision 1.72
diff -u -b -r1.71 -r1.72
--- doc/gnun.texi       14 Dec 2012 17:56:37 -0000      1.71
+++ doc/gnun.texi       16 Dec 2012 12:50:05 -0000      1.72
@@ -1106,6 +1106,7 @@
 @table @samp
 @cindex notes, translators
 @cindex translators' notes
address@hidden Slots}
 @item *GNUN-SLOT: TRANSLATOR'S NOTES*
 This is for translator's notes that are injected in the resulting
 translation.  @xref{Notes Slot}, for more information.  If your
@@ -2117,15 +2118,15 @@
 @node Files and Directories
 @section Files and Directories 
 
address@hidden FIXME: More detailed description is desirable.
-
-This is a brief diagram of @dfn{www} working copy.
+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
+old HTML-only translations.
 
 @example
 @group
-Root
+Root/
   |
-  +--gnu
+  +--gnu/
   |   |
   |   |
   |   +--linux-and-gnu.html #
@@ -2134,13 +2135,13 @@
   |   address@hidden @@
   |   address@hidden
   |   |
-  |   +--------------------------po
+  |   +--------------------------po/
   |                               |
   +--home.html #                  address@hidden %
   address@hidden @@             +--manifesto.pot @@
   +--planetfeeds.html #/@@         +--manifesto.proto * @@
   address@hidden @@      +--manifesto.translist @@
-  +--po                           address@hidden * @@
+  +--po/                          address@hidden * @@
   |  |                            address@hidden @@
   |  +--home.pot @@                address@hidden @@
   |  +--home.proto * @@            address@hidden %
@@ -2154,20 +2155,20 @@
   |  address@hidden %
   |  address@hidden
   |
-  +--server
+  +--server/
   |  |
-  |  +-------------------------gnun
+  |  +-------------------------gnun/
   |  |                           |
   |  +--sitemap.html #/@@         +--GNUmakefile * #
   |  address@hidden @@      +--config.mk * #
-  |  +--po                       +--gnun.mk #
-  |  |  |                        +--language.txt #
+  |  +--po/                      +--gnun.mk #
+  |  |  |                        +--languages.txt #
   |  |  +--sitemap.pot @@         address@hidden #
-  |  |  +--sitemap.proto * @@     +--compendia
+  |  |  +--sitemap.proto * @@     +--compendia/
   |  |  address@hidden %          |
   |  |  address@hidden @@          address@hidden #
   |  |  +--body-include-2.pot @@       address@hidden @@
-  |  |  +--body-include-2.proto * @@
+  |  |  +--body-include-2.proto * @@   +--excluded.pot #
   |  |  address@hidden %
   |  |  address@hidden
   |  |  
@@ -2185,6 +2186,82 @@
 @end group
 @end example
 
+A description of some files follows.
+
address@hidden @file
address@hidden @dots{}/@var{file}.html
+The English files.
+
address@hidden @dots{}/@address@hidden
+The @var{lang} translation of @address@hidden/@var{file}.html}.
+
address@hidden @dots{}/po/@var{file}.proto
+Intermediate files generated from @address@hidden and used
+internally.  Essentially, GNUN inserts its special slots and
+instructions to include the @address@hidden file
+(@pxref{GNUN Slots}, and @ref{generic.LANG.html}).
+
address@hidden @dots{}/po/@var{file}.translist
+The list of trasnlations for @address@hidden/@var{file}.html}.  It is
+included in @address@hidden/@var{file}.html} all its translations.
+
address@hidden @dots{}/po/@var{file}.pot
+PO templates for articles and included files.
+
address@hidden @dots{}/po/@var{file}.pot.opt
+POTs of optional templates (currently, @file{planetfeeds.pot.opt}).
address@hidden, for more details.
+
address@hidden @dots{}/po/@address@hidden
+Translations of @address@hidden or @address@hidden
+committed by the translators and merged by GNUN.
+
address@hidden @dots{}/po/@address@hidden
+Intermediate files from which @address@hidden@var{lang}.html} are
+generated.
+
address@hidden @dots{}/po/@address@hidden
+The latest revision of the English file for which a full translation
+into @var{lang} language was provided.
+
address@hidden @dots{}/po/@address@hidden
+The highlighted differences between the current version of
address@hidden@address@hidden and
address@hidden@dots{}/po/@address@hidden
+
address@hidden planetfeeds.html
+A list of news; it is automatically generated outside of GNUN.
+For GNUN, it is an optional template.
+
address@hidden server/
+Most template SSI files are located in this directory.
+
address@hidden server/sitemap.html
+The sitemap; it is generated automatically by a script that is not
+included in GNUN.  GNUN currently treats it like a regular article.
+
address@hidden server/gnun/
+The directory for GNUN files.
+
address@hidden server/gnun/GNUmakefile
address@hidden server/gnun/config.mk
+These files are maintained locally.  They are used to rebuild the
+translations.  @xref{Invoking GNUN}.
+
address@hidden server/gnun/gnun.mk
+The file that defines the list of files to build.  @xref{Main
+Variables}.
+
address@hidden server/gnun/languages.txt
address@hidden
+
address@hidden server/gnun/address@hidden
address@hidden
+
address@hidden server/gnun/compendia
+The directory for compendia.  @xref{Compendia}.
address@hidden table
+
 @node Scripts
 @section GNUN Scripts