Date: Sun, 11 Aug 2002 02:16:33 +0200 (CEST) From: Christian Brueffer <chris@unixpages.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/41534: [PATCH] Various fixes to books/porters-handbook/book.sgml Message-ID: <20020811001633.34F43ABAE@milan.hitnet.rwth-aachen.de>
next in thread | raw e-mail | index | archive | help
>Number: 41534 >Category: docs >Synopsis: [PATCH] Various fixes to books/porters-handbook/book.sgml >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Aug 10 17:20:01 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Christian Brueffer >Release: FreeBSD 4.6-STABLE i386 >Organization: >Environment: System: FreeBSD milan.hitnet.rwth-aachen.de 4.6-STABLE FreeBSD 4.6-STABLE #2: Fri Jun 28 12:47:08 CEST 2002 chris@milan.hitnet.rwth-aachen.de:/usr/obj/usr/src/sys/LORIEN i386 >Description: - add missing tags - fix some typos and missing characters - grammar fixes >How-To-Repeat: >Fix: --- porters-handbook.diff begins here --- --- book.sgml.orig Fri Aug 9 17:56:36 2002 +++ book.sgml Sun Aug 11 02:09:49 2002 @@ -325,7 +325,7 @@ port_dir`</command> in a bug report and send it with the &man.send-pr.1; program (see <ulink url="../../articles/contributing/contrib-how.html#CONTRIB-GENERAL">Bug Reports and General Commentary</ulink> for more information about - &man.send-pr.1;. If the uncompressed port is larger than 20KB, + &man.send-pr.1;). If the uncompressed port is larger than 20KB, you should compress it into a tarfile and use &man.uuencode.1; before including it in the bug report (uuencoded tarfiles are acceptable even if the bug report is smaller than 20KB but are not @@ -1552,7 +1552,8 @@ <row> <entry><filename>textproc</filename></entry> <entry>Text processing utilities. It does not include - desktop publishing tools, which go to print/.</entry> + desktop publishing tools, which go to + <filename>print</filename>.</entry> </row> <row> @@ -1603,7 +1604,7 @@ </row> <row> - <entry>x11</entry> + <entry><filename>x11</filename></entry> <entry>The X window system and friends. This category is only for software that directly supports the window system. Do not put regular X applications here. If your port is an X @@ -2264,7 +2265,7 @@ variable <makevar>${NONEXISTENT}</makevar> as the first field of <makevar>BUILD_DEPENDS</makevar> or <makevar>RUN_DEPENDS</makevar>. Use this only when you need to - the to get to the source of the other port. You can often save + get to the source of the other port. You can often save compilation time by specifying the target too. For instance @@ -2291,8 +2292,8 @@ want those libraries or applications, the ports system provides hooks that the port author can use to decide which configuration should be built. Supporting these properly will - make uses happy, and effectively provide 2 or more ports for the - price of one.</para> + make users happy, and effectively provide 2 or more ports for + the price of one.</para> <para>The easiest of these to use is <makevar>WITHOUT_X11</makevar>. If the port can be built both @@ -2341,7 +2342,7 @@ <sect2> <title><makevar>WRKSRC</makevar></title> - <para>The variable lists the name of the directoy that is created when + <para>The variable lists the name of the directory that is created when the application's distfiles are extracted. If our previous example extracted into a directory called <filename>foo</filename> (and not <filename>foo-1.0</filename>) you would write:</para> @@ -2431,8 +2432,8 @@ deinstallation will not cause the system to still believe the library is there.</para> - <para>If you need, you can override default location where the new - library is installed by defining <makevar>LDCONFIG_DIRS</makevar> + <para>If you need, you can override the default location where the new + library is installed by defining the <makevar>LDCONFIG_DIRS</makevar> make variable, which should contain a list of directories into which shared libraries are to be installed. For example if your port installs shared libraries into @@ -3679,7 +3680,7 @@ <makevar>PLIST_SUB</makevar> variable with a list of <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal> pairs and instances of - <literal>%%<replaceable>VAR</replaceable>%%</literal>' will be + <literal>%%<replaceable>VAR</replaceable>%%</literal> will be substituted with <replaceable>VALUE</replaceable> in the <filename>pkg-plist</filename>.</para> @@ -3803,7 +3804,7 @@ <filename>/usr/local</filename>), unless <makevar>USE_X_PREFIX</makevar> or <makevar>USE_IMAKE</makevar> is set, in which case it will be <makevar>X11BASE</makevar> (default - <filename>/usr/X11R6</filename>).)</para> + <filename>/usr/X11R6</filename>).</para> <para>Not hard-coding <filename>/usr/local</filename> or <filename>/usr/X11R6</filename> anywhere in the source will make the @@ -3831,7 +3832,7 @@ or correct use of <makevar>LOCALBASE</makevar> for references to files from other ports. Testing the installation in <filename>/var/tmp/<replaceable>port-name</replaceable></filename> - to do that that while you have it installed would do that.</para> + to do that while you have it installed would do that.</para> <para>Do not set <makevar>USE_X_PREFIX</makevar> unless your port truly requires it (i.e., it links against X libs or it needs to @@ -3868,8 +3869,9 @@ version from the original authors, first make sure you have the latest port. You can find them in the <filename>ports/ports-current</filename> directory of the FTP mirror - sites. You may also use CVSup to keep your whole ports collection - up-to-date, as described in <ulink url="../handbook/synching.html#CVSUP-CONFIG">the Handbook</ulink>.</para> + sites. You may also use <application>CVSup</application> to + keep your whole ports collection up-to-date, as described in + <ulink url="../handbook/synching.html#CVSUP-CONFIG">the Handbook</ulink>.</para> <para>The next step is to send a mail to the maintainer, if one is listed in the port's <filename>Makefile</filename>. That person may --- porters-handbook.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: 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?20020811001633.34F43ABAE>