Removal of old/outdated files from www.FreeBSD.org site

[Glen Barber]

"Simon L. B. Nielsen" <simon at FreeBSD.org> wrote:

>[Adding www@ so more people will see and we can wait a bit with the
>next time this comes up :) ]
>

Thank you.

>On 28 Jul 2012, at 05:17, Glen Barber wrote:
>
>[Stale files]
>
>> http://www.freebsd.org/doc/en/books/porters-handbook/x5798.html
>> http://www.freebsd.org/doc/en/books/porters-handbook/x5802.html
>> http://www.freebsd.org/doc/en/books/porters-handbook/x5834.html
>> 
>> If someone from clusteradm@ (or someone else with access to the
>machine
>> on which the documentation build output exists) can remove these old
>> files so they are not archived by search engines (since in some
>cases,
>> old file names can indicate very old files, and worse, very old
>> information that could be potentially dangerous to a user looking for
>> specific information), I would greatly appreciate it.
>
>The problem is that it's not a simple thing to do. Our build installs
>with the option to not install if files are identical, so timestamps
>can't be used alone.
>

Ah, I did forget about that.

>E.g.
>http://www.freebsd.org/doc/en/books/porters-handbook/TRADEMARKS.html :
>
>-r--r--r--  1 www  wwwadm  4494 Jan  9  2010 TRADEMARKS.html
>
>I have removed the mentioned files but I don't have time to do a full
>sweep as I might end up deleting too much.
>

Ok, thank you.  My big concern is if someone "accidentally" finds an old document and does something potentially dangerous to their system.

>> Furthermore, if someone with the appropriate access can provide a
>list
>> of similarly-named files (which also likely can be fixed with adding
>a
>> section id to the source), I will personally fix the section id so
>these
>> files do not occur again.  (It would be even more helpful if the
>files
>> could be provided as an attachment so I can view the source to track
>> down from where they are being generated.)
>
>There is no need for special access to do that. Just build all the docs
>in html-split and find xNNNN.html files. It's a regular thing which has
>to be done as people forget when adding new content. I also remember
>hunting down those files when I more active in doc.
>

I will look into this for a permanent solution then.  It is difficult to spot unless local changes are made though.  But, 'make clean' followed by 'svn stat' will reveal these edge cases.

>I just looked at porters-handboot and it seems there is at least one
>left:
>
>-r--r--r--   1 www  wwwadm    2917 Jul 26 13:31 x5834.html
>

Yes, this should be fixed now.  This is the section ID I added yesterday.

><h1 class="SECT1"><a id="AEN5834" name="AEN5834">6.26 Ports That Rely
>on Kernel
>Sources</a></h1>
>

Anyway, thanks for looking into it.

Glen


-- 
Sent from my Android phone with K-9 Mail. Please excuse my brevity.