- Use makevar and maketarget elements appropriately

PR:		docs/122997
Submitted by:	pgj
This commit is contained in:
Gabor Kovesdan 2008-04-27 12:09:06 +00:00
parent 8f63e0a54b
commit 6ea22d1579
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=31918

View file

@ -318,7 +318,7 @@ lsof: /usr/ports/sysutils/lsof</screen>
Ports Collection's built-in search mechanism. To use the
search feature, you will need to be in the
<filename>/usr/ports</filename> directory. Once in that
directory, run <command>make search
directory, run <command>make <maketarget>search</maketarget>
name=<replaceable>program-name</replaceable></command> where
<replaceable>program-name</replaceable> is the name of the
program you want to find. For example, if you were looking
@ -341,7 +341,7 @@ R-deps: </screen>
will not be covered here.</para>
<para>For more in-depth searching you can also use <command>make
search key=<replaceable>string</replaceable></command> where
<maketarget>search</maketarget> key=<replaceable>string</replaceable></command> where
<replaceable>string</replaceable> is some text to search for.
This searches port names, comments, descriptions and
dependencies and can be used to find ports which relate to a
@ -946,7 +946,7 @@ docbook =
returned to your prompt. The next step is to install the
port. In order to install it, you simply need to tack one word
onto the <command>make</command> command, and that word is
<command>install</command>:</para>
<maketarget>install</maketarget>:</para>
<screen>&prompt.root; <userinput>make install</userinput>
===&gt; Installing for lsof-4.57
@ -981,8 +981,8 @@ docbook =
<note>
<para>You can save two extra steps by just running <command>make
install clean</command> instead of <command>make</command>,
<command>make install</command> and <command>make clean</command>
<maketarget>install clean</maketarget></command> instead of <command>make</command>,
<command>make <maketarget>install</maketarget></command> and <command>make <maketarget>clean</maketarget></command>
as three separate steps.</para>
</note>
@ -1042,7 +1042,7 @@ docbook =
<note><para>You can build all the ports in a category or as a
whole by running <command>make</command> in the top level
directory, just like the aforementioned <command>make
<makevar>fetch</makevar></command> method. This is
<maketarget>fetch</maketarget></command> method. This is
dangerous, however, as some ports cannot co-exist. In other
cases, some ports can install two different files with the
same filename.</para></note>
@ -1128,13 +1128,13 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
It is not uncommon for users to wish to revisit this menu to add,
remove, or change these options after a port has been built. There
are many ways to do this. One option is to go into the directory
containing the port and type <command>make</command>
<maketarget>config</maketarget>, which will simply present the menu
containing the port and type <command>make
<maketarget>config</maketarget></command>, which will simply present the menu
again with the same options selected. Another option is to use
<command>make</command> <maketarget>showconfig</maketarget> which
<command>make <maketarget>showconfig</maketarget></command> which
will show you all the configuration options for the port. Yet
another option is to execute <command>make</command>
<maketarget>rmconfig</maketarget> which will remove all selected
another option is to execute <command>make
<maketarget>rmconfig</maketarget></command> which will remove all selected
options and allow you to start over. All of these options, and
others, are explained in great detail in in the man page for
&man.ports.7;.</para>
@ -1200,8 +1200,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
<para>The <application>portupgrade</application> utility is designed
to easily upgrade installed ports. It is available from the <filename
role="package">ports-mgmt/portupgrade</filename> port. Install it like
any other port, using the <command>make <makevar>install
clean</makevar></command> command:</para>
any other port, using the <command>make <maketarget>install
clean</maketarget></command> command:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portupgrade</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
@ -1267,7 +1267,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
confirmation of every step <application>Portmanager</application>
will perform. <application>Portmanager</application> can also be
used to install new ports on the system. Unlike the usual
<command>make install clean</command> command, it will upgrade all
<command>make <maketarget>install clean</maketarget></command> command, it will upgrade all
the dependencies prior to building and installing the
selected port.</para>
@ -1386,7 +1386,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
space over time. After building and installing software from the
ports, you should always remember to clean up
the temporary <filename class="directory">work</filename> directories using the <command>make
<makevar>clean</makevar></command> command. You can sweep the whole
<maketarget>clean</maketarget></command> command. You can sweep the whole
Ports Collection with the following command:</para>
<screen>&prompt.root; <userinput>portsclean -C</userinput></screen>
@ -1503,7 +1503,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
<listitem>
<para>Ask the maintainer of the port for help. Type
<command>make maintainer</command> or read the
<command>make <maketarget>maintainer</maketarget></command> or read the
<filename>Makefile</filename> to find the maintainer's
email address. Remember to include the name and version
of the port (send the <literal>&dollar;FreeBSD:</literal>