On Mon, 2023-11-13 at 14:11 +0100, Marc Poulhiès wrote: > > David Malcolm <dmalc...@redhat.com> writes: > > > gcc/ada/ChangeLog: > > * gcc-interface/lang.opt.urls: New file, autogenerated by > > regenerate-opt-urls.py. > > > > diff --git a/gcc/ada/gcc-interface/lang.opt.urls b/gcc/ada/gcc- > > interface/lang.opt.urls > > new file mode 100644 > > index 000000000000..e24210bcb12a > > --- /dev/null > > +++ b/gcc/ada/gcc-interface/lang.opt.urls > > @@ -0,0 +1,28 @@ > > +; Autogenerated by regenerate-opt-urls.py from gcc/ada/gcc- > > interface/lang.opt and generated HTML > > + > > +I > > +UrlSuffix(gcc/Directory-Options.html#index-I) > > + > > +; skipping 'Wall' due to multiple URLs: > > +; duplicate: 'gcc/Standard-Libraries.html#index-Wall-1' > > +; duplicate: 'gcc/Warning-Options.html#index-Wall' > > + > > +nostdinc > > +UrlSuffix(gcc/Directory-Options.html#index-nostdinc) > > + > > +nostdlib > > +UrlSuffix(gcc/Link-Options.html#index-nostdlib) > > + > > +; skipping 'fshort-enums' due to multiple URLs: > > +; duplicate: 'gcc/Code-Gen-Options.html#index-fshort-enums' > > +; duplicate: 'gcc/Non-bugs.html#index-fshort-enums-3' > > +; duplicate: 'gcc/Structures-unions-enumerations-and-bit-fields- > > implementation.html#index-fshort-enums-1' > > + > > +; skipping 'fsigned-char' due to multiple URLs: > > +; duplicate: 'gcc/C-Dialect-Options.html#index-fsigned-char' > > +; duplicate: 'gcc/Characters-implementation.html#index-fsigned- > > char-1' > > + > > +; skipping 'funsigned-char' due to multiple URLs: > > +; duplicate: 'gcc/C-Dialect-Options.html#index-funsigned-char' > > +; duplicate: 'gcc/Characters-implementation.html#index- > > funsigned-char-1' > > Hello David, > > This looks very nice, thanks! > > I wonder why the Ada frontend only gets I, nostdinc and nostdlib > URLified to the common gcc doc. > > Is it possible that your doc scrapper doesn't match the option in the > Ada doc? We are documenting nostdlib, nostdinc and I, so I would also > expect a "multiple URLs" for these.
The new regenerate-opt-urls.py script only parsed buildir/gcc/HTML/gcc-14.0.0/gcc/Option-Index.html looking for anchors for options via a regex. Looking at my build, I don't see any generated Ada HTML docs, so maybe I messed this up? Does the generated HTML from the generated Ada texinfo go somewhere else? (and, in particular, does it have its own index?) Perhaps this script could also deal directly with Sphinx-generated HTML? > We are generating the texinfo files > from sphinx, so maybe we could adjust the script to also match what > the > sphinx generator produces? It *might* be as simple as pointing it at the option index for the generated HTML for Ada. Though as Iain's email points out, there may be some issues with per- language URLs for options that my approach doesn't quite handle yet. Dave
