Date: Sun, 25 Feb 2001 06:40:44 +0000 From: Nik Clayton <nik@freebsd.org> To: Wolfram Schneider <wosch@FreeBSD.org> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: www/en Makefile Message-ID: <20010225064044.A68105@canyon.nothing-going-on.org> In-Reply-To: <200102241031.f1OAVTZ82598@freefall.freebsd.org>; from wosch@FreeBSD.org on Sat, Feb 24, 2001 at 02:31:29AM -0800 References: <200102241031.f1OAVTZ82598@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Feb 24, 2001 at 02:31:29AM -0800, Wolfram Schneider wrote: > wosch 2001/02/24 02:31:29 PST > > Modified files: > en Makefile > Log: > Undo rev 1.59 and don't build the docs directory > > Large URLs like > > http://www.FreeBSD.ORG/docs/en_US.ISO_8859-1/books/handbook/ > > are evil and hard to use for humans. There is no reason to move > our handbooks 3 (!) directory levels deeper. I'm not proposing we go out of our way to publicise those URLs. You'll notice that I've done nothing about the existing /handbook and /faq directories, or the various Makefile contortions that we go through to put things under a tutorials/ directory, or the various other horrible hacks in the www/ build Makefiles. You'll also notice that the *only* place that uses these new paths is the top level docs.html page. Nothing else on the site uses them (yet). [ The net effect of which is that we build some of the documentation at least twice when we build the web site. Rome wasn't built in a day, and I'm not going to go ripping out chunks of old infrastructure when the new stuff can sit alongside it for a few days and get bedded down ] Long term, I think we need one canonical path for the documents. Shortcuts (such as /handbook) which we're currently handling the web server configuration should be replaced by symlinks, constructed as part of the 'make install' process (particularly as the web server configuration file is not stored anywhere under the www/ repo, so there is (AFAIK) no way for our mirrors to know what nasty redirects we might have in there. In fact, if you look under freefall:/usr/local/www/data/docs/ you'll see some of those shortcuts in place now. > Also, docs did not build and too many things are now broken on the > web server. True and not true. I did a manual build of the tree myself, on freefall, to make sure that things worked. They did. As I've just discovered, it won't have worked when the DESTDIR environment variable doesn't exist, as unset(1) return 1 instead of 0 to the environment when that happens. I've just committed a fix to docs/Makefile for that, and I'm doing another build of the site now to double check. > So I immediate back this nightmare out. Please back out your backing out, unless I've missed something else and the website build is still borked (it better not be, I'm running your own script, ~wosch/bin/myupdate, to make sure that things are working properly. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010225064044.A68105>