m4-patches
[Top][All Lists]
Advanced

[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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]