Date: Wed, 21 Sep 2005 11:28:58 +0200 From: Simon Barner <barner@FreeBSD.org> To: Lars Thegler <lth@FreeBSD.org> Cc: cvs-ports@FreeBSD.org, Doug Barton <dougb@FreeBSD.org>, Erwin Lansing <erwin@FreeBSD.org>, cvs-all@FreeBSD.org, ports-committers@FreeBSD.org Subject: Deprecating the signature at the end of pkg-descr (was: Re: cvs commit...) Message-ID: <20050921092858.GA19214@zi025.glhnet.mhn.de> In-Reply-To: <43311976.4070608@FreeBSD.org> References: <200509201420.j8KEKYa6066950@repoman.freebsd.org> <433100DE.2040901@FreeBSD.org> <43310DF2.8010100@FreeBSD.org> <43310F88.3040702@FreeBSD.org> <43311976.4070608@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--KdquIMZPjGJQvRdI Content-Type: multipart/mixed; boundary="L6iaP+gRLNZHKoI4" Content-Disposition: inline --L6iaP+gRLNZHKoI4 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Lars Thegler wrote: > So in either case, it seems the 'signature' in pkg-descr is redundant.=20 > Either it reflects the creator's name, duplicating the comment section,= =20 > or it reflects the maintainer, duplicating the MAINTAINER=3D line. Section 5.5 says that the signature in pkg-descr is intended to keep the port creators real name, but that could be put into the comment section at the beginning of the Makefile (and in fact, that is what many/most people do). But I wonder where a somebody who agrees to take over maintainershipf of a new port could put his realname? >=20 > I wonder what the rationale for the 'recommendation' in 3.2.1 was? Anyone? I don't know, but I'd suggest getting rid of the signature all together, before starting a huge bikeshed. My suggestion is to update the porters' handbook in order to document the new policy, and send a small heads-up to freebsd-ports (patch attached). I certainly don't propose to change all existing ports at once because is would be an unnecessary repo churn, but perhaps after a maintainer chang= e, as Pav suggested. My EUR 0.02, Simon --L6iaP+gRLNZHKoI4 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="porters-handbook.deprecate-signature.diff" Content-Transfer-Encoding: quoted-printable Index: en_US.ISO8859-1/books/porters-handbook/book.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.614 diff -u -r1.614 book.sgml --- en_US.ISO8859-1/books/porters-handbook/book.sgml 16 Sep 2005 16:13:33 -= 0000 1.614 +++ en_US.ISO8859-1/books/porters-handbook/book.sgml 21 Sep 2005 09:27:10 -= 0000 @@ -165,18 +165,19 @@ correctly.</para> </note> =20 - <para>It is recommended that you sign your name at the end of this - file, as in:</para> + <note> + <para>While previoulsly recommended, adding a signature at the end + of the <filename>pkg-descr</filename> is + <emphasis>deprecated</emphasis>. This is illustrated in the + following example:</para> + </note> =20 <programlisting>This is a port of oneko, in which a cat chases a poor m= ouse all over the screen. : (etc.) =20 -WWW: http://www.oneko.org/ - -- Satoshi -asami@cs.berkeley.edu</programlisting> +WWW: http://www.oneko.org/</programlisting>; </sect2> =20 <sect2> @@ -3006,8 +3007,7 @@ The format used should be <literal>user@hostname.domain</literal>. Please do not include any descriptive text such as your real name in this entry—that merely confuses - <filename>bsd.port.mk</filename>. Instead, put that information - into your <filename>pkg-descr</filename>.</para> + <filename>bsd.port.mk</filename>.</para> =20 <para>For a detailed description of the responsibilities of maintainers, refer to the <ulink url=3D"&url.books.developers-handbook;/policies.htm= l#POLICIES-MAINTAINER">MAINTAINER on --L6iaP+gRLNZHKoI4-- --KdquIMZPjGJQvRdI Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDMSfaCkn+/eutqCoRAgPmAJ9H2FIAoKDi0h3Hy0zk7ECpuILp5QCfawDn /UbMQ0Ah9rLuUTE87q3ie/Y= =iniP -----END PGP SIGNATURE----- --KdquIMZPjGJQvRdI--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050921092858.GA19214>