Changeset 140804 for trunk/doc-new


Ignore:
Timestamp:
Oct 3, 2015, 3:22:54 PM (3 years ago)
Author:
raimue@…
Message:

doc/doc-new: Clarify updating a single port may lead to errors, closes #48909

Location:
trunk/doc-new/guide/xml
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/project.xml

    r139488 r140804  
    7272            <replaceable>foo</replaceable>' to rebuild ports depending upon
    7373            port <replaceable>foo</replaceable>.
     74            Note that it is safest and recommended that most users always upgrade
     75            with 'port upgrade outdated' to update all ports at once. Upgrading a
     76            single port can lead to software errors in other ports that have not
     77            yet been upgraded.
    7478          </para>
    7579        </listitem>
  • trunk/doc-new/guide/xml/using.xml

    r134584 r140804  
    826826
    827827            <para>to update all ports that have an upgrade available. You can, however, selectively upgrade ports if you
    828                 want to delay other upgrades until later. To do that, specify the name(s) of the port(s) to upgrade:</para>
     828                want to delay other upgrades until later. This is not recommended unless you know what you are doing,
     829                since you might experience software errors for the ports that have not yet been upgraded. To upgrade
     830                individual ports, specify the name(s) of the port(s) to upgrade:</para>
    829831
    830832            <programlisting><prompt>$ </prompt><userinput>sudo port upgrade gnupg2</userinput></programlisting>
     
    11291131            <programlisting><prompt>$ </prompt><userinput>sudo port upgrade outdated</userinput></programlisting>
    11301132
    1131             <para>In case you want to upgrade only a specific port, replace <quote>outdated</quote> in the command given
    1132                 above with the port's name:</para>
     1133            <para>In case you want to upgrade only a specific port (not recommended unless you know what you are doing),
     1134                replace <quote>outdated</quote> in the command given above with the port's name:</para>
    11331135
    11341136            <programlisting><prompt>$ </prompt><userinput>sudo port upgrade makedepend</userinput></programlisting>
Note: See TracChangeset for help on using the changeset viewer.