mirror of
https://https.git.savannah.gnu.org/git/gnulib.git
synced 2026-04-28 06:33:36 +00:00
67 lines
2.2 KiB
Plaintext
67 lines
2.2 KiB
Plaintext
Misc notes
|
|
----------
|
|
|
|
regexprops-generic.texi is generated via a utility in findutils.
|
|
|
|
How to update gnulib manual on www.gnu.org
|
|
------------------------------------------
|
|
|
|
1) You need a non-anonymous checkout of the web pages directory.
|
|
|
|
$ cvs -d :ext:jas@cvs.savannah.gnu.org:/web/gnulib \
|
|
checkout gnulib
|
|
|
|
2) Get familiar with the instructions for web page maintainers.
|
|
https://www.gnu.org/server/standards/gnu-website-guidelines.html
|
|
especially the note about symlinks.
|
|
Some of this page may also be relevant:
|
|
https://www.gnu.org/server/standards/README.webmastering.html
|
|
|
|
3) Assuming GNULIB_CHECKOUT refers to a checkout of the gnulib dir,
|
|
and GNULIB_WWW_CHECKOUT refers to the other directory created above (1),
|
|
do
|
|
|
|
GNULIB_WWW_CHECKOUT=`cd $GNULIB_WWW_CHECKOUT && pwd`
|
|
cd $GNULIB_WWW_CHECKOUT
|
|
cvs update -dP
|
|
tar -cf html-CVS.tar manual/html_node/CVS manual/html_node/.symlinks
|
|
cd $GNULIB_CHECKOUT
|
|
git checkout master
|
|
git pull
|
|
cd doc
|
|
make undocumented-modules.texi updated-stamp
|
|
../build-aux/gendocs.sh \
|
|
-I ../build-aux \
|
|
--email bug-gnulib@gnu.org \
|
|
-o "$GNULIB_WWW_CHECKOUT/manual" \
|
|
gnulib "The GNU Portability Library"
|
|
cd $GNULIB_WWW_CHECKOUT
|
|
tar -xf html-CVS.tar
|
|
rm html-CVS.tar
|
|
newfiles=`cvs -n update -dP | sed -n -e 's|^[?] manual/html_node/|manual/html_node/|p'`
|
|
if test -n "$newfiles"; then
|
|
cvs add $newfiles
|
|
fi
|
|
|
|
Run 'cvs diff -u' and verify that the output looks sane.
|
|
|
|
4) Commit the modified and the new files.
|
|
|
|
5) Find the files which have not been overwritten (because they belonged
|
|
to sections that have been removed or renamed):
|
|
|
|
$ cd manual/html_node
|
|
$ ls -lt
|
|
|
|
Remove these files and commit their removal to CVS.
|
|
For each of these files, add a line to the file .symlinks. This will
|
|
ensure that hyperlinks to the removed files will redirect to the entire
|
|
manual; this is better than a 404 error.
|
|
|
|
There is a problem with 'index.html' being written twice (once for POSIX
|
|
function 'index', once for the table of contents); you can ignore this issue.
|
|
|
|
Note: For updating the www.gnu.org pages of *other* GNU packages, package
|
|
specific scripts can be used, or build-aux/gnu-web-doc-update may possibly
|
|
work.
|