unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#2975: `texinfo-master-menu' doesn't work.
@ 2009-04-12 21:33 Alan Mackenzie
  2011-12-10 12:40 ` Eli Zaretskii
       [not found] ` <837h24mwfs.fsf@gnu.org>
  0 siblings, 2 replies; 24+ messages in thread
From: Alan Mackenzie @ 2009-04-12 21:33 UTC (permalink / raw)
  To: bug-texinfo, bug-gnu-emacs

In Emacs, either 22.3 or a recent CVS version ...
emacs -Q

1.

(i) C-c C-f .../path/to/emacs/doc/misc/cc-mode.texi
(ii) M-g M-g 238          ; the second line of the menu,
                          ; contents "* Overview::"
(ii) C-k C-k              ; Kill this line

(v) Now do C-c C-u m.  This flashes the screen and reports
"Done...completed making master menu.  You may save the buffer.".
However, it hasn't made the master menu - the "* Overview::" line is
still missing.

########################################################################

2.

(i) Kill (remove) the entire master menu from the buffer (between the
  lines "@menu" and "@end menu").
  
(ii) Try to regenerate the master menu with C-c C-u m.  This signals the
puzzling error "Buffer lacks ordinary `Top' menu in which to insert
master".  It is not clear what a "`Top' menu" is, in what respect it is
"ordinary", and in what regard the new master menu is inserted into it.
The existing master menu was not contained within any menu.

#########################################################################

3.

(i) C-c C-f .../path/to/emacs/doc/lispref/elisp.texi
(ii) M-g M-g 108       ; the second line of the menu,
                       ; "* Lisp Data Types:: ...."
(iii) C-k C-k          ; Kill this line

(iv) Now do C-c C-u m.  This doesn't regenerate the master menu.
Instead, it deletes the @detailmenu without restoring the "* Lisp Data
Types::" line.

#########################################################################

Comments:

Neither the doc string for `texinfo-master-menu' nor the texinfo manual
(page "Updating Nodes and Menus") describe other than vaguely what this
command is supposed to do.

The doc string states, accurately, that

    The function removes the detailed part of an already existing master
    menu.

, which though accurate, is puzzling in the extreme; what one wants from
this command is for the detailed bit to be inserted, not deleted.

There is no verb in "texinfo master menu", so one is led by intelligent
guessing to believe that the command does whatever necessary to insert
or update the master menu.  This doesn't happen.

-- 
Alan Mackenzie (Nuremberg, Germany).







^ permalink raw reply	[flat|nested] 24+ messages in thread
[parent not found: <20191.12232.556454.551166@gargle.gargle.HOWL>]

end of thread, other threads:[~2011-12-12 13:02 UTC | newest]

Thread overview: 24+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-04-12 21:33 bug#2975: `texinfo-master-menu' doesn't work Alan Mackenzie
2011-12-10 12:40 ` Eli Zaretskii
     [not found] ` <837h24mwfs.fsf@gnu.org>
     [not found]   ` <20111211173859.GA2755@acm.acm>
2011-12-11 18:18     ` Eli Zaretskii
2011-12-12 12:25       ` Alan Mackenzie
2011-12-12 13:02         ` Eli Zaretskii
     [not found] <20191.12232.556454.551166@gargle.gargle.HOWL>
     [not found] ` <E1RYHPD-0000vm-PC@fencepost.gnu.org>
     [not found]   ` <h87h28tgcg.fsf@fencepost.gnu.org>
     [not found]     ` <20191.48632.665251.448872@gargle.gargle.HOWL>
2011-12-07 20:43       ` bug#2975: texinfo-master-menu and emacs.texi Stefan Monnier
2011-12-07 21:19         ` Roland Winkler
2011-12-08  6:17           ` Eli Zaretskii
2011-12-08 10:38             ` Štěpán Němec
2011-12-08 12:20               ` Eli Zaretskii
2011-12-08 14:46                 ` Stefan Monnier
2011-12-10 11:00                   ` Eli Zaretskii
2011-12-08 18:52                 ` Roland Winkler
2011-12-08 18:55                   ` Roland Winkler
2011-12-08 19:06                   ` Štěpán Němec
2011-12-08 19:37                     ` Eli Zaretskii
2011-12-08 19:59                       ` Štěpán Němec
2011-12-08 20:54                         ` Roland Winkler
2011-12-09  7:28                           ` Eli Zaretskii
2011-12-09  7:48                             ` Roland Winkler
2011-12-10  0:17                           ` Karl Berry
2011-12-10 10:57                             ` Eli Zaretskii
2011-12-09  7:30                         ` Eli Zaretskii
2011-12-08 19:33                   ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).