On Mon, 12 Jul 2021 at 15:52, Jonathan Wakely <jwakely....@gmail.com> wrote: > > On Mon, 12 Jul 2021 at 15:13, Eli Zaretskii <e...@gnu.org> wrote: > > I get it that you dislike the HTML produced by Texinfo, but without > > some examples of such bad HTML it is impossible to know what exactly > > do you dislike and why. > > > > > You can't find out the anchors without inspecting (and searching) > > > the HTML source. That's utterly stupid. > > > > I don't think I follow: find out the anchors with which means and for > > what purposes? > > I want to point a user at the documentation for the -c option. I can't > do that without examining the HTML source to find the anchor, then > manually editing the URL to append the anchor. It's a tedious process, > and the result is an anchor that doesn't even point to the option but > to the text following it. The process is unnecessarily difficult and > the results are bad. > > You participated in a discussion about this very topic previously: > https://lists.gnu.org/archive/html/help-texinfo/2019-02/msg00000.html > > > > > > And even after you do that, the anchor > > > is at the wrong place: > > > https://gcc.gnu.org/onlinedocs/gcc/Overall-Options.html#index-c > > > > IME, the anchor is where you put it. If you show me the source of > > that HTMl, maybe we can have a more useful discussion of the issue. > > @item -c > @opindex c > Compile or assemble the source files, but do not link. The linking > stage simply is not done. The ultimate output is in the form of an > object file for each source file. > > Putting the @opindex before the @item causes the anchor to be placed > on the previous item, which is not desirable.
GNU Hello has the same problem with its docs: https://www.gnu.org/software/hello/manual/hello.html#index-_002dg That URL is garbage because of the URL-encoded %2d character, and the fact it links to the wrong place (the description of the option, not the option itself). The former is no longer an issue for GCC (it was for many years) but the latter is still a problem. If you don't know where to find it yourself, the source is visible here: https://github.com/yugui/example/blob/master/doc/hello.texi#L208 If GNU Hello and GCC can't get this right using texinfo, maybe texinfo is not fit for purpose?
