From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.devel Subject: Re: Online Emacs Manuals at gnu.org Date: Sun, 10 Jun 2007 17:11:46 -0400 Message-ID: <87hcpfldkd.fsf@stupidchicken.com> References: <871wgkoe4o.GNU's_Not_Unix!%yavor@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1181509931 21181 80.91.229.12 (10 Jun 2007 21:12:11 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 10 Jun 2007 21:12:11 +0000 (UTC) Cc: karl@gnu.org, yavor@gnu.org To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jun 10 23:12:08 2007 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 1HxUhi-0002XJ-9o for ged-emacs-devel@m.gmane.org; Sun, 10 Jun 2007 23:12:06 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HxUhh-00053i-JL for ged-emacs-devel@m.gmane.org; Sun, 10 Jun 2007 17:12:05 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HxUhd-00051e-QG for emacs-devel@gnu.org; Sun, 10 Jun 2007 17:12:01 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HxUhc-00050g-BL for emacs-devel@gnu.org; Sun, 10 Jun 2007 17:12:01 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HxUhc-00050d-6B for emacs-devel@gnu.org; Sun, 10 Jun 2007 17:12:00 -0400 Original-Received: from cyd.mit.edu ([18.115.2.24]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1HxUha-0006EE-E5; Sun, 10 Jun 2007 17:11:58 -0400 Original-Received: by cyd.mit.edu (Postfix, from userid 1000) id 5AE554E5DA; Sun, 10 Jun 2007 17:11:46 -0400 (EDT) In-Reply-To: <871wgkoe4o.GNU's_Not_Unix!%yavor@gnu.org> (Yavor Doganov's message of "Sun\, 10 Jun 2007 03\:19\:03 +0300") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1.50 (gnu/linux) X-detected-kernel: 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:72590 Archived-At: Yavor Doganov writes: > We received the first bug report after Chong Yidong (I think) > committed the HTML versions of the manuals at gnu.org. Karl Berry > asked me to send this message; please keep him in CC. > > The exact problem that was reported is: > > ,---- > | in /software/emacs/manual/html_node/Gnus.html#Gnus > | there is a link to the Gnus manual i.e: > | /software/emacs/manual/gnus/index.html#Top (link to gnus)[Gnus]. > | ... but the directory "manual/gnus" does not exist :-/ > `---- > > Such things happen because `gendocs.sh' (or `makeinfo' when run > directly) cannot include, for obvious reasons, all the manuals that > are not @include'd from emacs.texi. > > Could you upload all of them, please? (Or alternatively, give green > light for this operation to the GNU Webmasters.) Either way, we have > to do the .symlinks hack to handle the cross-manual xrefs. Sure. I've uploaded added the secondary manuals to manual/html_mono and manual/html_node. In order to get the links to work properly without lots of symlink hacking, I had to move the existing manual files around so that they are where "makeinfo --html" expects. Thus, the "entirely on one webpage" version of the emacs manual is now in manual/html_mono/emacs.html instead of manual/emacs.html, the index page for the Emacs manual has been moved from manual/index.html to manual/emacs.html, and the elisp manual has also been merged into the manual/ tree. I have tried to update the symlinks by editing the .symlink files, but this does not seem to have any effect. Is there anything else I need to do to make them take effect? For instance, we need to make the files in the elisp-manual tree point to the new locations in manual. Also, we should make a new page in manual/index.html that points to the separate manuals on the webpage (Emacs manual, elisp manual, autotype, gnus, etc etc.)