We need to remove the Sphinx HTML docs

[Jonathan Wakely]

On Sun, 31 Aug 2025 at 00:32, Gerald Pfeifer wrote:
>
> On Sat, 26 Apr 2025, Jonathan Wakely wrote:
> > I found (and removed) some more sphinx leftovers under /onlinedocs/cpp/
>
> Thanks!
>
> I found some time and dug into this. Addressing this properly means to
> update some of our scripting, for which I have a prototype ready.
>
> On the libstdc++ my updated scripts found the following which look like
> orphans:
>
>   $ ll /www/gcc/htdocs/onlinedocs/libstdc++/ext/
>   total 6760
>   -rw-rw-r--. 1 gccadmin gcc 1132364  2. Jun 2015  lwg-active.html
>   -rw-rw-r--. 1 gccadmin gcc 1414040  2. Jun 2015  lwg-closed.html
>   -rw-rw-r--. 1 gccadmin gcc 4344911  2. Jun 2015  lwg-defects.html

As noted in my previous email, these can go.

>   drwxrwxr-x. 2 gccadmin gcc   20480 25. Mai 2011  pb_ds

The pb_ds docs were converted from HTML files under
libstdc++/doc/html/ext/pb_ds to part of the XML DocBook manual in 2011
with  r0-110490-gce1140e3f2f7cd so that directory looks like a
leftover from before then. So that can be removed too.


>
> and
>
>   $ ll /www/gcc/htdocs/onlinedocs/libstdc++/dated/
>   total 240
>   drwxrwsr-x. 2 gccadmin gcc  4096 15. Jul 2010  17_intro
>   drwxrwsr-x. 2 gccadmin gcc    24 15. Jul 2010  18_support
>   drwxrwsr-x. 2 gccadmin gcc    24 15. Jul 2010  19_diagnostics
>   drwxrwsr-x. 2 gccadmin gcc    69 15. Jul 2010  20_util
>   drwxrwsr-x. 2 gccadmin gcc    93 15. Jul 2010  21_strings
>   drwxrwsr-x. 2 gccadmin gcc   102 15. Jul 2010  22_locale
>   drwxrwsr-x. 2 gccadmin gcc    46 15. Jul 2010  23_containers
>   drwxrwsr-x. 2 gccadmin gcc    24 15. Jul 2010  24_iterators
>   drwxrwsr-x. 2 gccadmin gcc    24 15. Jul 2010  25_algorithms
>   drwxrwsr-x. 2 gccadmin gcc    24 15. Jul 2010  26_numerics
>   drwxrwsr-x. 2 gccadmin gcc   123 15. Jul 2010  27_io
>   -rw-rw-r--. 1 gccadmin gcc 34003 13. Nov 2007  abi.html
>   -rw-rw-r--. 1 gccadmin gcc 12934 29. Jul 2003  abi.txt
>   -rw-rw-r--. 1 gccadmin gcc 17669 13. Mär 2004  ballocator_doc.txt
>   -rw-rw-r--. 1 gccadmin gcc 14563 12. Feb 2008  configopts.html
>   -rw-rw-r--. 1 gccadmin gcc 18057 12. Feb 2008  debug.html
>   -rw-rw-r--. 1 gccadmin gcc 27077 13. Nov 2007  debug_mode.html
>   -rw-rw-r--. 1 gccadmin gcc 13087 12. Feb 2008  documentation.html
>   -rw-rw-r--. 1 gccadmin gcc  3417 13. Nov 2007  explanations.html
>   drwxrwsr-x. 2 gccadmin gcc   255 15. Jul 2010  ext
>   drwxrwsr-x. 2 gccadmin gcc    41 15. Jul 2010  faq
>   -rw-rw-r--. 1 gccadmin gcc  8966 12. Feb 2008  install.html
>   -rw-rw-r--. 1 gccadmin gcc   201 16. Mär 2001  lib3styles.css
>   -rw-rw-r--. 1 gccadmin gcc  1772  6. Sep 2002  makedoc.awk
>   -rw-rw-r--. 1 gccadmin gcc 18003 13. Nov 2007  parallel_mode.html
>   drwxrwsr-x. 2 gccadmin gcc  8192 15. Jul 2010  pb_assoc
>   -rw-rw-r--. 1 gccadmin gcc 24625 12. Feb 2008  test.html

I think these were all removed by  r0-85736-g620039adfb7162 (or even
earlier) so I think the whole 'dated' dir can go.

> And there is /www/gcc/htdocs/onlinedocs/libstdc++/latest-doxygen/
> where everything is one year, eight days old.

That symlink (and the dir it points to) should stay.

> Which of these three can I yank? (And which do I need to account for?)