[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: documentation error in m4 online help
From: |
Karl Berry |
Subject: |
Re: documentation error in m4 online help |
Date: |
Thu, 25 May 2006 11:51:14 -0500 |
address@hidden
address@hidden, , Syntax of Regular Expressions, emacs, The GNU Emacs
+Manual}.
address@hidden ifnothtml
address@hidden
+See
address@hidden://www.gnu.org/@/software/@/emacs/@/manual/@/emacs.html#Regexps,
+Syntax of Regular Expressions} in the GNU Emacs Manual.
address@hidden ifhtml
BTW, this is certainly more useful html for the users, but the cost of
munging the source with these conditionals seems awfully high.
Another option would be to create an emacs.html symlink in the
www.gnu.org/software/m4/manual directory.
Another option would be to postprocess the html. That's what I do for
the GNU coding standards and maintainer documents. Also ugly, but at
least then the source doesn't have to be changed. For example, for
maintain.html, I do this:
# new-style gendocs.sh
perl -pi -e
's,href="(texinfo|emacs).html,href="/software/\1/manual/\1/\1.html,g'
manual/maintain.html
perl -pi -e
's,href="\.\./(texinfo|emacs)/,href="/software/\1/manual/\1/html_node/,g'
manual/html_node/*.html
#
# new-style gendocs.sh, but special location.
perl -pi -e 's,href="(standards).html,href="/prep/\1/\1.html,g'
manual/maintain.html
perl -pi -e 's,href="\.\./(standards)/,href="/prep/\1/html_node/,g'
manual/html_node/*.html
#
# old-style (and not updated for ages)
perl -pi -e
's,href="(cvs).html,href="/software/\1/manual/html_mono/\1.html,g'
manual/maintain.html
perl -pi -e
's,href="\.\./(cvs)/,href="/software/\1/manual/\1/html_node/,g'
manual/html_node/*.html
#
# old-style, and in the "wrong" directory.
perl -pi -e
's,href="elisp.html,href="/software/emacs/elisp-manual/html_mono/elisp.html,g'
manual/maintain.html
perl -pi -e
's,href="\.\./elisp/,href="/software/emacs/manual/elisp-manual/html_node/,g'
manual/html_node/*.html
For whatever it may be worth ...
Best,
Karl