Ports Collection's built-in search mechanism.  To use the

        Ports Collection's built-in search mechanism.  To use the

        search feature, you will need to be in the

        search feature, you will need to be in the

        <filename>/usr/ports</filename> directory.  Once in that

        <filename>/usr/ports</filename> directory.  Once in that

        name=<replaceable>program-name</replaceable></command> where

        name=<replaceable>program-name</replaceable></command> where

        <replaceable>program-name</replaceable> is the name of the

        <replaceable>program-name</replaceable> is the name of the

        program you want to find.  For example, if you were looking

        program you want to find.  For example, if you were looking

        will not be covered here.</para>

        will not be covered here.</para>

      <para>For more in-depth searching you can also use <command>make

      <para>For more in-depth searching you can also use <command>make

       <replaceable>string</replaceable> is some text to search for.

       <replaceable>string</replaceable> is some text to search for.

       This searches port names, comments, descriptions and

       This searches port names, comments, descriptions and

       dependencies and can be used to find ports which relate to a

       dependencies and can be used to find ports which relate to a

	  returned to your prompt.  The next step is to install the

	  returned to your prompt.  The next step is to install the

	  port.  In order to install it, you simply need to tack one word

	  port.  In order to install it, you simply need to tack one word

	  onto the <command>make</command> command, and that word is

	  onto the <command>make</command> command, and that word is

        <screen>&prompt.root; <userinput>make install</userinput>

        <screen>&prompt.root; <userinput>make install</userinput>

===>  Installing for lsof-4.57

===>  Installing for lsof-4.57

        <note>

        <note>

          <para>You can save two extra steps by just running <command>make

          <para>You can save two extra steps by just running <command>make

	    as three separate steps.</para>

	    as three separate steps.</para>

	</note>

	</note>

	<note><para>You can build all the ports in a category or as a

	<note><para>You can build all the ports in a category or as a

	  whole by running <command>make</command> in the top level

	  whole by running <command>make</command> in the top level

	  directory, just like the aforementioned <command>make

	  directory, just like the aforementioned <command>make

	  dangerous, however, as some ports cannot co-exist.  In other

	  dangerous, however, as some ports cannot co-exist.  In other

	  cases, some ports can install two different files with the

	  cases, some ports can install two different files with the

	  same filename.</para></note>

	  same filename.</para></note>

	  It is not uncommon for users to wish to revisit this menu to add,

	  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

	  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

	  are many ways to do this.  One option is to go into the directory

	  again with the same options selected.  Another option is to use

	  again with the same options selected.  Another option is to use

	  will show you all the configuration options for the port.  Yet

	  will show you all the configuration options for the port.  Yet

	  options and allow you to start over.  All of these options, and

	  options and allow you to start over.  All of these options, and

	  others, are explained in great detail in in the man page for

	  others, are explained in great detail in in the man page for

	  &man.ports.7;.</para>

	  &man.ports.7;.</para>

      <para>The <application>portupgrade</application> utility is designed

      <para>The <application>portupgrade</application> utility is designed

	to easily upgrade installed ports.  It is available from the <filename

	to easily upgrade installed ports.  It is available from the <filename

	role="package">ports-mgmt/portupgrade</filename> port.  Install it like

	role="package">ports-mgmt/portupgrade</filename> port.  Install it like

      <screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portupgrade</userinput>

      <screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portupgrade</userinput>

&prompt.root; <userinput>make install clean</userinput></screen>

&prompt.root; <userinput>make install clean</userinput></screen>

	  confirmation of every step <application>Portmanager</application>

	  confirmation of every step <application>Portmanager</application>

	  will perform.  <application>Portmanager</application> can also be

	  will perform.  <application>Portmanager</application> can also be

	  used to install new ports on the system.  Unlike the usual

	  used to install new ports on the system.  Unlike the usual

	  the dependencies prior to building and installing the

	  the dependencies prior to building and installing the

	  selected port.</para>

	  selected port.</para>

	space over time.  After building and installing software from the

	space over time.  After building and installing software from the

	ports, you should always remember to clean up

	ports, you should always remember to clean up

	the temporary <filename class="directory">work</filename> directories using the <command>make

	the temporary <filename class="directory">work</filename> directories using the <command>make

	Ports Collection with the following command:</para>

	Ports Collection with the following command:</para>

      <screen>&prompt.root; <userinput>portsclean -C</userinput></screen>

      <screen>&prompt.root; <userinput>portsclean -C</userinput></screen>

	<listitem>

	<listitem>

	  <para>Ask the maintainer of the port for help.  Type

	  <para>Ask the maintainer of the port for help.  Type

	    <filename>Makefile</filename> to find the maintainer's

	    <filename>Makefile</filename> to find the maintainer's

	    email address.  Remember to include the name and version

	    email address.  Remember to include the name and version

	    of the port (send the <literal>&dollar;FreeBSD:</literal>

	    of the port (send the <literal>&dollar;FreeBSD:</literal>