Bug 121958 - Document requirements for updating *opt.urls; advertised method does not work
Summary: Document requirements for updating *opt.urls; advertised method does not work
Status: ASSIGNED
Alias: None
Product: gcc
Classification: Unclassified
Component: other (show other bugs)
Version: 16.0
: P3 normal
Target Milestone: ---
Assignee: David Malcolm
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-09-16 06:20 UTC by Thomas Koenig
Modified: 2025-09-17 17:00 UTC (History)
1 user (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2025-09-16 00:00:00


Attachments
Patch which does not regenerate *.urls (1.02 KB, patch)
2025-09-16 16:11 UTC, Thomas Koenig
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Thomas Koenig 2025-09-16 06:20:07 UTC
There is curently no documented way of updating the *.opt.url files.

a) It requires Texinfo 6.8 or higher, this should be mentioned in
https://gcc.gnu.org/install/prerequisites.html , according to
https://gcc.gnu.org/pipermail/gcc/2025-September/246675.html

b) The method itself is only documented in the mailing list, for
example in https://gcc.gnu.org/pipermail/fortran/2024-September/061030.html .
Comment 1 Thomas Koenig 2025-09-16 15:50:27 UTC
The advertised method of installing Texinfo >= 6.8 does not work:

tkoenig@cfarm120 trunk-bin]$ make -C gcc regenerate-opt-urls
make: Entering directory '/home/tkoenig/trunk-bin/gcc'
../../trunk/gcc/regenerate-opt-urls.py /home/tkoenig/trunk-bin/gcc/HTML/gcc-16.0.0 ../../trunk
make: Leaving directory '/home/tkoenig/trunk-bin/gcc'

[tkoenig@cfarm120 trunk]$ git status
On branch master
Your branch is up to date with 'origin/master'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   gcc/fortran/frontend-passes.cc
        modified:   gcc/fortran/lang.opt
        modified:   gcc/fortran/options.cc

Notice the absence of modifications to gcc/fortran/lang.opt.urls .
Comment 2 Sam James 2025-09-16 15:57:29 UTC
We should document that it needs Python too.

(In reply to Thomas Koenig from comment #1)

Is the patch somewhere for us to play with? I want to see if I can repro.
Comment 3 Thomas Koenig 2025-09-16 16:11:40 UTC
Created attachment 62389 [details]
Patch which does not regenerate *.urls

Here's the patch.

Configure was

../trunk/configure --prefix=$HOME --enable-languages=c,c++,fortran
Comment 4 David Malcolm 2025-09-16 21:50:24 UTC
Sorry about this; taking a look.
Comment 5 David Malcolm 2025-09-16 23:04:41 UTC
The patch doesn't contain documentation for the new option.

Looks like there's a bug in regenerate-opt-urls.py where it fails to emit a comment mentioning options with no documentation.
Comment 6 Thomas Koenig 2025-09-17 17:00:40 UTC
(In reply to David Malcolm from comment #5)
> The patch doesn't contain documentation for the new option.
> 
> Looks like there's a bug in regenerate-opt-urls.py where it fails to emit a
> comment mentioning options with no documentation.

That seems to have been the case - It worked when I added the
documentation (as I should :-)