d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Recommend installing additional port documents to ${PREFIX}/share/doc,

Browse Source 
conditional to ${NOPORTDOCS} (commented out by default in /etc/make.conf).
This commit is contained in:
asami 1996-03-06 09:45:04 +00:00
parent 013d83681a
commit 680a50eedd
1 changed files with 34 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
share/doc/handbook/porting.sgml
View File

@ -1,4 +1,4 @@
<!-- $Id: porting.sgml,v 1.13 1996/01/31 14:26:13 mpp Exp $ -->
<!-- $Id: porting.sgml,v 1.14 1996/03/06 09:04:43 asami Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect1><heading>Porting an existing piece of free software<label id="porting"></heading>
@ -156,7 +156,7 @@ The pattern is the year followed by the month.
# Date created: 5 December 1994
# Whom: asami
#
# $Id: porting.sgml,v 1.13 1996/01/31 14:26:13 mpp Exp $
# $Id: porting.sgml,v 1.14 1996/03/06 09:04:43 asami Exp $
#
DISTNAME= oneko-1.1b
@ -759,6 +759,37 @@ FETCH_DEPENDS= ncftp2:${PORTSDIR}/net/ncftp2
to check whether the binary is stripped or not. If it
doesn't say `not stripped', it is stripped.
<sect3>
<heading>Install additional documentation</heading>
<p>If your software has some documentation other than the
standard man and info pages that you think is useful for the
user, install it under <tt>&dollar;{PREFIX}/share/doc</tt>.
This can be done, like the previous item, in the
<tt>post-install</tt> target.
<p>Create a new directory for your port. The directory name
should reflect what the port is. This usually means
<tt>&dollar;{PKGNAME}</tt> minus the version part. However,
if you think the user might want different versions of the
port to be installed at the same time (e.g., tcl/tk), you
can use the whole <tt>&dollar;{PKGNAME}</tt>.
<p>Make the installation dependent to the variable
<tt>NOPORTDOCS</tt> so that users can disable it in
<tt>/etc/make.conf</tt>, like this:
<tscreen><verb>
post-install:
.if !defined(NOPORTDOCS)
mkdir -p ${PREFIX}/share/doc/xv
cp ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv
.endif
</verb></tscreen>
<p>Don't forget to add them to <tt>pkg/PLIST</tt> too! (Don't
worry about <tt>NOPORTDOCS</tt> here; there is currently no
way for the packages to read variables from
<tt>/etc/make.conf</tt>.)
<sect3>
<heading>Custom utilities</heading>
<p>Don't rely on custom utilities in your local configure
@ -905,7 +936,7 @@ lib/libtcl.so.7.3
person who wrote this Makefile]
# Whom: Satoshi Asami <asami@FreeBSD.ORG>
#
# $Id: porting.sgml,v 1.13 1996/01/31 14:26:13 mpp Exp $
# $Id: porting.sgml,v 1.14 1996/03/06 09:04:43 asami Exp $
[ ^^^^ don't worry about this...it will be automatically filled in by CVS when
it is committed to our repository]
#