- Use makevar and maketarget elements appropriately
PR: docs/122997 Submitted by: pgj
This commit is contained in:
parent
8f63e0a54b
commit
6ea22d1579
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=31918
1 changed files with 16 additions and 16 deletions
|
@ -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>
|
||||
===> 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>$FreeBSD:</literal>
|
||||
|
|
Loading…
Reference in a new issue