Date: Sat, 12 May 2001 00:30:25 -0700 From: Dima Dorfman <dima@unixfreak.org> To: doc@freebsd.org Cc: nik@freebsd.org, bmah@freebsd.org Subject: Relnotes on the web site Message-ID: <20010512073025.BC6243E0B@bazooka.unixfreak.org>
next in thread | raw e-mail | index | archive | help
As threatened some time ago, Bruce Mah and I would like to see the
release notes be part of the web site. There are two basic parts to
making this happen. One is to update the build scripts on freefall to
check out or update src/release/doc, and two is to write the necessary
make(1) glue to build the relnotes with the web site.
I've written the make glue. Attached is a diff against /dev/null for
a Makefile that should go in www/en/relnotes and a patch to
www/en/Makefile to add it to the SUBDIR list. This is all that should
be required. If someone (nik or wosch) could arrage for a checkout of
src/release/doc when the web site is built then everything would
pretty much be complete.
Some random notes:
- When RELNOTESng is MFC'd to releng_4, it would be nice to have the
src/release/doc for current be side by side with the src/release/doc
for stable. I.e., have on directory named 'relnotes-current' and
another 'relnotes-stable'. The names themselves or their position
relative to www/en are of no concern (of course, someone has to
tell me).
- At the beginning, building the relnotes with the web site should
probably be optional; i.e., conditional on some make variable
being set (like we have WEB_ONLY). If we want to do this (and I
think we should), someone will also have to arrange for that to be
set on freefall for the web build.
- I don't know how mirrors want to or can deal with this. Nothing
will stop them from building the relnotes as well, but I guess it
shouldn't be requied, at least not at first. Bruce? Comments?
I think that's it. Comments? Suggestions?
Thanks,
Dima Dorfman
dima@unixfreak.org
P.S. Would anyone have a fit if I raised the number of directories traversed
to find LANGCODE (doc.subdir.mk) to, say, 10? I ran into the current limit
(5) on my local builds; it may or may not be a problem, but I'd like to raise
it so nothing magically breaks later.
--- /dev/null Fri May 11 22:55:08 2001
+++ Makefile Sat May 12 00:25:53 2001
@@ -0,0 +1,29 @@
+#
+# Web site build hooks for the Release Notes.
+#
+# The variable RELNOTES (I couldn't think of a better name) is a poor
+# man's list. Its semantics are very similar to that of MLINKS (see
+# bsd.man.mk). The first word is the directory under which that set
+# of relnotes should appear on the web site. The second word is the
+# path to that relnotes set.
+#
+# $FreeBSD$
+#
+
+RELNOTES = CURRENT ${.CURDIR}/../../../src/release/doc
+
+all install clean obj:
+ @set ${RELNOTES}; \
+ while :; do \
+ case $$# in \
+ 0) break;; \
+ 1) echo "bad \$$RELNOTES value"; false; break;; \
+ esac; \
+ webname=$$1; shift; realpath=$$1; shift; \
+ (unset DESTDIR || true; \
+ cd $$realpath && ${MAKE} \
+ FORMATS=html\ html-split \
+ DOCDIR=${DESTDIR}/data/${.CURDIR:T}/$$webname \
+ DIRPRFX=${.CURDIR:T}/$$webname/ \
+ ${.TARGET}); \
+ done;
Index: Makefile
===================================================================
RCS file: /st/src/FreeBSD/www/en/Makefile,v
retrieving revision 1.65
diff -u -r1.65 Makefile
--- Makefile 2001/04/25 22:51:43 1.65
+++ Makefile 2001/05/12 07:26:19
@@ -48,6 +48,9 @@
SUBDIR+= ports
SUBDIR+= doc
.endif
+.if defined(RELNOTES)
+SUBDIR+= relnotes
+.endif
# These *must* be listed after the "doc" subdir, as they create symlinks
# in to it.
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010512073025.BC6243E0B>