Date: Tue, 26 Mar 2002 22:30:08 +0000 From: Hiten Pandya <hiten@uk.FreeBSD.org> To: keramida@FreeBSD.org Cc: doc@FreeBSD.org Subject: Re: Fixing &entity stuff in doc/ Message-ID: <20020326223008.A35755@hpdi.ath.cx>
next in thread | raw e-mail | index | archive | help
--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 > <http://people.FreeBSD.org/~keramida/diff/entities.diff>. 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 -- <!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN= ">=20 %authors <!-- it has to be %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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020326223008.A35755>