Changeset 27989 for trunk/doc


Ignore:
Timestamp:
Aug 17, 2007, 6:21:53 AM (12 years ago)
Author:
markd@…
Message:

Extensive changes to the keywords reference section. Integrate material from the legacy guide.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/guide/new/xml/portfileref.xml

    r27950 r27989  
    152152
    153153      <para>Library dependencies are needed both at build time (for headers
    154       and libraries to link against) and at run time (to provide necessary
    155       code).</para>
     154      and libraries to link against) and at run time.</para>
    156155
    157156      <programlisting>depends_lib         port:rrdtool</programlisting>
     
    161160      <title>depends_build</title>
    162161
    163       <para>Build dependencies are only needed when software is compiled. They
    164       are not needed at all once the software is compiled and
    165       installed.</para>
     162      <para>Build dependencies are needed when software is compiled, but not
     163      needed at all once the software is compiled and installed.</para>
    166164
    167165      <programlisting>depends_build       port:gcc42</programlisting>
     
    172170
    173171      <para>Run dependencies are needed when the software is run, but not to
    174       compile the software.</para>
     172      compile it.</para>
    175173
    176174      <programlisting>depends_run         port:apache2</programlisting>
     
    450448            </listitem>
    451449          </varlistentry>
    452 
    453           <varlistentry>
    454             <term></term>
    455 
    456             <listitem>
    457               <para></para>
    458             </listitem>
    459           </varlistentry>
    460 
    461           <varlistentry>
    462             <term></term>
    463 
    464             <listitem>
    465               <para></para>
    466             </listitem>
    467           </varlistentry>
    468 
    469           <varlistentry>
    470             <term></term>
    471 
    472             <listitem>
    473               <para></para>
    474             </listitem>
    475           </varlistentry>
    476450        </variablelist></para>
    477451    </section>
     
    786760      <title>Global Keywords</title>
    787761
    788       <para>Global keywords.</para>
     762      <para>The list of global keywords.</para>
    789763
    790764      <variablelist>
     
    797771            MacPorts.</para>
    798772
    799             <para><userinput>PortSystem 1.0</userinput></para>
     773            <programlisting>PortSystem   1.0</programlisting>
    800774          </listitem>
    801775        </varlistentry>
     
    807781            <para>The name of the Port; it should be lowercase.</para>
    808782
    809             <para><userinput>name foo</userinput></para>
     783            <programlisting>name         foo</programlisting>
    810784          </listitem>
    811785        </varlistentry>
     
    817791            <para>The version of the ported software.</para>
    818792
    819             <para><userinput>version 1.23.45</userinput></para>
     793            <programlisting>version      1.23.45</programlisting>
    820794          </listitem>
    821795        </varlistentry>
     
    830804            when the port is updated to a newer version.</para>
    831805
    832             <para><userinput>revision 1</userinput></para>
     806            <programlisting>revision     1</programlisting>
    833807          </listitem>
    834808        </varlistentry>
     
    843817            selected.</para>
    844818
    845             <para><userinput>categories net security</userinput></para>
     819            <programlisting>categories     net security</programlisting>
    846820          </listitem>
    847821        </varlistentry>
     
    853827            <para>The email address(es) of the Portfile maintainer(s).</para>
    854828
    855             <para><userinput>maintainers openmaintainer@macports.org
    856             jdoe@macports.org</userinput></para>
     829            <programlisting>maintainers    openmaintainer@macports.org jdoe@macports.org</programlisting>
    857830          </listitem>
    858831        </varlistentry>
     
    864837            <para>A one-sentence description of the ported software.</para>
    865838
    866             <para><userinput>description A classic shooter arcade
    867             game.</userinput></para>
     839            <programlisting>description    A clasic shooter arcade game.</programlisting>
    868840          </listitem>
    869841        </varlistentry>
     
    876848            with escaped newlines.</para>
    877849
    878             <programlisting>description     A classic shooter arcade game derived from \
    879                 the game alien-munchers.  Not suitable for \
    880                 children under two years old.      </programlisting>
     850            <programlisting>description    A classic shooter arcade game derived from \
     851               the game alien-munchers.  Not suitable for \
     852               children under two years old.      </programlisting>
    881853          </listitem>
    882854        </varlistentry>
     
    888860            <para>Port application's homepage.</para>
    889861
    890             <para><userinput>homepage
    891             http://www.somesite.org/apps</userinput></para>
     862            <programlisting>homepage       http://www.somesite.org/apps</programlisting>
    892863          </listitem>
    893864        </varlistentry>
     
    899870            <para>The platforms on which the port has been tested.</para>
    900871
    901             <para><userinput>platforms darwin freebsd</userinput></para>
     872            <programlisting>platforms      darwin freebsd</programlisting>
    902873          </listitem>
    903874        </varlistentry>
     
    907878
    908879          <listitem>
    909             <para></para>
    910 
    911             <variablelist>
    912               <varlistentry>
    913                 <term>depends_lib-append</term>
    914 
    915                 <listitem>
    916                   <para></para>
    917                 </listitem>
    918               </varlistentry>
    919             </variablelist>
    920 
    921             <variablelist>
    922               <varlistentry>
    923                 <term>depends_lib-delete</term>
    924 
    925                 <listitem>
    926                   <para></para>
    927                 </listitem>
    928               </varlistentry>
    929             </variablelist>
     880            <para>Library dependencies are needed both at build time (for
     881            headers and libraries to link against) and at run time.</para>
     882
     883            <programlisting>depends_lib     port:rrdtool</programlisting>
     884
     885            <simplelist>
     886              <member>depends_lib-append</member>
     887
     888              <member>depends_lib-delete</member>
     889            </simplelist>
    930890          </listitem>
    931891        </varlistentry>
     
    935895
    936896          <listitem>
    937             <para></para>
    938 
    939             <variablelist>
    940               <varlistentry>
    941                 <term>depends_build-append</term>
    942 
    943                 <listitem>
    944                   <para></para>
    945                 </listitem>
    946               </varlistentry>
    947             </variablelist>
    948 
    949             <variablelist>
    950               <varlistentry>
    951                 <term>depends_build-delete</term>
    952 
    953                 <listitem>
    954                   <para></para>
    955                 </listitem>
    956               </varlistentry>
    957             </variablelist>
     897            <para>Build dependencies are needed when software is compiled, but
     898            not needed at all once the software is compiled and
     899            installed.</para>
     900
     901            <programlisting>depends_build    port:gcc42</programlisting>
     902
     903            <simplelist>
     904              <member>depends_build-append</member>
     905
     906              <member>depends_build-delete</member>
     907            </simplelist>
    958908          </listitem>
    959909        </varlistentry>
     
    963913
    964914          <listitem>
    965             <para></para>
    966 
    967             <variablelist>
    968               <varlistentry>
    969                 <term>depends_run-append</term>
    970 
    971                 <listitem>
    972                   <para></para>
    973                 </listitem>
    974               </varlistentry>
    975             </variablelist>
    976 
    977             <variablelist>
    978               <varlistentry>
    979                 <term>depends_run-delete</term>
    980 
    981                 <listitem>
    982                   <para></para>
    983                 </listitem>
    984               </varlistentry>
    985             </variablelist>
    986           </listitem>
    987         </varlistentry>
    988 
    989         <varlistentry>
    990           <term></term>
    991 
    992           <listitem>
    993             <para></para>
     915            <para>Run dependencies are needed when the software is run, but
     916            not to compile it.</para>
     917
     918            <programlisting>depends_run      port:apache2</programlisting>
     919
     920            <simplelist>
     921              <member>depends_run-append</member>
     922
     923              <member>depends_run-delete</member>
     924            </simplelist>
    994925          </listitem>
    995926        </varlistentry>
     
    1000931      <title>Fetch</title>
    1001932
    1002       <para></para>
     933      <para>Thelist of keywords related to the fetch phase.</para>
    1003934
    1004935      <variablelist>
     
    1014945            ${distname}${extract.suffix} is found.</para>
    1015946
    1016             <programlisting><userinput>master_sites   http://www.somesite.org/files/ \
    1017                http://www.somemirror.org/somesite_org/files/</userinput></programlisting>
     947            <programlisting>master_sites   http://www.somesite.org/files/ \
     948               http://www.somemirror.org/somesite_org/files/</programlisting>
    1018949
    1019950            <para>You may also use mirror sites predefined by MacPorts. Here
    1020951            the sourceforge and gnu mirrors are used.</para>
    1021952
    1022             <programlisting><userinput>master_sites   sourceforge gnu</userinput></programlisting>
    1023 
    1024             <para>When using mirror master_sites, the subdirectory ${name} is
    1025             checked on every mirror. If the mirror subdirectory does not match
    1026             ${name}, then you may specify it using after the mirror separated
    1027             by a colon.</para>
    1028 
    1029             <programlisting><userinput>master_sites   sourceforge:widget \
    1030                gnu:widget</userinput></programlisting>
     953            <programlisting>master_sites   sourceforge gnu</programlisting>
     954
     955            <para>When using mirror master_sites, the subdirectory
     956            <varname>${name}</varname> is checked on every mirror. If the
     957            mirror subdirectory does not match ${name}, then you may specify
     958            it using after the mirror separated by a colon.</para>
     959
     960            <programlisting>master_sites   sourceforge:widget \
     961               gnu:widget</programlisting>
    1031962
    1032963            <para>For ports that must fetch multiple download files from
     
    1036967
    1037968            <para>In the example below, file_one.tar.gz is fetched from
    1038             sourceforge mirrors in subdirectory ${name}; file tagtwo.tar.gz is
    1039             fetched from the gnu mirrors in subdirectory sources.</para>
    1040 
    1041             <programlisting><userinput>distfiles       file_one.tar.gz:tagone \
     969            sourceforge mirrors in subdirectory <varname>${name}</varname>;
     970            file tagtwo.tar.gz is fetched from the gnu mirrors in subdirectory
     971            sources.</para>
     972
     973            <programlisting>distfiles       file_one.tar.gz:tagone \
    1042974                file_two.tar.gz:tagtwo \
    1043975                file_three.tar.gz
    1044976
    1045977master_sites    sourceforge::tagone \
    1046                 gnu:sources:tagtwo</userinput></programlisting>
     978                gnu:sources:tagtwo</programlisting>
    1047979          </listitem>
    1048980        </varlistentry>
     
    1055987            downloaded, where applicable.</para>
    1056988
    1057             <programlisting><userinput>patch_sites    ftp://ftp.patchcityrepo.com/pub/magic/patches</userinput></programlisting>
     989            <programlisting>patch_sites    ftp://ftp.patchcityrepo.com/pub/magic/patches</programlisting>
    1058990          </listitem>
    1059991        </varlistentry>
     
    1063995
    1064996          <listitem>
    1065             <para>The default distname is ${name}-${version}. This keyword is
    1066             used to specify download files that do not meet this standard
    1067             (excluding the extract.suffix).</para>
    1068 
    1069             <para><userinput>distname ${name}</userinput></para>
     997            <para>The default distname is
     998            <varname>${name}-${version}</varname>. This keyword is used to
     999            specify download files that do not meet this standard (excluding
     1000            the extract.suffix).</para>
     1001
     1002            <programlisting>distname     ${name}</programlisting>
    10701003          </listitem>
    10711004        </varlistentry>
     
    10751008
    10761009          <listitem>
    1077             <para>The default distfile name is ${distname}${extract.suffix}.
    1078             This keyword is used when a download file for a port is not
    1079             ${distname}.${extract.suffix} or to used to specify multiple
    1080             download files.</para>
    1081 
    1082             <para><userinput>distfiles ${name}-dev_src.tgz</userinput></para>
     1010            <para>The default distfile name is
     1011            <varname>${distname}${extract.suffix}</varname>. This keyword is
     1012            used when a download file for a port is not
     1013            <varname>${distname}${extract.suffix}</varname> or to used to
     1014            specify multiple download files.</para>
     1015
     1016            <programlisting>distfiles    ${name}-dev_src.tgz</programlisting>
    10831017          </listitem>
    10841018        </varlistentry>
     
    10911025            file suffixes other than .tar.gz.</para>
    10921026
    1093             <para><userinput>extract.suffix .tar.gz</userinput></para>
     1027            <programlisting>extract.suffix   .tar.gz</programlisting>
    10941028          </listitem>
    10951029        </varlistentry>
     
    11081042            </simplelist>
    11091043
    1110             <para><userinput>use_bzip2 yes</userinput></para>
     1044            <programlisting>use_bzip2     yes</programlisting>
    11111045          </listitem>
    11121046        </varlistentry>
     
    11291063            </simplelist>
    11301064
    1131             <para><userinput>use_zip yes</userinput></para>
    1132           </listitem>
    1133         </varlistentry>
    1134 
    1135         <varlistentry>
    1136           <term></term>
    1137 
    1138           <listitem>
    1139             <para></para>
    1140           </listitem>
    1141         </varlistentry>
    1142 
    1143         <varlistentry>
    1144           <term></term>
    1145 
    1146           <listitem>
    1147             <para></para>
    1148           </listitem>
    1149         </varlistentry>
    1150 
    1151         <varlistentry>
    1152           <term></term>
    1153 
    1154           <listitem>
    1155             <para></para>
     1065            <programlisting>use_zip       yes</programlisting>
    11561066          </listitem>
    11571067        </varlistentry>
     
    11621072      <title>Checksum</title>
    11631073
    1164       <para></para>
     1074      <para>The list of keywords related to the checksum phase.</para>
    11651075
    11661076      <variablelist>
     
    11711081            <para>Checksum(s) of the distribution files.</para>
    11721082
    1173             <para><userinput>checksums md5
    1174             65b89365a65dcad71d4402b48</userinput></para>
     1083            <programlisting>checksums     md5 65b89365a65dcad71d4402b48</programlisting>
    11751084
    11761085            <para>To download multiple files for a port, you must associate
     
    11821091        </varlistentry>
    11831092      </variablelist>
     1093    </section>
     1094
     1095    <section>
     1096      <title>Extract</title>
     1097
     1098      <para>The list of keywords related to the extract phase.</para>
    11841099
    11851100      <variablelist>
    11861101        <varlistentry>
    1187           <term></term>
    1188 
    1189           <listitem>
    1190             <para></para>
     1102          <term>extract.only</term>
     1103
     1104          <listitem>
     1105            <para>List of files to extract into
     1106            <varname>${worksrcpath}</varname>; the default is
     1107            <varname>${distfiles}</varname>. Only use if default extract
     1108            behavior is not correct for your port.</para>
     1109
     1110            <programlisting>extract.only     foo.tar.gz bar.tar.gz</programlisting>
     1111
     1112            <simplelist>
     1113              <member>extract.only-append</member>
     1114
     1115              <member>extract.only-delete</member>
     1116            </simplelist>
     1117          </listitem>
     1118        </varlistentry>
     1119
     1120        <varlistentry>
     1121          <term>extract.cmd</term>
     1122
     1123          <listitem>
     1124            <para>Command to perform extraction; the default is "gzip".</para>
     1125
     1126            <programlisting>extract.cmd     gunzip</programlisting>
     1127          </listitem>
     1128        </varlistentry>
     1129
     1130        <varlistentry>
     1131          <term>extract.pre_args</term>
     1132
     1133          <listitem>
     1134            <para>Arguments added to extract.cmd before a file name; the
     1135            default is "-dc".</para>
     1136
     1137            <programlisting>extract.pre_args    -cd</programlisting>
     1138
     1139            <simplelist>
     1140              <member>extract.pre_args-append</member>
     1141
     1142              <member>extract.pre_args-delete</member>
     1143            </simplelist>
     1144          </listitem>
     1145        </varlistentry>
     1146
     1147        <varlistentry>
     1148          <term>extract.args</term>
     1149
     1150          <listitem>
     1151            <para>Arguments to extract.cmd; the default is
     1152            <varname>${distpath}/${distfile}</varname>.</para>
     1153
     1154            <programlisting>extract.args      </programlisting>
     1155
     1156            <simplelist>
     1157              <member>extract.args-append</member>
     1158
     1159              <member>extract.args-delete</member>
     1160            </simplelist>
     1161          </listitem>
     1162        </varlistentry>
     1163
     1164        <varlistentry>
     1165          <term>extract.post_args</term>
     1166
     1167          <listitem>
     1168            <para>Arguments added to extract.cmd after a file name; the
     1169            default is "| tar -xf".</para>
     1170
     1171            <programlisting>extract.post_args     "| tar -xf - --exclude 'CVS'"</programlisting>
     1172
     1173            <simplelist>
     1174              <member>extract.post_args-append</member>
     1175
     1176              <member>extract.post_args-delete</member>
     1177            </simplelist>
    11911178          </listitem>
    11921179        </varlistentry>
     
    11951182
    11961183    <section>
    1197       <title>Extract</title>
    1198 
    1199       <para></para>
     1184      <title>Patch</title>
     1185
     1186      <para>The list of keywords related to the patch phase.</para>
     1187
     1188      <variablelist>
     1189        <varlistentry>
     1190          <term>patchfiles</term>
     1191
     1192          <listitem>
     1193            <para>Specify patch files to be applied for a port.</para>
     1194
     1195            <programlisting>patchfiles     patch-Makefile.in patch-source.c</programlisting>
     1196
     1197            <simplelist>
     1198              <member>patchfiles-append</member>
     1199
     1200              <member>patchfiles-delete</member>
     1201            </simplelist>
     1202          </listitem>
     1203        </varlistentry>
     1204      </variablelist>
    12001205    </section>
    12011206
     
    12031208      <title>Configure</title>
    12041209
     1210      <para>The list of keywords related to the configure phase.</para>
     1211
    12051212      <para>MacPorts base sets some important default configure options, so
    1206       you must be careful not to overwrite them with your Portfile keywords;
    1207       for this reason you should use the -append version of configure
    1208       keywords. For example, MacPorts base sets default
     1213      should use the -append version of most configure keywords so you don't
     1214      overwrite them. For example, MacPorts base sets default
    12091215      <literal>configure.ldflags</literal> so you should always use
    12101216      <literal>configure.cflags-append</literal> to set additional CFLAGS in
     
    12131219      <variablelist>
    12141220        <varlistentry>
     1221          <term>configure.env</term>
     1222
     1223          <listitem>
     1224            <para>Set environment variables for configure.</para>
     1225
     1226            <programlisting>configure.env     CFLAGS=-I${prefix}/include</programlisting>
     1227
     1228            <simplelist>
     1229              <member>configure.env-append</member>
     1230
     1231              <member>configure.env-delete</member>
     1232            </simplelist>
     1233          </listitem>
     1234        </varlistentry>
     1235
     1236        <varlistentry>
     1237          <term>configure.pre_args</term>
     1238
     1239          <listitem>
     1240            <para>Arguments added to configure.cmd before
     1241            <varname>${configure.args}</varname>; the default is
     1242            --prefix=${prefix}.</para>
     1243
     1244            <programlisting>configure.pre_args     --prefix=${prefix}/apache2</programlisting>
     1245
     1246            <simplelist>
     1247              <member>configure.pre_args-append</member>
     1248
     1249              <member>configure.pre_args-delete</member>
     1250            </simplelist>
     1251          </listitem>
     1252        </varlistentry>
     1253
     1254        <varlistentry>
    12151255          <term>configure.args</term>
    12161256
    12171257          <listitem>
    1218             <para></para>
    1219 
    1220             <variablelist>
    1221               <varlistentry>
    1222                 <term>configure.args-append</term>
    1223 
    1224                 <listitem>
    1225                   <para></para>
    1226                 </listitem>
    1227               </varlistentry>
    1228             </variablelist>
    1229 
    1230             <variablelist>
    1231               <varlistentry>
    1232                 <term>configure.args-delete</term>
    1233 
    1234                 <listitem>
    1235                   <para></para>
    1236                 </listitem>
    1237               </varlistentry>
    1238             </variablelist>
     1258            <para>Arguments to pass to configure.</para>
     1259
     1260            <programlisting>configure.args         --etcdir=${prefix}/etc</programlisting>
     1261
     1262            <simplelist>
     1263              <member>configure.args-append</member>
     1264
     1265              <member>configure.args-delete</member>
     1266            </simplelist>
    12391267          </listitem>
    12401268        </varlistentry>
     
    12441272
    12451273          <listitem>
    1246             <para></para>
    1247 
    1248             <variablelist>
    1249               <varlistentry>
    1250                 <term>configure.cflags-append</term>
    1251 
    1252                 <listitem>
    1253                   <para></para>
    1254                 </listitem>
    1255               </varlistentry>
    1256             </variablelist>
    1257 
    1258             <variablelist>
    1259               <varlistentry>
    1260                 <term>configure.cflags-delete</term>
    1261 
    1262                 <listitem>
    1263                   <para></para>
    1264                 </listitem>
    1265               </varlistentry>
    1266             </variablelist>
     1274            <para>Set CFLAGS compiler flags.</para>
     1275
     1276            <programlisting>configure.cflags      -I/usr/X11R6/include</programlisting>
     1277
     1278            <simplelist>
     1279              <member>configure.cflags-append</member>
     1280
     1281              <member>configure.cflags-delete</member>
     1282            </simplelist>
    12671283          </listitem>
    12681284        </varlistentry>
     
    12721288
    12731289          <listitem>
    1274             <para></para>
    1275 
    1276             <variablelist>
    1277               <varlistentry>
    1278                 <term>configure.ldflags-append</term>
    1279 
    1280                 <listitem>
    1281                   <para></para>
    1282                 </listitem>
    1283               </varlistentry>
    1284             </variablelist>
    1285 
    1286             <variablelist>
    1287               <varlistentry>
    1288                 <term>configure.ldflags-delete</term>
    1289 
    1290                 <listitem>
    1291                   <para></para>
    1292                 </listitem>
    1293               </varlistentry>
    1294             </variablelist>
    1295           </listitem>
    1296         </varlistentry>
    1297 
    1298         <varlistentry>
    1299           <term></term>
    1300 
    1301           <listitem>
    1302             <para></para>
     1290            <para>Set LDFLAGS for the linker.</para>
     1291
     1292            <programlisting>configure.ldflags     -L${prefix}/lib/db44</programlisting>
     1293
     1294            <simplelist>
     1295              <member>configure.ldflags-append</member>
     1296
     1297              <member>configure.ldflags-delete</member>
     1298            </simplelist>
     1299          </listitem>
     1300        </varlistentry>
     1301
     1302        <varlistentry>
     1303          <term>configure.cppflags</term>
     1304
     1305          <listitem>
     1306            <para>Set CPPFLAGS for passing to the C processor.</para>
     1307
     1308            <programlisting>configure.cppflags    -I${prefix}/include/db4</programlisting>
     1309
     1310            <simplelist>
     1311              <member>configure.cppflags-append</member>
     1312
     1313              <member>configure.cppflags-delete</member>
     1314            </simplelist>
    13031315          </listitem>
    13041316        </varlistentry>
    13051317      </variablelist>
    13061318
    1307       <para></para>
     1319      <section>
     1320        <title>Automake and Autoconf</title>
     1321
     1322        <para>The list of configure keywords available for ports that need
     1323        automake and/or autoconf.</para>
     1324
     1325        <para><variablelist>
     1326            <varlistentry>
     1327              <term>use_automake</term>
     1328
     1329              <listitem>
     1330                <para>Whether or not to use automake; the default is
     1331                "no".</para>
     1332
     1333                <programlisting>use_automake      yes</programlisting>
     1334              </listitem>
     1335            </varlistentry>
     1336
     1337            <varlistentry>
     1338              <term>automake.env</term>
     1339
     1340              <listitem>
     1341                <para>Environment variables to pass to automake.</para>
     1342
     1343                <programlisting>automake.env      CFLAGS=-I${prefix}/include</programlisting>
     1344              </listitem>
     1345            </varlistentry>
     1346
     1347            <varlistentry>
     1348              <term>automake.args</term>
     1349
     1350              <listitem>
     1351                <para>Arguments to pass to automake.</para>
     1352
     1353                <programlisting>automake.args     --foreign</programlisting>
     1354              </listitem>
     1355            </varlistentry>
     1356
     1357            <varlistentry>
     1358              <term>automake.dir</term>
     1359
     1360              <listitem>
     1361                <para>Directory in which to run
     1362                <varname>${automake.cmd}</varname>; the default is
     1363                <varname>${worksrcpath}</varname>.</para>
     1364
     1365                <programlisting>automake.dir      ./src</programlisting>
     1366              </listitem>
     1367            </varlistentry>
     1368
     1369            <varlistentry>
     1370              <term>use_autoconf</term>
     1371
     1372              <listitem>
     1373                <para>Whether or not to use autoconf; the default is
     1374                "no".</para>
     1375
     1376                <programlisting>use_autoconf      yes</programlisting>
     1377              </listitem>
     1378            </varlistentry>
     1379
     1380            <varlistentry>
     1381              <term>autoconf.env</term>
     1382
     1383              <listitem>
     1384                <para>Environmental variables to pass to autoconf.</para>
     1385
     1386                <programlisting>autoconf.env      CFLAGS=-I${prefix}/include/gtk12</programlisting>
     1387              </listitem>
     1388            </varlistentry>
     1389
     1390            <varlistentry>
     1391              <term>autoconf.args</term>
     1392
     1393              <listitem>
     1394                <para>Arguments to pass to autoconf.</para>
     1395
     1396                <programlisting>autoconf.args     -l src/aclocaldir</programlisting>
     1397              </listitem>
     1398            </varlistentry>
     1399
     1400            <varlistentry>
     1401              <term>autoconf.dir</term>
     1402
     1403              <listitem>
     1404                <para>Directory in which to run
     1405                <varname>${autoconf.cmd}</varname>; the default is
     1406                <varname>${worksrcpath}</varname>.</para>
     1407
     1408                <programlisting>autoconf.dir      src</programlisting>
     1409              </listitem>
     1410            </varlistentry>
     1411          </variablelist></para>
     1412      </section>
    13081413    </section>
    13091414
     
    13111416      <title>Build</title>
    13121417
    1313       <para></para>
     1418      <para>The list of keywords related to the build phase.</para>
     1419
     1420      <variablelist>
     1421        <varlistentry>
     1422          <term>build.cmd</term>
     1423
     1424          <listitem>
     1425            <para>Make command to run in <varname>${worksrcdir}</varname>; the
     1426            default is "make".</para>
     1427
     1428            <programlisting>build.cmd      pbxbuild</programlisting>
     1429          </listitem>
     1430        </varlistentry>
     1431
     1432        <varlistentry>
     1433          <term>build.type</term>
     1434
     1435          <listitem>
     1436            <para>Defines which "make" is required: "gnu" or "bsd". Sets
     1437            build.cmd to either "gnumake" or "bsdmake" accordingly.</para>
     1438
     1439            <programlisting>build.type     gnu</programlisting>
     1440          </listitem>
     1441        </varlistentry>
     1442
     1443        <varlistentry>
     1444          <term>build.pre_args</term>
     1445
     1446          <listitem>
     1447            <para>Arguments to pass to <varname>${build.cmd}</varname> before
     1448            <varname>${build.args}</varname>; the default is
     1449            <varname>${build.target.current}</varname>.</para>
     1450
     1451            <programlisting>build.pre_args      -project AudioSlicer.xcode</programlisting>
     1452
     1453            <simplelist>
     1454              <member>build.pre_args-append</member>
     1455
     1456              <member>build.pre_args-delete</member>
     1457            </simplelist>
     1458          </listitem>
     1459        </varlistentry>
     1460
     1461        <varlistentry>
     1462          <term>build.args</term>
     1463
     1464          <listitem>
     1465            <para>Arguments to pass to <varname>${build.cmd}</varname>.</para>
     1466
     1467            <programlisting>build.args          -DNOWARN</programlisting>
     1468          </listitem>
     1469        </varlistentry>
     1470
     1471        <varlistentry>
     1472          <term>build.target</term>
     1473
     1474          <listitem>
     1475            <para>Target to pass to make for building everything; default is
     1476            "all".</para>
     1477
     1478            <programlisting>build.target.all    all-src</programlisting>
     1479          </listitem>
     1480        </varlistentry>
     1481      </variablelist>
    13141482    </section>
    13151483
     
    13171485      <title>Destroot</title>
    13181486
    1319       <para></para>
    1320     </section>
    1321 
    1322     <section>
    1323       <title>Install</title>
    1324 
    1325       <para></para>
    1326     </section>
    1327 
    1328     <section>
    1329       <title>Activate</title>
    1330 
    1331       <para></para>
     1487      <para>The list of keywords related to the destroot phase.</para>
     1488
     1489      <variablelist>
     1490        <varlistentry>
     1491          <term>destroot.cmd</term>
     1492
     1493          <listitem>
     1494            <para>Install command to run relative to
     1495            <varname>${worksrcdir}</varname>; defaults is
     1496            <varname>${build.cmd}</varname>.</para>
     1497
     1498            <programlisting>destroot.cmd         pbxbuild</programlisting>
     1499          </listitem>
     1500        </varlistentry>
     1501
     1502        <varlistentry>
     1503          <term>destroot.type</term>
     1504
     1505          <listitem>
     1506            <para>Defines which "make" is required: either "gnu" or "bsd".
     1507            Sets install.cmd to either "gnumake" or "bsdmake"
     1508            accordingly.</para>
     1509
     1510            <programlisting>destroot.type        gnu</programlisting>
     1511          </listitem>
     1512        </varlistentry>
     1513
     1514        <varlistentry>
     1515          <term>destroot.pre_args</term>
     1516
     1517          <listitem>
     1518            <para>Arguments to pass to <varname>${destroot.cmd}</varname>
     1519            before <varname>${destroot.args}</varname>; default is
     1520            ${destroot.target}.</para>
     1521
     1522            <programlisting>destroot.pre_args    -project AudioSlicer.xcode</programlisting>
     1523
     1524            <simplelist>
     1525              <member>destroot.pre_args-append</member>
     1526
     1527              <member>destroot.pre_args-delete</member>
     1528            </simplelist>
     1529          </listitem>
     1530        </varlistentry>
     1531
     1532        <varlistentry>
     1533          <term>destroot.target</term>
     1534
     1535          <listitem>
     1536            <para>Install target to pass to
     1537            <varname>${destroot.cmd}</varname>.</para>
     1538
     1539            <programlisting>destroot.target     install-src</programlisting>
     1540
     1541            <simplelist>
     1542              <member>destroot.target-append</member>
     1543
     1544              <member>destroot.target-delete</member>
     1545            </simplelist>
     1546          </listitem>
     1547        </varlistentry>
     1548
     1549        <varlistentry>
     1550          <term>destroot.destdir</term>
     1551
     1552          <listitem>
     1553            <para>Arguments passed to ${destroot.cmd} to install correctly
     1554            into the destroot.</para>
     1555
     1556            <programlisting>destroot.destdir     prefix=${destroot}${prefix}</programlisting>
     1557
     1558            <note>
     1559              <para>If an application's Makefile properly supports the DESTDIR
     1560              variable, MacPorts will automatically destroot the port
     1561              properly. A port must destroot properly or the port will not
     1562              install correctly, upgrade, or uninstall. If not, you may need
     1563              to set this variable, or even patch the application's
     1564              Makefile.</para>
     1565            </note>
     1566          </listitem>
     1567        </varlistentry>
     1568      </variablelist>
    13321569    </section>
    13331570  </section>
     
    13491586
    13501587          <listitem>
    1351             <para>Description. </para>
     1588            <para>Description.</para>
    13521589
    13531590            <variablelist>
Note: See TracChangeset for help on using the changeset viewer.