Convert docs/ to Makefile.am, add gettext.txt

Add gettext.txt, which explains the structure of po/ with the GNU
gettext template system.

3 files changed, 88 insertions, 33 deletions

diff --git a/docs/Makefile b/docs/Makefile
deleted file mode 100644
index 93add106c..000000000
--- a/docs/Makefile
+++ /dev/null
@@ -1,33 +0,0 @@
-#
-# Makefile
-#
-# Copyright (C) 2007  Red Hat, Inc.  All rights reserved.
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-all: command-line.txt kickstart-docs.txt
-
-command-line.txt:
-	curl -A "anaconda-build" -o command-line.txt "http://fedoraproject.org/w/index.php?title=Anaconda_Boot_Options&action=raw"
-
-kickstart-docs.txt:
-	curl -A "anaconda-build" -o kickstart-docs.txt "http://fedoraproject.org/w/index.php?title=Anaconda/Kickstart&action=raw"
-
-clean:
-	rm -rf kickstart-docs.txt command-line.txt api *.xml
-
-depend:
-
-install:
diff --git a/docs/Makefile.am b/docs/Makefile.am
new file mode 100644
index 000000000..14ba2f38e
--- /dev/null
+++ b/docs/Makefile.am
@@ -0,0 +1,32 @@
+# docs/Makefile.am for anaconda
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation; either version 2.1 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# Author: David Cantrell <dcantrell@redhat.com>
+
+EXTRA_DIST = install-methods.txt mediacheck.txt anaconda-release-notes.txt \
+             lvm_sanity_checks.txt rescue-mode api.cfg making-screenshots \
+             threads.txt command-line.txt kickstart-docs.txt gettext.txt
+
+CLEANFILES = api *.xml
+
+MAINTAINERCLEANFILES = Makefile.in command-line.txt kickstart-docs.txt
+
+command-line.txt:
+	curl -A "anaconda-build" -o command-line.txt "http://fedoraproject.org/w/index.php?title=Anaconda_Boot_Options&action=raw"
+
+kickstart-docs.txt:
+	curl -A "anaconda-build" -o kickstart-docs.txt "http://fedoraproject.org/w/index.php?title=Anaconda/Kickstart&action=raw"
diff --git a/docs/gettext.txt b/docs/gettext.txt
new file mode 100644
index 000000000..1bef9e486
--- /dev/null
+++ b/docs/gettext.txt
@@ -0,0 +1,56 @@
+gettext, i18n, and the po/ subdirectory
+05-Jun-2009
+David Cantrell <dcantrell@redhat.com>
+---------------------------------------
+
+I have attempted to clean up our po/ subdirectory and bring it in to
+conformance with GNU gettext tools as well as hook it in to GNU autoconf and
+GNU automake.  The gettext software has templates set up for this already,
+so I'm just using those.
+
+From time to time, we may have to update our gettext template files and or
+expand or reduce the information in the files.  How do you know what files
+do what?  Here's an explanation:
+
+m4/gettext.m4
+m4/iconv.m4
+m4/lib-ld.m4
+m4/lib-link.m4
+m4/lib-prefix.m4
+m4/nls.m4
+m4/po.m4
+m4/progtest.m4
+po/Makefile.in.in
+po/Rules-quot
+po/boldquot.sed
+po/en@boldquot.header
+po/en@quot.header
+po/insert-header.sin
+po/quot.sed
+po/remove-potcdate.sin
+
+    These files are copied in when 'gettextize' is run on the source
+    project.  When we need to update to a newer minimum version of
+    gettext, these files will be replaced.  In general, we should never
+    need to touch these files.
+
+po/Makevars
+
+    Should be updated when we update gettext files with a new gettextize
+    run.  A file called po/Makevars.template will appear and we can move
+    over our values to the new file and commit it.  We do not need to
+    change this file on a regular basis.
+
+po/POTFILES.in
+
+    This file contains a listing of all source files in the project that
+    have translatable strings.
+
+po/LINGUAS
+
+    Space-delimited list of languages available.  If a new language is
+    added, it should be added to this file.
+
+po/*.po
+
+    Actual translated strings, as maintained by the translation team(s).