> -----Original Message----- > From: Gcc <gcc-bounces~tamar.christina=arm....@gcc.gnu.org> On Behalf Of > Jonathan Wakely via Gcc > Sent: Friday, November 15, 2024 12:25 PM > To: Gerald Pfeifer <ger...@pfeifer.com> > Cc: gcc Mailing List <gcc@gcc.gnu.org> > Subject: Re: We need to remove the Sphinx HTML docs > > On Fri, 15 Nov 2024 at 12:22, Jonathan Wakely <jwak...@redhat.com> wrote: > > > > On Fri, 15 Nov 2024 at 12:14, Jonathan Wakely <jwak...@redhat.com> wrote: > > > > > > Hi Gerald, > > > > > > The HTML pages from Martin Liska's Sphinx doc experiment are still > > > online, and Google thinks they are the canonical locatiosn for GCC > > > docs. > > > e.g. try https://www.google.com/search?client=firefox-b- > d&q=%22inline+function+is+as+fast+as+a+macro%22++gcc > > > > > > The only hit from gcc.gnu.org is a snapshot of GCC 13.0.0 from > > > 20221114, two years old. > > > > > > I want to remove those docs. As nice as they look, the content is > > > outdated and getting more so by the day. They're doing more harm than > > > good now. > > > > > > It looks like we removed all the /onlinedocs/gcc/*.html pages from the > > > Sphinx docs, but we did NOT remove the /oneline/docs/gcc/*/*.html > > > pages, e.g. > > > https://gcc.gnu.org/onlinedocs/gcc/language-standards-supported-by- > gcc.html > > > is 404 > > > but all the pages below that section are still there e.g. > > > https://gcc.gnu.org/onlinedocs/gcc/language-standards-supported-by-gcc/ > > > JOINME c-language.html > > > works (if you remove " XXX " from the URL, I don't want to link to it > > > so I don't give web crawlers ideas). > > > > Oops, s/XXX/JOINME/ or vice versa. I hope you get the idea. > > > > section.html is not present, but section/subsection.html is present. > > > > > > > > > > On IRC mjw suggested that you (Gerald) might object to breaking links > > > by just removing them. I think the pages are already broken (the links > > > in the sidebar are half missing already). > > > > > > If we think preserving those links is important (I don't) then we > > > could add this to htdocs/.htaccess:
FWIW, Even though I was one of those that really liked and wanted this documentation update to sphinx, I agree with removing them as it is just confusing or misleading to users at this point. I do hope that in the future we could try to modernize the documentations again, using whatever format is best. Cheers, Tamar > > > > > > RedirectMatch permanent > > > /onlinedocs/gcc/extensions-to-the-c-language-family/.* > > > https://gcc.gnu.org/onlinedocs/gcc/C-Extensions.html > > > RedirectMatch permanent > > > /onlinedocs/gcc/language-standards-supported-by-gcc/.* > > > https://gcc.gnu.org/onlinedocs/gcc/Standards.html > > > RedirectMatch permanent /onlinedocs/gcc/gcc-command-options/.* > > > https://gcc.gnu.org/onlinedocs/gcc/Invoking-GCC.html > > > RedirectMatch permanent > > > /onlinedocs/gcc/c-implementation-defined-behavior/.* > > > https://gcc.gnu.org/onlinedocs/gcc/C-Implementation.html > > > RedirectMatch permanent > > > /onlinedocs/gcc/c++-implementation-defined-behavior/.* > > > https://gcc.gnu.org/onlinedocs/gcc/C_002b_002b-Implementation.html > > > RedirectMatch permanent > > > /onlinedocs/gcc/extensions-to-the-c-language-family/.* > > > https://gcc.gnu.org/onlinedocs/gcc/C-Extensions.html > > > RedirectMatch permanent > > > /onlinedocs/gcc/extensions-to-the-c++-language/.* > > > https://gcc.gnu.org/onlinedocs/gcc/C_002b_002b-Extensions.html > > > RedirectMatch permanent /onlinedocs/gcc/gnu-objective-c-features/.* > > > https://gcc.gnu.org/onlinedocs/gcc/Objective-C.html > > > RedirectMatch permanent /onlinedocs/gcc/gcov/.* > > > https://gcc.gnu.org/onlinedocs/gcc/Gcov.html > > > RedirectMatch permanent > > > /onlinedocs/gcc/known-causes-of-trouble-with-gcc/.* > > > https://gcc.gnu.org/onlinedocs/gcc/Trouble.html > > > > > > Can we just remove those pages instead? > > All these directories should have been removed two years ago: > > $ ls -1 -d htdocs/onlinedocs/gcc/*/ > htdocs/onlinedocs/gcc/c-implementation-defined-behavior/ > htdocs/onlinedocs/gcc/extensions-to-the-c++-language/ > htdocs/onlinedocs/gcc/extensions-to-the-c-language-family/ > htdocs/onlinedocs/gcc/gcc-command-options/ > htdocs/onlinedocs/gcc/gcov/ > htdocs/onlinedocs/gcc/gnu-objective-c-features/ > htdocs/onlinedocs/gcc/known-causes-of-trouble-with-gcc/ > htdocs/onlinedocs/gcc/language-standards-supported-by-gcc/ > htdocs/onlinedocs/gcc/_sources/ > htdocs/onlinedocs/gcc/_static/
