Date: Sat, 22 Mar 2003 23:53:05 +0200 From: Giorgos Keramidas <keramida@FreeBSD.org> To: freebsd-doc@FreeBSD.org Cc: re@FreeBSD.org Subject: ulink elements and URL duplication in the docs Message-ID: <20030322215305.GB57850@gothmog.gr>
index | next in thread | raw e-mail
[-- Attachment #1 --] The <ulink> element in SGML doesn't need to have any content apart from a URL="" 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. <para>See <ulink URL="http://www.foobar.net/some/long/path/here/">http://www.foobar.net/some/long/path/here/</ulink>; This is equivalent to: <para>See <ulink URL="http://www.foobar.net/some/long/path/here/"></ulink>; 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. There's a relatively large diff I tested a few moments ago through a full build of doc/ at: http://www.FreeBSD.org/~keramida/diff/_03.ulink.patch Do you all think it's ok to make the changes of that diff? 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? - Giorgos [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+fNtB1g+UGjGGA7YRAu9MAJ0f5D7p2ZY19mi+42l7LmG0UeY+2QCfRrL4 PfiL8JHjFWNNecdvwjfvDME= =rPlK -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030322215305.GB57850>