Re: onlinedocs/libstdc++ appears stale

[Gerald Pfeifer <gerald at pfeifer dot com>]

First of all, apologies for not being able to follow up on this earlier.

On Mon, 14 Jun 2010, Jonathan Wakely wrote:
>> Any objection to me running the following
>>
>> ?find . -name '*.html' | while read f; do
>> ? ?g="$f.gz"
>> ? ?if [ -e "$g" ] && [ "$f" -ot "$g" ]; then
>> ? ? ?echo "$f is older than $g and should be removed."
>> ? ?fi
>> ?done
>>
>> where the echo is replaced by an "rm $f"?
> That seems like the right thing to do.
> 
> I think it will leave some stale files in place, because the output of
> generating the html docs creates different filenames sometimes, so
> there won't be a new .gz for all the old files.  Those stale files
> shouldn't be reachable from any fresh pages.

I just did so and ran that script, and it removed 395 .html files where
the .html.gz version was newer than that (but our web server still served
the .html ones).  

Let me attach the list of files thusly removed.

> If you could send me a list of all the files remaining under that dir
> after your command, I will let you know which can safely be removed
> because they are stale and have been replaced by a new file with a
> different name.

Let me also attach the list of all files still under onlinedocs/libstdc++.


And now to the interesting part!  After this cleanup, gcc.gnu.org no 
longer serves any pages under onlinedocs/libstdc++, e.g.

  The requested URL /onlinedocs/libstdc++/api.html was not found on
  this server.

As a stop gap measure I ran the equivalent of

  find . -name '*.html.gz' -exec gunzip {} \;

excluding those pages where the .html version exists which, after the
first run above, means that the .html was the same time as the .html.gz.


How shall we address this for real?  Is it really worthwhile to manually
generate those .html.gz files for onlinedocs/libstdc++ or could we simply
omit that step?  Not sure it's really worth the hassles?

Gerald

Attachment: removed
Description: Text document

Attachment: all.bz2
Description: application/bzip