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>