Project Info Name.......: gnu-hello
Description: GNU Hello


gnu-hello       
Info
Commit...:d7df82eb28f2eb2e238664dcfe1ccc207b3eb90d
Author...:karl <>
Committer:karl <>
Date.....:Mon Dec 15 01:33:08 2008 +0000
Parents..:73a4e7aaa8294baa32a7ce401fd9825a72da04a4

Message
[project @ 2008-12-15 01:33:08 by karl]
doc updates for wwwdoc sample target

Changes
diff --git a/ChangeLog b/ChangeLog
line changes: +4/-0
index 6d36a64..ef4ec1e
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-12-14  Karl Berry  <karl@gnu.org>
+
+	* Makefile.am (wwwdoc): doc fix.
+
 2008-12-09  Karl Berry  <karl@gnu.org>
 
 	* Version 2.4.

diff --git a/Makefile.am b/Makefile.am
line changes: +19/-4
index c4453b5..a0fa065
--- a/Makefile.am
+++ b/Makefile.am
@@ -32,10 +32,9 @@ SUBDIRS = contrib gnulib/lib po src doc man tests
 # official release is made (and only if you care to provide diffs).
 #
 hello_pre = 2.3
-#
 diff: diffcheck
 	@(echo "To apply these patches, cd to the main directory of the package"; \
-	  echo "and then use \`patch -p1 < hello-XXX.diff'."; \
+	  echo "and then use \`patch -p1 <hello-XXX.diff'."; \
 	  echo "Before building the program, run \`autogen.sh'."; ) > \
 	    $(PACKAGE)-$(hello_pre)-$(VERSION).diff
 	-diff -rc2P --exclude=configure --exclude=config.h.in --exclude=*.info \
@@ -56,10 +55,10 @@ diffcheck:
 	    fi ; \
 	done
 
-# From coreutils.
 # Verify that all source files using _() are listed in po/POTFILES.in.
 # The idea is to run this before making pretests, as well as official
-# releases, so that 
+# releases, so that translators will be sure to have all the messages.
+# (From coreutils.)
 po-check:
 	if test -f po/POTFILES.in; then					\
 	  grep -E -v '^(#|$$)' po/POTFILES.in				\
@@ -81,3 +80,19 @@ po-check:
 	  diff -u $@-1 $@-2 || exit 1;					\
 	  rm -f $@-1 $@-2;						\
 	fi
+
+doctemp = doc/wwwtemp
+gnulib = $(HOME)/gnu/src/gnulib
+gendocs = $(gnulib)/build-aux/gendocs.sh
+gendocs_envvars = GENDOCS_TEMPLATE_DIR=$(gnulib)/doc
+manual = hello
+manual_title = "Hello, GNU World"
+www_target = $(HOME)/gnu/www/hello/manual
+wwwdoc:
+	rm -rf $(doctemp) && mkdir $(doctemp)
+	cd $(doctemp) \
+	&& ln -s ../*.texi . \
+	&& env $(gendocs_envvars) $(gendocs) $(manual) $(manual_title)
+	cp -arf $(doctemp)/manual/. $(www_target)
+	ls -ltu $(www_target)/html_node | tail  # cvs rm -f obsolete files
+# followed by cvs add of new files and cvs commit.

diff --git a/doc/ChangeLog b/doc/ChangeLog
line changes: +4/-0
index 49829f4..2b0682e
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2008-12-14  Karl Berry  <karl@gnu.org>
+
+	* hello.texi (Overview): mention the special targets in Makefile.am.
+
 2008-12-09  Karl Berry  <karl@gnu.org>
 
 	* hello.texi (Invoking hello): mention translation project.

diff --git a/doc/hello.texi b/doc/hello.texi
line changes: +25/-6
index 9b35db9..ab21bc3
--- a/doc/hello.texi
+++ b/doc/hello.texi
@@ -3,6 +3,12 @@
 @setfilename hello.info
 @include version.texi
 @settitle GNU Hello @value{VERSION}
+
+@c Define a new index for options.
+@defcodeindex op
+@c Combine everything into one index (arbitrarily chosen to be the
+@c concept index).
+@syncodeindex op cp
 @c %**end of header
 
 @copying
@@ -25,12 +31,6 @@ Texts.  A copy of the license is included in the section entitled
 @c the standard FSF Front-Cover and Back-Cover Texts, as given in
 @c maintain.texi.
 
-@c Define a new index for options.
-@defcodeindex op
-@c Combine everything into one index (arbitrarily chosen to be the
-@c concept index).
-@syncodeindex op cp
-
 @dircategory Basics
 @direntry
 * Hello: (hello).               Hello, GNU world.
@@ -143,6 +143,25 @@ GNU Hello is implemented in C.  GNU Gettext contains ``hello world''
 examples in a variety of other programming languages; see the Gettext
 home page at @url{http://www.gnu.org/software/gettext/}.  
 
+@cindex @file{Makefile.am} targets
+The top-level @file{Makefile.am} in Hello also contains a few special
+targets for other projects to adapt as desired:
+
+@table @code
+@item diff
+Make a diff from the previous release, assuming the current tarball is
+in the current tarball.
+
+@item po-check
+Verify that all source files using @code{_()} are included for
+translation in @file{po/POTFILES.in}, so translators will have all the
+messages.
+
+@item wwwdoc
+Sample procedure for updating the manual on the GNU web site, in this
+case @url{http://www.gnu.org/software/hello/manual/}.
+@end table
+
 @cindex authors
 @cindex Haertel, Mike
 @cindex MacKenzie, David

diff --git a/doc/version.texi b/doc/version.texi
line changes: +2/-2
index 69ef5c3..908bc34
--- a/doc/version.texi
+++ b/doc/version.texi
@@ -1,4 +1,4 @@
-@set UPDATED 28 November 2008
-@set UPDATED-MONTH November 2008
+@set UPDATED 14 December 2008
+@set UPDATED-MONTH December 2008
 @set EDITION 2.4
 @set VERSION 2.4

This website is licensed under AGPL-3.0. Feel free to copy!