From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: tramp.texi Date: Sat, 14 Jun 2003 22:49:10 -0500 (CDT) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200306150349.h5F3nAl07357@eel.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1055648907 32635 80.91.224.249 (15 Jun 2003 03:48:27 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sun, 15 Jun 2003 03:48:27 +0000 (UTC) Cc: karl@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Jun 15 05:48:23 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19ROVD-0008Ty-00 for ; Sun, 15 Jun 2003 05:48:23 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 19ROrx-0000oJ-00 for ; Sun, 15 Jun 2003 06:11:54 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.20) id 19ROWv-00014i-Lj for emacs-devel@quimby.gnus.org; Sat, 14 Jun 2003 23:50:09 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19ROVq-00087n-Tb for emacs-devel@gnu.org; Sat, 14 Jun 2003 23:49:02 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19ROVm-0007wZ-A7 for emacs-devel@gnu.org; Sat, 14 Jun 2003 23:48:59 -0400 Original-Received: from manatee.dms.auburn.edu ([131.204.53.104]) by monty-python.gnu.org with esmtp (Exim 4.20) id 19ROVl-0007uY-QG; Sat, 14 Jun 2003 23:48:57 -0400 Original-Received: from eel.dms.auburn.edu (eel.dms.auburn.edu [131.204.53.108]) h5F3mtoc026183; Sat, 14 Jun 2003 22:48:56 -0500 (CDT) Original-Received: (from teirllm@localhost) by eel.dms.auburn.edu (8.11.6+Sun/8.11.6) id h5F3nAl07357; Sat, 14 Jun 2003 22:49:10 -0500 (CDT) X-Authentication-Warning: eel.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:15100 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:15100 I do not know whether the following concerns bugs in tramp.texi, in Emacs, or in makeinfo, although I believe the two latter. Anyway, Kai reads Emacs devel and I included a CC to Karl. I reported on this problem before, but I do not believe it has been fixed. What is new is that I now know how to deal at least with the symptoms. Description of the symptom: In standalone Info (info (GNU texinfo) 4.5) do m tramp: Result: Cannot find node `Top'. In Emacs we do C-h i m tramp No problem here. But now we do: m Overview Result: byte-code: No such anchor in tag table or node in tag table or file: Overview Now what is going on? Tramp contains: @c Entries for @command{install-info} to use @dircategory Emacs @direntry * TRAMP: (tramp). Transparent Remote Access, Multiple Protocol Emacs remote file access via rsh and rcp. @end direntry Perfectly correct, but apparently appears too soon. If we kill that code and paste it later, just in front of: @tex @titlepage @title @tramp{} version @trampver{} User Manual then both the standalone and Emacs Info are suddenly perfectly happy with tramp.texi At first view, it seems that this was a bug in tramp.texi and we fixed it. I do not believe so, although making that small change will indeed make the Tramp documentation work perfectly. I believe that there is no bug in tramp.texi at all, but a bug in makeinfo (or in its documentation) and a bug in texinfo-mode in Emacs. First of all the main bug: >>From (texinfo)Installing Dir Entries: Always use the `@direntry' and `@dircategory' commands near the beginning of the Texinfo input, before the first `@node' command. If you use them later on in the input, `install-info' will not notice them. This warns about putting it too _late_, but tramp.texi took this warning a little bit too seriously and put it too _early_. But the documentation does not mention anything about too _early_. This is either a bug in makeinfo or a bug in the documentation. One can not blame authors for taking what they are told seriously. (I am not the author by the way.) While actually trying to solve the problem I ran into some auxiliary problems, which I believe are a bug in Emacs' texinfo-mode. What I did in Emacs was, I copied the file tramp.texi to ~/info and ran C-u C-s C-u m on it. Then I did C-x C-s and C-c C-m C-b. Result: /home/teirllm/info/tramp.texi:133: Reached eof before matching @end ifset. /home/teirllm/info/tramp.texi:126: No matching `@end menu'. /home/teirllm/info/tramp.texi:80: Next reference to nonexistent node `Overview'. /home/teirllm/info/tramp.texi:132: Menu reference to nonexistent node `History'. /home/teirllm/info/tramp.texi:131: Menu reference to nonexistent node `Obtaining @sc{tramp}'. /home/teirllm/info/tramp.texi:127: Menu reference to nonexistent node `Overview'. makeinfo: Removing output file `../info/tramp' due to errors; use --force to preserve. Compilation exited abnormally with code 2 at Sat Jun 14 21:10:04 This occurs with or without prior application of the "fix" described above. The problem is that before C-u C-s C-u m, the @end if and @end menu were there, but C-u C-s C-u m erased them. I believe that this is a bug in Emacs' texinfo-mode. Indeed M-! makeinfo --fill-column=70 worked perfectly (after switching the above code around, as described). Sincerely, Luc.