From owner-freebsd-doc@FreeBSD.ORG Sun Nov 16 06:54:53 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4D79016A4CE; Sun, 16 Nov 2003 06:54:53 -0800 (PST) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8706143F93; Sun, 16 Nov 2003 06:54:51 -0800 (PST) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 6F13F10BF8E; Sun, 16 Nov 2003 15:54:50 +0100 (CET) Date: Sun, 16 Nov 2003 15:54:50 +0100 From: "Simon L. Nielsen" To: Hiroki Sato Message-ID: <20031116145448.GC402@arthur.nitro.dk> References: <20031115211339.GB20162@electra.cse.Buffalo.EDU> <20031116.090904.35667861.hrs@eos.ocn.ne.jp> <87124995263.20031116120847@alexdupre.com> <20031116.221410.106767692.hrs@eos.ocn.ne.jp> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="1sNVjLsmu1MXqwQ/" Content-Disposition: inline In-Reply-To: <20031116.221410.106767692.hrs@eos.ocn.ne.jp> User-Agent: Mutt/1.5.5.1i cc: freebsd-doc@FreeBSD.org Subject: Re: Site lists in the Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 16 Nov 2003 14:54:53 -0000 --1sNVjLsmu1MXqwQ/ Content-Type: multipart/mixed; boundary="2JFBq9zoW8cOFH7v" Content-Disposition: inline --2JFBq9zoW8cOFH7v Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.11.16 22:14:10 +0900, Hiroki Sato wrote: > I think I'll commit a patch[*], which is for moving lists of FreeBSD > mirror sites into doc/share/sgml/mirrors.xml, and generating lists > used in index.html and handbook from the file dynamically. This should > make maintenance easier for the maintainers and the translation teams. >=20 > Any objections or comments? I think it's a great idea, but it does mean that doc/ is now always required to build www/. I think there should be an explicit dependency =66rom index.html to the mirror xml file, like the attached patch so make(1) will fail instead of generating an empty mirror dropdown. I don't think it is a big problem that www/ depend on doc/, since most people will have doc/ checked out anyway to build the documentation as part of the web build. This also allows us to reduce the amount of duplicate meta information in doc/ and www/, at some later point. Should't it be in share/xml or something like that, since it's not really sgml? (It's not something I feel strongly about) A few very minor things, there are some end-of-line whitespace and some spaces that IMO should be tabs. Should be simple to see in the attached patches. Nice work! --=20 Simon L. Nielsen FreeBSD Documentation Team --2JFBq9zoW8cOFH7v Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="www-makefile-mirrordepend.patch" Content-Transfer-Encoding: quoted-printable Index: Makefile =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/www/en/Makefile,v retrieving revision 1.99 diff -u -r1.99 Makefile --- Makefile 29 Oct 2003 20:42:50 -0000 1.99 +++ Makefile 16 Nov 2003 14:11:44 -0000 @@ -91,7 +91,7 @@ DATA+=3D index.html CLEANFILES+=3D index.html =20 -index.html: index.xsl news/news.xml news/press.xml includes.xsl news/inclu= des.xsl security/advisories.xml +index.html: index.xsl news/news.xml news/press.xml includes.xsl news/inclu= des.xsl security/advisories.xml ../../doc/share/sgml/mirrors.xml ${XSLTPROC} ${XSLTPROCOPTS} -o ${.TARGET} \ ${.CURDIR}/index.xsl ${.CURDIR}/news/news.xml .if !defined(NO_TIDY) --2JFBq9zoW8cOFH7v Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="index.xsl-tab.patch" Content-Transfer-Encoding: quoted-printable --- index.xsl.orig Sun Nov 16 15:42:56 2003 +++ index.xsl Sun Nov 16 15:43:09 2003 @@ -50,35 +50,35 @@ which are not mirrored should be listed in support.sgml. --> =20 - - + + - - + + + + + + - + + - - + + + + + + + + + + + =09 --2JFBq9zoW8cOFH7v Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="mirrors.xml-eolwhitespace.patch" Content-Transfer-Encoding: quoted-printable --- mirrors.xml.orig Sun Nov 16 15:40:22 2003 +++ mirrors.xml Sun Nov 16 15:41:52 2003 @@ -554,9 +554,9 @@ Ukraine http://www.ua.FreeBSD.org/ - http://www2.ua.FreeBSD.org/=20 - http://www5.ua.FreeBSD.org/=20 - http://www4.ua.FreeBSD.org/=20 + http://www2.ua.FreeBSD.org/ + http://www5.ua.FreeBSD.org/ + http://www4.ua.FreeBSD.org/ ftp://ftp.ua.FreeBSD.org/pub/FreeBSD/ ftp://ftp2.ua.FreeBSD.org/pub/FreeBSD/ ftp://ftp3.ua.FreeBSD.org/pub/FreeBSD/ --2JFBq9zoW8cOFH7v Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="mirrors.xsl-eolwhitespace-tab.patch" Content-Transfer-Encoding: quoted-printable --- mirrors.xsl.orig Sun Nov 16 15:40:27 2003 +++ mirrors.xsl Sun Nov 16 15:44:29 2003 @@ -2,54 +2,54 @@ =20 - =20 + + omit-xml-declaration=3D"yes" + indent=3D"yes"/> =20 - + - . - , + . + , =20 - - - + + + =20 - - In case of problems, please contact the hostmaster - for this domain.= - - =20 - - - - - - - - - - - - - - - - - =20 + + In case of problems, please contact the hostmaster + for this domain. + + + + + + + + + + + + + + + + + + + - + --2JFBq9zoW8cOFH7v-- --1sNVjLsmu1MXqwQ/ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/t4+4h9pcDSc1mlERAjVnAJ9j0Jztk5cO1PSPtvBx6nKcjCgBxQCcDMNU Z+Kh444KKLvSykB3qmY6Yes= =CgOf -----END PGP SIGNATURE----- --1sNVjLsmu1MXqwQ/--