From owner-freebsd-doc Tue Mar 26 14:33:39 2002 Delivered-To: freebsd-doc@freebsd.org Received: from hpdi.ath.cx (pc2-nthf5-0-cust237.not.cable.ntl.com [80.4.35.237]) by hub.freebsd.org (Postfix) with ESMTP id 7078337B400; Tue, 26 Mar 2002 14:33:25 -0800 (PST) Received: from hpdi.ath.cx (localhost [127.0.0.1]) by hpdi.ath.cx (8.12.2/8.12.2) with ESMTP id g2QMU92S035776; Tue, 26 Mar 2002 22:30:09 GMT (envelope-from hitenp@hpdi.ath.cx) Received: (from hitenp@localhost) by hpdi.ath.cx (8.12.2/8.12.2/Submit) id g2QMU84A035775; Tue, 26 Mar 2002 22:30:08 GMT Date: Tue, 26 Mar 2002 22:30:08 +0000 From: Hiten Pandya To: keramida@FreeBSD.org Cc: doc@FreeBSD.org Subject: Re: Fixing &entity stuff in doc/ Message-ID: <20020326223008.A35755@hpdi.ath.cx> Reply-To: hiten@uk.FreeBSD.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="T4sUOijqQbZv57TR" Content-Disposition: inline User-Agent: Mutt/1.2.5i X-Operating-System: FreeBSD hpdi.ath.cx 5.0-CURRENT FreeBSD 5.0-CURRENT Organisation: The FreeBSD Project X-PGP-Key: http://www.pittgoth.com/~hiten/pubkey.asc Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --T4sUOijqQbZv57TR Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable > I've run the following to a fairly recent copy of the doc tree: > > % find . -type f -name '*.sgml' |\ > xargs grep '&[^[:space:];&][^[:space:];]*$' | grep -v '&$' > % find . -type f -name '*.sgml' |\ > xargs grep '&[^[:space:];&][^[:space:];]*[[:space:]<]' |\ > grep -v '&[[: space:]]' | grep -v '[[:space:]]&&[[:space:]]' > > Saved the output to a file, and started fixing entities that did not end > with the usual ';' character. I'm running a full doc build now with: > > % make FORMATS=3D"html-split" > > but, just in case you have comments to make, the patch is available at > . Anyone with mo= re > sgml-foo than me that can enlighten me why "make lint" doesn't catch these > (admittedly minor) sgml typos? I have seen the same type of weirdness with parameter entities, especially the ones which include the Authors entities in the following manner: -- example -- =20 %authors -- example -- One such example is the handbook. Although I didn't report this on the list because there are no errors reported, but I think according to the SGML EBNF syntax, it is the parameter entity followed by a semi-colon. :) Thanks, Regards, --=20 Hiten Pandya http://jfs4bsd.sf.net - JFS for FreeBSD (JFS4BSD) http://www.FreeBSD.org - The Power to Serve Public Key: http://www.pittgoth.com/~hiten/pubkey.asc --- 4FB9 C4A9 4925 CF97 9BF3 ADDA 861D 5DBD E4E3 03C3 --- --T4sUOijqQbZv57TR Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iD8DBQE8oPZwhh1dveTjA8MRArjiAKCInQSvgl3PlsICCpsblyEwm42Z3gCg2PyE czfe9HCfkzuHrcBH+kDlvDg= =dYZ3 -----END PGP SIGNATURE----- --T4sUOijqQbZv57TR-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message