From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel,gmane.emacs.pretest.bugs Subject: Re: elisp documentation links to emacs doc Date: Sat, 12 Jan 2008 11:50:39 +0000 Message-ID: <20080112115039.GD2581@muc.de> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1200138175 16213 80.91.229.12 (12 Jan 2008 11:42:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 12 Jan 2008 11:42:55 +0000 (UTC) Cc: emacs-pretest-bug@gnu.org To: xah lee Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jan 12 12:43:13 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JDelS-0004FE-8r for ged-emacs-devel@m.gmane.org; Sat, 12 Jan 2008 12:43:02 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JDel4-0001eq-C1 for ged-emacs-devel@m.gmane.org; Sat, 12 Jan 2008 06:42:38 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JDel0-0001e8-Ih for emacs-devel@gnu.org; Sat, 12 Jan 2008 06:42:34 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JDeky-0001b0-9y for emacs-devel@gnu.org; Sat, 12 Jan 2008 06:42:33 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JDeky-0001aq-6c for emacs-devel@gnu.org; Sat, 12 Jan 2008 06:42:32 -0500 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JDekx-0008VP-U6 for emacs-devel@gnu.org; Sat, 12 Jan 2008 06:42:32 -0500 Original-Received: from mx10.gnu.org ([199.232.76.166]) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1JDekx-0002bs-Fm for emacs-pretest-bug@gnu.org; Sat, 12 Jan 2008 06:42:31 -0500 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1JDekt-0008U1-NL for emacs-pretest-bug@gnu.org; Sat, 12 Jan 2008 06:42:30 -0500 Original-Received: from colin.muc.de ([193.149.48.1] helo=mail.muc.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JDekt-0008FV-5f for emacs-pretest-bug@gnu.org; Sat, 12 Jan 2008 06:42:27 -0500 Original-Received: (qmail 97195 invoked by uid 3782); 12 Jan 2008 11:40:52 -0000 Original-Received: from acm.muc.de (p57AF647C.dip.t-dialin.net [87.175.100.124]) by colin2.muc.de (tmda-ofmipd) with ESMTP; Sat, 12 Jan 2008 12:40:51 +0100 Original-Received: (qmail 4337 invoked by uid 1000); 12 Jan 2008 11:50:39 -0000 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) X-Primary-Address: acm@muc.de X-detected-kernel: by monty-python.gnu.org: FreeBSD 4.6-4.9 X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:86780 gmane.emacs.pretest.bugs:20601 Archived-At: Hi, Xah! On Fri, Jan 11, 2008 at 07:06:25PM -0800, xah lee wrote: > In the official HTML version of the elisp doc, there are many links to > the emacs doc nodes. (i counted, 101 of them.) [ .... ] > My problem is that for those who only install one doc, then the links > are dead. > Are people suppose do always install these 2 docs together? If not, > is there some mechanism, either when writing the doc or generating > the doc, to not result in links to other docs? I had this problem in cc-mode.sourceforge.net: my solution was to fix the html files, redirecting all {links to the non-existent directories ../emacs and ../elisp} to http://www.gnu.org/software/emacs/manual/html_node/e{macs,lisp}/ Here is the script I use, called "2www.gnu.org.sh" - (it also deletes a reference to the non-existent GNU Indent manual). Feel free to adapt it to your needs. ######################################################################### #!/bin/sh # Fix all http links to the Emacs or Elisp manual. # # These are redirected from, e.g., "../emacs" to the existing page at # www.gnu.org. The link to the indent manual is deleted, because there is no # online copy of this. # # This script takes exactly 1 parameter, the directory to run in. # e.g. % 2www.gnu.org.sh ~/cc-mode/html CURDIR=`pwd` cd $1 for f in *.html do mv $f asdf.html sed 's%href="../emacs/%href="http://www.gnu.org/software/emacs/manual/html_node/emacs/%g s%href="../elisp/%href="http://www.gnu.org/software/emacs/manual/html_node/elisp/%g' \ asdf.html > $f done mv Limitations-and-Known-Bugs.html asdf.html sed "s%<[^<>]*>GNU indent ([^()]*)%GNU indent%" \ asdf.html > Limitations-and-Known-Bugs.html rm asdf.html cd $CURDIR ######################################################################### > Thanks. > Xah -- Alan Mackenzie (Nuremberg, Germany)