From owner-freebsd-doc Sat Mar 22 14:46:47 2003 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 7AD1F37B404; Sat, 22 Mar 2003 14:46:45 -0800 (PST) Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id 726A943FA3; Sat, 22 Mar 2003 14:46:44 -0800 (PST) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by sccrmhc03.attbi.com (sccrmhc03) with ESMTP id <20030322224643003004im3ne>; Sat, 22 Mar 2003 22:46:43 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.8/8.12.8) with ESMTP id h2MMkgv5071221; Sat, 22 Mar 2003 14:46:42 -0800 (PST) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.8/8.12.8/Submit) id h2MMkg2O071220; Sat, 22 Mar 2003 14:46:42 -0800 (PST) Date: Sat, 22 Mar 2003 14:46:41 -0800 From: "Bruce A. Mah" To: Giorgos Keramidas Cc: freebsd-doc@FreeBSD.org, re@FreeBSD.org Subject: Re: ulink elements and URL duplication in the docs Message-ID: <20030322224641.GA71175@intruder.bmah.org> References: <20030322215305.GB57850@gothmog.gr> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="M9NhX3UHpAaciwkO" Content-Disposition: inline In-Reply-To: <20030322215305.GB57850@gothmog.gr> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ 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 --M9NhX3UHpAaciwkO Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Giorgos Keramidas wrote: > The element in SGML doesn't need to have any content apart > from a URL=3D"" attribute. There are currently many places where lines > look awful because a long URL is include twice(!) in the running text > of a document, i.e. >=20 > See URL=3D"http://www.foobar.net/some/long/path/here/">http://www.foobar.n= et/some/long/path/here/ >=20 > This is equivalent to: >=20 > See URL=3D"http://www.foobar.net/some/long/path/here/"> >=20 > which contains the URL only once, saving some (precious most of the > time) horizontal space and reducing the potential for mistakes when > someone edits the URL in one of those places and forgets the other, or > makes a mistake while editing the same text twice. IMHO, the second reason is more important than the first. > There's a relatively large diff I tested a few moments ago through a > full build of doc/ at: >=20 > http://www.FreeBSD.org/~keramida/diff/_03.ulink.patch >=20 > Do you all think it's ok to make the changes of that diff? Hmmm. I only perused the diff, but this looks pretty good to me. Could you do a quick check to see if our print stylesheets generate sane output as well? (I think they do, but just to be sure...) > If yes, is it ok to do it now, or should I just wait for a date after > 4.8-RELEASE to avoid making large changes at this point in time? I tagged the doc/ tree a couple days ago...I think at this point it'd probably be better to wait. It'll probably just be a few more days. Thanks! Bruce. --M9NhX3UHpAaciwkO Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+fOfR2MoxcVugUsMRAprGAJ4wPZwvFLTMpvSO6D4d9Flvx+SIRACg+OaD A8IHqQiRQ6vj0chrUOSRX7I= =ocgg -----END PGP SIGNATURE----- --M9NhX3UHpAaciwkO-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message