View | Details | Raw Unified | Return to bug 41534
Collapse All | Expand All

(-)book.sgml (-14 / +16 lines)
Lines 325-331 Link Here
325
            port_dir`</command> in a bug report and send it with the
325
            port_dir`</command> in a bug report and send it with the
326
            &man.send-pr.1; program (see <ulink url="../../articles/contributing/contrib-how.html#CONTRIB-GENERAL">Bug
326
            &man.send-pr.1; program (see <ulink url="../../articles/contributing/contrib-how.html#CONTRIB-GENERAL">Bug
327
            Reports and General Commentary</ulink> for more information about
327
            Reports and General Commentary</ulink> for more information about
328
            &man.send-pr.1;.  If the uncompressed port is larger than 20KB,
328
            &man.send-pr.1;).  If the uncompressed port is larger than 20KB,
329
          you should compress it into a tarfile and use &man.uuencode.1;
329
          you should compress it into a tarfile and use &man.uuencode.1;
330
          before including it in the bug report (uuencoded tarfiles are
330
          before including it in the bug report (uuencoded tarfiles are
331
          acceptable even if the bug report is smaller than 20KB but are not
331
          acceptable even if the bug report is smaller than 20KB but are not
Lines 1552-1558 Link Here
1552
              <row>
1552
              <row>
1553
                <entry><filename>textproc</filename></entry>
1553
                <entry><filename>textproc</filename></entry>
1554
                <entry>Text processing utilities.  It does not include
1554
                <entry>Text processing utilities.  It does not include
1555
                  desktop publishing tools, which go to print/.</entry>
1555
                  desktop publishing tools, which go to
1556
                  <filename>print</filename>.</entry>
1556
              </row>
1557
              </row>
1557
1558
1558
              <row>
1559
              <row>
Lines 1603-1609 Link Here
1603
              </row>
1604
              </row>
1604
1605
1605
              <row>
1606
              <row>
1606
                <entry>x11</entry>
1607
                <entry><filename>x11</filename></entry>
1607
                <entry>The X window system and friends.  This category is only
1608
                <entry>The X window system and friends.  This category is only
1608
                  for software that directly supports the window system.  Do not
1609
                  for software that directly supports the window system.  Do not
1609
                  put regular X applications here.  If your port is an X
1610
                  put regular X applications here.  If your port is an X
Lines 2264-2270 Link Here
2264
            variable <makevar>${NONEXISTENT}</makevar> as the first field 
2265
            variable <makevar>${NONEXISTENT}</makevar> as the first field 
2265
            of <makevar>BUILD_DEPENDS</makevar> or
2266
            of <makevar>BUILD_DEPENDS</makevar> or
2266
            <makevar>RUN_DEPENDS</makevar>.  Use this only when you need to
2267
            <makevar>RUN_DEPENDS</makevar>.  Use this only when you need to
2267
            the to get to the source of the other port.  You can often save
2268
            get to the source of the other port.  You can often save
2268
            compilation time by specifying the target too.  For
2269
            compilation time by specifying the target too.  For
2269
            instance
2270
            instance
2270
2271
Lines 2291-2298 Link Here
2291
	want those libraries or applications, the ports system
2292
	want those libraries or applications, the ports system
2292
	provides hooks that the port author can use to decide which
2293
	provides hooks that the port author can use to decide which
2293
	configuration should be built. Supporting these properly will
2294
	configuration should be built. Supporting these properly will
2294
	make uses happy, and effectively provide 2 or more ports for the
2295
	make users happy, and effectively provide 2 or more ports for
2295
	price of one.</para>
2296
	the price of one.</para>
2296
	
2297
	
2297
      <para>The easiest of these to use is
2298
      <para>The easiest of these to use is
2298
	<makevar>WITHOUT_X11</makevar>. If the port can be built both
2299
	<makevar>WITHOUT_X11</makevar>. If the port can be built both
Lines 2341-2347 Link Here
2341
      <sect2>
2342
      <sect2>
2342
	<title><makevar>WRKSRC</makevar></title>
2343
	<title><makevar>WRKSRC</makevar></title>
2343
2344
2344
	<para>The variable lists the name of the directoy that is created when
2345
	<para>The variable lists the name of the directory that is created when
2345
	  the application's distfiles are extracted.  If our previous example
2346
	  the application's distfiles are extracted.  If our previous example
2346
	  extracted into a directory called <filename>foo</filename> (and not
2347
	  extracted into a directory called <filename>foo</filename> (and not
2347
	  <filename>foo-1.0</filename>) you would write:</para>
2348
	  <filename>foo-1.0</filename>) you would write:</para>
Lines 2431-2438 Link Here
2431
          deinstallation will not cause the system to still believe the
2432
          deinstallation will not cause the system to still believe the
2432
          library is there.</para>
2433
          library is there.</para>
2433
2434
2434
        <para>If you need, you can override default location where the new
2435
        <para>If you need, you can override the default location where the new
2435
          library is installed by defining <makevar>LDCONFIG_DIRS</makevar>
2436
          library is installed by defining the <makevar>LDCONFIG_DIRS</makevar>
2436
          make variable, which should contain a list of directories into which
2437
          make variable, which should contain a list of directories into which
2437
          shared libraries are to be installed.  For example if your port
2438
          shared libraries are to be installed.  For example if your port
2438
          installs shared libraries into
2439
          installs shared libraries into
Lines 3679-3685 Link Here
3679
          <makevar>PLIST_SUB</makevar> variable with a list of
3680
          <makevar>PLIST_SUB</makevar> variable with a list of
3680
          <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>
3681
          <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>
3681
          pairs and instances of
3682
          pairs and instances of
3682
          <literal>%%<replaceable>VAR</replaceable>%%</literal>' will be
3683
          <literal>%%<replaceable>VAR</replaceable>%%</literal> will be
3683
          substituted with <replaceable>VALUE</replaceable> in the
3684
          substituted with <replaceable>VALUE</replaceable> in the
3684
          <filename>pkg-plist</filename>.</para>
3685
          <filename>pkg-plist</filename>.</para>
3685
3686
Lines 3803-3809 Link Here
3803
          <filename>/usr/local</filename>), unless
3804
          <filename>/usr/local</filename>), unless
3804
          <makevar>USE_X_PREFIX</makevar> or <makevar>USE_IMAKE</makevar> is
3805
          <makevar>USE_X_PREFIX</makevar> or <makevar>USE_IMAKE</makevar> is
3805
          set, in which case it will be <makevar>X11BASE</makevar> (default
3806
          set, in which case it will be <makevar>X11BASE</makevar> (default
3806
          <filename>/usr/X11R6</filename>).)</para>
3807
          <filename>/usr/X11R6</filename>).</para>
