use heading like sectioning commands with USE_NEXT_HEADING_FOR_LONE_NODE

2025-02-14 Thread Patrice Dumas
Hello, This comes from the thread on anchors, but I start a new thread to avoid mixing the two issues. I propose that, if USE_NEXT_HEADING_FOR_LONE_NODE is set, the @*heading appearing after a @node be treated as much as possible like a sectioning command. This means that * if xrefautomaticsecti

Re: `@anchor` improvement

2025-02-14 Thread pertusus
On Fri, Feb 14, 2025 at 02:05:23PM +, Werner LEMBERG wrote: > Well, I think that your `@anchorlabel` suggestion is the way to go. > Actually, I would prefer a shorter name, say, `@label`. Then you can > demote > > ``` > @node Foo > @subsection Foo doodle doo > ``` > > to > > ``` > @label Fo

Re: `@anchor` improvement

2025-02-14 Thread pertusus
On Fri, Feb 14, 2025 at 02:59:45PM +, Werner LEMBERG wrote: > >> Well, I think that your `@anchorlabel` suggestion is the way to go. > >> Actually, I would prefer a shorter name, say, `@label`. Then you > >> can demote > >> > >> ``` > >> @node Foo > >> @subsection Foo doodle doo > >> ``` > >>

Re: `@anchor` improvement

2025-02-14 Thread Werner LEMBERG
>> Well, I think that your `@anchorlabel` suggestion is the way to go. >> Actually, I would prefer a shorter name, say, `@label`. Then you >> can demote >> >> ``` >> @node Foo >> @subsection Foo doodle doo >> ``` >> >> to >> >> ``` >> @label Foo >> @subsubheading Foo doodle doo >> ``` > > I st

Re: `@anchor` improvement

2025-02-14 Thread pertusus
On Fri, Feb 14, 2025 at 02:05:23PM +, Werner LEMBERG wrote: > >> > But do you really want to get the old sectioning name back for > >> > printed output? > >> > >> Yes, because using `@anchor` would be the result of demoting, say, > >> `@subsection` to `@subsubheading`. > > > > It seems to me

Re: `@anchor` improvement

2025-02-14 Thread Werner LEMBERG
>> > But do you really want to get the old sectioning name back for >> > printed output? >> >> Yes, because using `@anchor` would be the result of demoting, say, >> `@subsection` to `@subsubheading`. > > It seems to me that this specific use case would benefit even more > from another options, wh

Re: `@anchor` improvement

2025-02-14 Thread pertusus
On Thu, Feb 13, 2025 at 12:53:44PM +, Werner LEMBERG wrote: > > >> * For translators, having the same anchor name as in the original > >> document helps a lot in translation. And vice versa, it helps > >> maintainers who don't speak the particular language to still do > >> various maint