Date: Thu, 25 May 2006 23:10:50 +0200 From: Pav Lucistnik <pav@FreeBSD.org> To: Walt Pawley <walt@wump.org> Cc: doc@FreeBSD.org Subject: Re: some thoughts on port docs Message-ID: <1148591450.26582.0.camel@ikaros.oook.cz> In-Reply-To: <a05210219c09bbfd293c5@[10.0.0.10]> References: <a05210219c09bbfd293c5@[10.0.0.10]>
next in thread | previous in thread | raw e-mail | index | archive | help
--=-3qHRaaCnk/kR0ROPcha/ Content-Type: text/plain; charset=ISO-8859-2 Content-Transfer-Encoding: quoted-printable Walt Pawley p=ED=B9e v =E8t 25. 05. 2006 v 13:50 -0700: > On the page ... >=20 > <http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefi= le-distfiles.html> >=20 > ... under the subheading ... >=20 > 5.4.2 MASTER_SITES >=20 > ... it says ... >=20 > These variables are defined in /usr/ports/Mk/bsd.sites.mk. > There are new entries added all the time, so make sure to check > the latest version of this file before submitting a port. >=20 > ... which is just fine ... as far as it goes. >=20 > IMHO, telling people to be sure they check something without > telling them how, or at least linking to how, is poor form. I > understand that old hands don't need this but new hands do and > that's largely who good documentation is needed for. Checking means opening /usr/ports/Mk/bsd.sites.mk and scrolling down and back up. What's hard here? > On the page ... >=20 > <http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefi= le-depend.html> >=20 > ... under the subheading ... >=20 > 5.7.1 LIB_DEPENDS >=20 > ... it says ... >=20 > Note: The lib part is a regular expression which is being > looked up in the ldconfig -r output. Values such as intl.[5-7] > and intl are allowed. The first pattern, intl.[5-7], will match > any of: intl.5, intl.6 or intl.7. The second pattern, intl, > will match any version of the intl library. >=20 > ... which, I suspect, is correct enough, I guess, but isn't it > the case that a value for the lib part of intl.[5-7] would also > match things like intlX5 or intl/7? Even if it was true, I prefer intl.[5-7] over intl\.[5-7] in the sake of general readability. --=20 Pav Lucistnik <pav@oook.cz> <pav@FreeBSD.org> May your arrow always find its mark. --=-3qHRaaCnk/kR0ROPcha/ Content-Type: application/pgp-signature; name=signature.asc Content-Description: Toto je =?iso-8859-2?Q?digit=E1ln=EC?= =?ISO-8859-1?Q?_podepsan=E1?= =?iso-8859-2?Q?_=E8=E1st?= =?ISO-8859-1?Q?_zpr=E1vy?= -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.3 (FreeBSD) iD8DBQBEdh1antdYP8FOsoIRAlENAKCMLQZdVafb9iAAK+v+GRjKTV0QKgCgyudA 0qSG+Z59rXcg6v3UgALGH/I= =NwMT -----END PGP SIGNATURE----- --=-3qHRaaCnk/kR0ROPcha/--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1148591450.26582.0.camel>