[Bug web/107610] New: Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[Bug web/107610] New: Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[tschwinge at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

            Bug ID: 107610
           Summary: Broken 'onlinedocs' after "Porting the Docs to Sphinx"
           Product: gcc
           Version: unknown
            Status: UNCONFIRMED
          Keywords: documentation
          Severity: major
          Priority: P3
         Component: web
          Assignee: unassigned at gcc dot gnu.org
          Reporter: tschwinge at gcc dot gnu.org
                CC: marxin at gcc dot gnu.org
  Target Milestone: ---

I notice broken 'onlinedocs' after "Porting the Docs to Sphinx", such as:
<https://gcc.gnu.org/onlinedocs/gccint/Directives.html#Specify-additional-compiler-options>,
<https://gcc.gnu.org/onlinedocs/gcc/Warning-Options.html>, or
<https://gcc.gnu.org/onlinedocs/gccint/Directives.html#Verify-compiler-messages>,
for example, which currently return "404 Not Found".

There are a lot of such references in external pages, which we should keep
working as much as feasible.

I thought I'd seen some discussion in IRC yesterday that this has been
addressed, but evidently it's not (completely?).

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[jgreenhalgh at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

James Greenhalgh <jgreenhalgh at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |NEW
   Last reconfirmed|                            |2022-11-10
     Ever confirmed|0                           |1
                 CC|                            |jgreenhalgh at gcc dot gnu.org

--- Comment #1 from James Greenhalgh <jgreenhalgh at gcc dot gnu.org> ---
Confirming - I also found this when search results pointed me to
https://gcc.gnu.org/onlinedocs/gcc/Function-Attributes.html - which failed.

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

--- Comment #2 from Jonathan Wakely <redi at gcc dot gnu.org> ---
I posted a patch adding http redirects:
https://gcc.gnu.org/pipermail/gcc-patches/2022-November/605528.html

The discussion on IRC was about doing that, not that it's already fixed.

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

--- Comment #3 from Jonathan Wakely <redi at gcc dot gnu.org> ---
I've (temporarily) installed the redirects in a .htaccess on my own site so you
can test them.

Just replace "gcc.gnu.org" with "kayari.org" to check that it redirects to a
valid page of the gcc-12.2.0 docs:

https://kayari.org/onlinedocs/gccint/Test-Directives.html#Test-Directives
https://kayari.org/onlinedocs/gcc/Function-Attributes.html

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

Jonathan Wakely <redi at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|unassigned at gcc dot gnu.org      |redi at gcc dot gnu.org
             Status|NEW                         |ASSIGNED

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[gjl at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

--- Comment #4 from Georg-Johann Lay <gjl at gcc dot gnu.org> ---
Also affected are other bits of the web page that are auto-generated, like

https://gcc.gnu.org/install/configure.html

And with the new URLs, "deep" links like

https://gcc.gnu.org/install/configuration.html#avr

ceased to work, too, even though the old ./gcc/doc/install.texi generated
(working) anchors like:

@html
<a name="avr"></a>
@end html
@item --with-avrlibc

So the porting-to-sphinx dropped them, which is really sad.

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

--- Comment #5 from Martin Liška <marxin at gcc dot gnu.org> ---
There's an alternative suggestion that would basically keep old documentation
where it used to be. For the new one, we'll use a new url base:
https://gcc.gnu.org/docs:

https://gcc.gnu.org/pipermail/gcc-patches/2022-November/605722.html

[Bug web/107610] Broken 'onlinedocs' after "Porting the Docs to Sphinx"

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107610

Martin Liška <marxin at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         Resolution|---                         |WONTFIX
             Status|ASSIGNED                    |RESOLVED

--- Comment #6 from Martin Liška <marxin at gcc dot gnu.org> ---
The Sphinx documentation has been reverted:
https://gcc.gnu.org/pipermail/gcc/2022-November/239983.html

Thus, I'm closing this as won't fix.