[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: automatic generation of @menu entries
From: |
Patrice Dumas |
Subject: |
Re: automatic generation of @menu entries |
Date: |
Sun, 12 Sep 2021 11:03:54 +0200 |
On Sat, Sep 11, 2021 at 11:20:00PM -0400, Mike Frysinger wrote:
> i couldn't easily find an answer in the archives or manual, so feel free to
> point me to docs or discussions that i missed. surely this can't be a new
> idea that i managed to come up with myself. or there's a good reason that
> i can't see as to why this is a bad idea.
>
> having to manually maintain @menu entries in each @node is pretty tedious,
> especially when @contents & @node are pretty well automated. i grok that
> there will probably be cases where people want to manually curate a menu,
> but why can't we have an automatic default available ?
It is already the case, in the sense that @menu are not needed anymore.
In Info output, menus are automatically generated if they do not exist.
In HTML the new default does not require menus. In addition, there is a
"tree transformation" that can be used to add menus,
'complete_tree_nodes_menus' (and also one to add a master menu
'regenerate_master_menu'). I think that they do what the emacs commands
do, on the tree used internally in texi2any. Tree transformations are
set by setting the TREE_TRANSFORMATIONS customization option, so
something like:
-c 'TREE_TRANSFORMATIONS=complete_tree_nodes_menus,regenerate_master_menu'
--
Pat
- automatic generation of @menu entries, Mike Frysinger, 2021/09/12
- Re: automatic generation of @menu entries, Eli Zaretskii, 2021/09/12
- Re: automatic generation of @menu entries, Mike Frysinger, 2021/09/12
- Re: automatic generation of @menu entries, Eli Zaretskii, 2021/09/12
- Re: automatic generation of @menu entries, Mike Frysinger, 2021/09/12
- Re: automatic generation of @menu entries, Patrice Dumas, 2021/09/13
- Re: automatic generation of @menu entries, Patrice Dumas, 2021/09/13
- Re: automatic generation of @menu entries, Mike Frysinger, 2021/09/15
- Re: automatic generation of @menu entries, Gavin Smith, 2021/09/16
- Re: automatic generation of @menu entries, Gavin Smith, 2021/09/13
Re: automatic generation of @menu entries,
Patrice Dumas <=