Re: wishlist: implicit anchor for @deffn etc

[Per Bothner]

On 11/01/2017 01:27 PM, Eli Zaretskii wrote:
> > Instead I propose a @dref command:
> >
> >     @dref{[CATEGORY] NAME [NUMBER][,ONLINE LABEL]}

> That's unlike any other command in Texinfo, and confusingly so.

It's just a suggestion.  It's compact and readable, but I'm not wedded to the 
syntax.

> Using NUMBER is IMO a problem, because (1) the author need to count them,
> and (2) it needs to be updated when text changes.

Except that the need for NUMBER would be close to never. It's basically
a fall-back for the pathological case when you have more than one definition
that have the same CATEGORY and NAME.

> > "Should" is meaningless.  People "should" be using texinfo for their technical
> > documentation - but they don't (and won't as long as we keep focusing on info).
>
> The GNU project uses Texinfo all the time, and our users use the Info
> manuals produced from that.

If you subtract old-guard hackers who have been contributing to or using GNU 
tools for 20+ years
(like us), how many people actually prefer info to html documentation?  More 
than 1% ?
Hell, I prefer html documentation (which is why I'm pushing for improving the 
html UI).
--
        --Per Bothner
address@hidden   http://per.bothner.com/