[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
opinions on node description new command syntax variations?
From: |
Patrice Dumas |
Subject: |
opinions on node description new command syntax variations? |
Date: |
Mon, 24 Jul 2023 18:57:10 +0200 |
Hello,
We are implementing @nodedescription, as proposed in this thread:
https://lists.gnu.org/archive/html/bug-texinfo/2023-02/msg00042.html
The idea is to have a semantic way to associate a node to a description,
which can be used in menu descriptions, but could also be used in otheer
contextes, for example to format a 'see also' segment based on a list of
nodes to see also within a node.
The syntax of @nodedescription can be a line command, like
@node My node
@nodedescription this is a node description
But if the description is relatively long, the line will be long too, it
could also be possible to use a brace command, much like @shortcaption,
@node My node
@nodedescription{The description of the node can be more than one line
and still look good in menu}
Any preference?
Some other question, would there be a need for some longer descriptions
for other uses than menu entries descriptions?
Do you have a use for nodes with description in mind?
--
Pat
- opinions on node description new command syntax variations?,
Patrice Dumas <=