Page MenuHomeFreeBSD
Files F135842219

D11523.id30795.diff
No OneTemporary
Actions

D11523.id30795.diff
View Options

Index: en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
@@ -49,11 +49,12 @@
[section for distributed patches -- can be empty]
PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz
+PATCH_DIST_STRIP= -p1 <co xml:id="co-patch_dist_strip"/>
[maintainer; *mandatory*! This is the person who is volunteering to
handle port updates, build breakages, and to whom a users can direct
questions and bug reports. To keep the quality of the Ports Collection
- as high as possible, we no longer accept new ports that are assigned to
+ as high as possible, we do not accept new ports that are assigned to
"ports@FreeBSD.org".]
MAINTAINER= asami@FreeBSD.org
COMMENT= DVI Previewer for the X Window System
@@ -65,23 +66,34 @@
[dependencies -- can be empty]
RUN_DEPENDS= gs:print/ghostscript
-[this section is for other standard bsd.port.mk variables that do not
+[If it requires GNU make, not /usr/bin/make, to build...]
+USES= gmake
+[If it is an X application and requires "xmkmf -a" to be run...]
+USES= imake
+[If the source is obtained from github, remove MASTER_SITE* and...]
+USE_GITHUB= yes
+GH_ACCOUNT= example
+
+[this section is for other standard bsd.port.mk variables that do not]
belong to any of the above]
[If it asks questions during configure, build, install...]
IS_INTERACTIVE= yes
[If it extracts to a directory other than ${DISTNAME}...]
WRKSRC= ${WRKDIR}/xdvi-new
-[If the distributed patches were not made relative to ${WRKSRC},
- this may need to be tweaked]
-PATCH_DIST_STRIP= -p1
[If it requires a "configure" script generated by GNU autoconf to be run]
GNU_CONFIGURE= yes
-[If it requires GNU make, not /usr/bin/make, to build...]
-USES= gmake
-[If it is an X application and requires "xmkmf -a" to be run...]
-USES= imake
[et cetera.]
+[If it requires options, this section is for options]
+OPTIONS_DEFINE= DOCS EXAMPLES FOO
+OPTIONS_DEFAULT= FOO
+[If options will change the files in plist]
+OPTIONS_SUB=yes
+
+FOO_DESC= Enable foo support
+
+FOO_CONFIGURE_ENABLE= foo
+
[non-standard variables to be used in the rules below]
MY_FAVORITE_RESPONSE= "yeah, right"
@@ -97,8 +109,16 @@
[and then the epilogue]
-.include &lt;bsd.port.mk&gt;</programlisting>
+.include &lt;bsd.port.mk&gt;
+ <calloutlist>
+ <callout arearefs="co-patch-dist-strip">
+ <para>If the distributed patches were not made relative to
+ ${WRKSRC}, this may need to be tweaked.<para>
+ </callout>
+ </calloutlist>
+ </programlisting>
+
<sect1 xml:id="porting-samplem-order">
<title>Order of Variables in Port Makefiles</title>
@@ -472,6 +492,20 @@
always put the
<varname>GH_<replaceable>*</replaceable></varname> variables
right after it.</para>
+ </sect2>
+
+ <sect2 xml:id="porting-samplem-uses">
+ <title>Standard <filename>bsd.port.mk</filename> Variables</title>
+
+ <para>This section block is for variables that can be defined in
+ <filename>bsd.port.mk</filename> that do not belong in any
+ of the previous section blocks.</para>
+
+ <para>Order is not important, however try to keep similar variables together.
+ For example uid and gid variables <varname>USERS</varname> and <varname>GROUPS</varname>.
+ Configuration variables <varname>CONFIGURE_</varname><replaceable>*</replaceable> and
+ <replaceable>*</replaceable> <varname>_CONFIGURE</varname>. List of files, and directories
+ <varname>PORTDOCS</varname> <varname>PORTEXAMPLES</varname> and <varname>PORTDATA</varname>.</para>
</sect2>
<sect2 xml:id="porting-samplem-options">

File Metadata

Mime Type
text/plain
Expires
Fri, Nov 14, 10:33 AM (12 h, 37 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
25285425
Default Alt Text
D11523.id30795.diff (3 KB)

Event Timeline