Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 29 Jul 2012 10:29:28 +0100
From:      "Simon L. B. Nielsen" <simon@FreeBSD.org>
To:        Hiroki Sato <hrs@FreeBSD.ORG>
Cc:        webmaster@FreeBSD.org, gjb@FreeBSD.org, www@FreeBSD.org, doceng@FreeBSD.org
Subject:   Re: Removal of old/outdated files from www.FreeBSD.org site
Message-ID:  <BBAE5EF9-9EBD-455E-A2FB-FE53363AB4C3@FreeBSD.org>
In-Reply-To: <20120729.164322.483414833938209747.hrs@allbsd.org>
References:  <40854dbc-f4c1-4609-9f48-791a1886c0c9@email.android.com> <48CC53EB-AB26-4F52-99AA-7D4ED0B8F85F@FreeBSD.org> <20120729055742.GC1693@glenbarber.us> <20120729.164322.483414833938209747.hrs@allbsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help

On 29 Jul 2012, at 08:43, Hiroki Sato wrote:

> Glen Barber <gjb@FreeBSD.org> wrote
>  in <20120729055742.GC1693@glenbarber.us>:
>=20
> gj>  o make changes to a chapter, rebuild the doc tree
> gj>  o make changes to a different section, rebuild the tree
> gj>  o run 'make clean', and xNNNN.html file from first change is not
> gj>    removed
> gj>
> gj> It has been highly inconsistently reproducible for me.
>=20
> The xNNNN.html files can be left if building a doc, adding a new
> section to it, and rebuilding it, and then doing "make clean".
> Normally all of the generated *.html files including xNNNN.html are
> listed in HTML.manifest and "make clean" removes files in that file.
> However, adding a new section can change the name of xNNNN.html files
> and the successive rebuild overwrites HTML.manifest.
>=20
> The right way to solve this is adding section ids wherever
> applicable.  I do not think we need to change the webupdate script
> once we remove the old files.

I think we should still. It's not just a problem for xNNNNN.html file, =
but also removed sections and renamed sections. E.g. we did recently =
have a case where in the handbook there was a stale install chapter etc. =
because the section had been renamed. Old files will accumulate if we =
cannot automatically remove them.

--=20
Simon L. B. Nielsen




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?BBAE5EF9-9EBD-455E-A2FB-FE53363AB4C3>