bug-texinfo
[Top][All Lists]
Advanced

[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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]