3807
3808
3808
        <para>Not hard-coding <filename>/usr/local</filename> or
3809
        <para>Not hard-coding <filename>/usr/local</filename> or
3809
          <filename>/usr/X11R6</filename> anywhere in the source will make the
3810
          <filename>/usr/X11R6</filename> anywhere in the source will make the
Lines 3831-3837 Link Here
3831
	or correct use of <makevar>LOCALBASE</makevar> for references to
3832
	or correct use of <makevar>LOCALBASE</makevar> for references to
3832
	files from other ports.  Testing the installation in
3833
	files from other ports.  Testing the installation in
3833
	<filename>/var/tmp/<replaceable>port-name</replaceable></filename>
3834
	<filename>/var/tmp/<replaceable>port-name</replaceable></filename>
3834
	to do that that while you have it installed would do that.</para>
3835
	to do that while you have it installed would do that.</para>
3835
3836
3836
        <para>Do not set <makevar>USE_X_PREFIX</makevar> unless your port
3837
        <para>Do not set <makevar>USE_X_PREFIX</makevar> unless your port
3837
          truly requires it (i.e., it links against X libs or it needs to
3838
          truly requires it (i.e., it links against X libs or it needs to
Lines 3868-3875 Link Here
3868
        version from the original authors, first make sure you have the latest
3869
        version from the original authors, first make sure you have the latest
3869
        port.  You can find them in the
3870
        port.  You can find them in the
3870
        <filename>ports/ports-current</filename> directory of the FTP mirror
3871
        <filename>ports/ports-current</filename> directory of the FTP mirror
3871
        sites.  You may also use CVSup to keep your whole ports collection
3872
        sites.  You may also use <application>CVSup</application> to
3872
        up-to-date, as described in <ulink url="../handbook/synching.html#CVSUP-CONFIG">the Handbook</ulink>.</para>
3873
        keep your whole ports collection up-to-date, as described in
3874
        <ulink url="../handbook/synching.html#CVSUP-CONFIG">the Handbook</ulink>.</para>
3873
3875
3874
      <para>The next step is to send a mail to the maintainer, if one is
3876
      <para>The next step is to send a mail to the maintainer, if one is
3875
        listed in the port's <filename>Makefile</filename>.  That person may
3877
        listed in the port's <filename>Makefile</filename>.  That person may

Return to bug 41534