Date: Sun, 26 Aug 2001 16:10:38 +0000 From: "Mario Sergio Fujikawa Ferreira" <lioux@uol.com.br> To: Tom Hukins <tom@FreeBSD.ORG> Cc: Pete Fritchman <petef@databits.net>, freebsd-ports@FreeBSD.ORG, doc@FreeBSD.ORG Subject: Re: NOPORTDOCS and make package Message-ID: <20010826161038.A53859@exxodus.fedaykin.here> In-Reply-To: <20010826172808.A63257@eborcom.com>; from tom@FreeBSD.ORG on Sun, Aug 26, 2001 at 05:27:46PM %2B0100 References: <20010824121353.A1047@shall.anarcat.dyndns.org> <20010824193300.C532@ringworld.oblivion.bg> <20010826161858.A62947@eborcom.com> <20010826120304.A94436@databits.net> <20010826172808.A63257@eborcom.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Aug 26, 2001 at 05:27:46PM +0100, Tom Hukins wrote:
> On Sun, Aug 26, 2001 at 12:03:04PM -0400, Pete Fritchman wrote:
> > ++ 26/08/01 16:18 +0100 - Tom Hukins:
> > | + <para>Documentation should be included in
> > | + <filename>pkg-plist</filename> with the
> > | + <literal>%%NOPORTDOCS%%</literal> prefix, for
> > ^^^^^^^^^^^^^^
> > %%PORTDOCS%%
>
> Thanks!
>
> > | + <programlisting>%%PORTDOCS%%share/doc/pure-ftpd/AUTHORS
> > | +%%PORTDOCS%%share/doc/pure-ftpd/CONTACT</programlisting>
> >
> > Maybe something should be mentioned about prefixing @dirrm's with this
> > too?
>
> I think that's a good idea. I'm attaching an updated patch which
> deals with these issues.
I should have spoken sooner but the wording should be
something like:
<para>Inside <filename>pkg-plist</filename>, all documentation related
lines should be prefixed with <literal>%%PORTDOCS%%</literal>
which makes them conditional to <literal>NOPORTDOCS</literal>
variable, for example:</para>
<programlisting>%%PORTDOCS%%share/doc/pure-ftpd/AUTHORS
%%PORTDOCS%%share/doc/pure-ftpd/CONTACT
%%PORTDOCS%%@dirrm share/doc/pure-ftpd
%%PORTDOCS%%@unexec rmdir share/doc 2>/dev/null || true</programlisting>
Needs help in the wording but the idea is there.
Regards,
> --- book.sgml.was Sun Aug 26 07:25:23 2001
> +++ book.sgml Sun Aug 26 17:25:12 2001
> @@ -3251,10 +3251,13 @@
> ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv
> .endif</programlisting>
>
> - <para>Do not forget to add them to <filename>pkg-plist</filename> too.
> - (Do not worry about <makevar>NOPORTDOCS</makevar> here; there is
> - currently no way for the packages to read variables from
> - <filename>/etc/make.conf</filename>.)</para>
> + <para>Documentation should be included in
> + <filename>pkg-plist</filename> with the
> + <literal>%%PORTDOCS%%</literal> prefix, for example:</para>
> +
> + <programlisting>%%PORTDOCS%%share/doc/pure-ftpd/AUTHORS
> +%%PORTDOCS%%share/doc/pure-ftpd/CONTACT
> +%%PORTDOCS%%@dirrm share/doc/pure-ftpd</programlisting>
>
> <para>You can also use the <filename>pkg-message</filename> file to
> display messages upon installation. See the <link
--
Mario S F Ferreira - UnB - Brazil - "I guess this is a signature."
lioux at ( freebsd dot org | linf dot unb dot br )
flames to beloved devnull@someotherworldbeloworabove.org
feature, n: a documented bug | bug, n: an undocumented feature
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?20010826161038.A53859>