Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 29 Jul 2012 01:57:42 -0400
From:      Glen Barber <gjb@FreeBSD.org>
To:        "Simon L. B. Nielsen" <simon@FreeBSD.org>
Cc:        webmaster@freebsd.org, FreeBSD Documentation Masters <doceng@FreeBSD.org>, World Wide Web Owner <www@FreeBSD.org>
Subject:   Re: Removal of old/outdated files from www.FreeBSD.org site
Message-ID:  <20120729055742.GC1693@glenbarber.us>
In-Reply-To: <48CC53EB-AB26-4F52-99AA-7D4ED0B8F85F@FreeBSD.org>
References:  <20120728041732.GH1485@glenbarber.us> <9B7CD8B1-42CB-487D-9C27-C9F6D39CD600@FreeBSD.org> <40854dbc-f4c1-4609-9f48-791a1886c0c9@email.android.com> <48CC53EB-AB26-4F52-99AA-7D4ED0B8F85F@FreeBSD.org>

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

--p2kqVDKq5asng8Dg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sat, Jul 28, 2012 at 10:14:11PM +0100, Simon L. B. Nielsen wrote:
> As a reference, the build script is at:
> http://svnweb.freebsd.org/doc/head/share/tools/webupdate
>=20
> So anyone wanting to try and fix that can start reading that. The
> simple brute force solution would e.g. be a weekly install to a
> separate dir and then check which files should not be in the dir
> we serve www.freebsd.org off.
>=20

Or, we can force a reinstall regardless of mtime.

> Another solution might be to make the weekly full build install
> to a different dir and switch the clean and the old dir... but I
> slightly worry that any error in the script will result in no content
> on www.

Agreed.

> > 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.
>=20
> Hmm, how is it difficult to spot? A build of a document should
> never ever produce an xNNNNN.html file. If it does, a sect1 is
> missing an id.
>=20
> Or am I missing something here?
>=20

They are edge-cases.  A few of which have taken me a few days to track
the cause.

It is not necessarily a problem with the build scripts, etc., but
changes are that introduced as a result of workflow.  I am still unsure
of the exact chain of events that causes the duplicate, yet
differently-named files, but it seems to follow in this pattern:

 o make changes to a chapter, rebuild the doc tree
 o make changes to a different section, rebuild the tree
 o run 'make clean', and xNNNN.html file from first change is not
   removed

It has been highly inconsistently reproducible for me.

Again, I am not saying there is a problem.  I just want to avoid users
finding outdated/wrong/bad/evil information from N years ago that would
do very bad things to a system today.

Glen


--p2kqVDKq5asng8Dg
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (FreeBSD)

iQEcBAEBCAAGBQJQFNDWAAoJEFJPDDeguUaji/YH/iijzCc8/vzkqiVBJK3dqDFq
MRJSh58+kA56sxg/6D29tRvtNeQ5DIr9RLYG7331wy9blpDNMMFkYMVxp5k2RIfL
QbfqPUoq8cOwemU7TlDexVe/jteRrZXu2oRRnzuQQMfKrbLeh2m2OlNO3+n9oXjD
tscll7fXdUrwdzHj1AfGgBR+0wr9vjaY7MHDsEmWUtrh9VvAMekST9zM/MGtADhF
eSuqlLMQudwxQS7eC89Je9zzoFqlS5oQC7YsJ+bTyeni6hpjjisbFK6ImsQYixJp
V3PAQfOdWoMeCrw59/WTiiBrYMZmhmL8MOKSftrdML4J1zZe+lOEF1McgdYg/OM=
=iO98
-----END PGP SIGNATURE-----

--p2kqVDKq5asng8Dg--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120729055742.GC1693>