Changeset 73026 for trunk/doc-new


Ignore:
Timestamp:
Nov 1, 2010, 4:32:55 PM (9 years ago)
Author:
mk@…
Message:

guide: fix some lines in the common tasks section 3.3 thanks to discussion with Brad Giesbrecht

File:
1 edited

Legend:

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

    r73017 r73026  
    438438    maintenance workflow.</para>
    439439
     440    <para>Mind the 'sudo' for some of the subsequent examples, which is necessary if you have a
     441    system-wide MacPorts installation.</para>
     442
    440443    <variablelist>
    441444
     
    444447
    445448        <listitem>
    446           <para>is an essential to stay up-to-date with MacPorts (Mind the 'sudo' for
    447           some of the subsequent examples, which is necessary if you have a system-wide MacPorts installation.):</para>
     449          <para>is essential to stay up-to-date with MacPorts:</para>
    448450
    449451          <programlisting><prompt>%%</prompt> <userinput>sudo port selfupdate</userinput></programlisting>
     
    489491
    490492      <varlistentry>
    491         <term>Upgrade a certain port</term>
    492 
    493         <listitem>
    494           <para>e.g. in case you don't have enough time to upgrade your whole MacPorts tree:</para>
     493        <term>Upgrading active ports</term>
     494
     495        <listitem>
     496          <para>is usually done with the follwoing command:</para>
     497
     498          <programlisting><prompt>%%</prompt> <userinput>sudo port upgrade outdated</userinput></programlisting>
     499        </listitem>
     500
     501        <listitem>
     502          <para>In case you want to upgrade only a specific port (for whatever reason):</para>
    495503
    496504          <programlisting><prompt>%%</prompt> <userinput>sudo port upgrade makedepend</userinput></programlisting>
     
    560568
    561569      <varlistentry>
    562         <term>Finding ports which are leaves</term>
     570        <term>Finding leaves (nondependent ports)</term>
    563571
    564572        <listitem>
     
    566574          a specific port is installed. One can imagine that if one keeps installing and
    567575          uninstalling ports for some time the MacPorts tree can be swamped with ports actually
    568           not necessary anymore. Ports not being a dependency for any other port are called leaves
    569           and can be found issuing the command:</para>
     576          not necessary anymore. Leaves can be found issueing the command:</para>
    570577
    571578          <programlisting><prompt>%%</prompt> <userinput>port echo leaves</userinput></programlisting>
     
    591598
    592599      <varlistentry>
    593         <term>Define a port as requested (being a rather lengthy usage example)</term>
    594 
    595         <listitem>
    596           <note>
    597             <para>This is a feature introduced with MacPorts version 1.9 and it is in fact
    598             necessary to dedicate a seperate subsection to it somewhere in the section covering
    599             all port commands.</para>
    600           </note>
     600        <term>Keep your MacPorts installation lean by defining leaves as requested ports</term>
     601
     602        <listitem>
    601603         
    602           <para>Defining a port as a requested port makes maintenance of the MacPorts tree
    603           much easier, since the maintainer can, for instance, now more easily spot leftovers
    604           (i.e. leaves) of previous installation orgies.:</para>
    605 
    606604          <para>Well, before we come to the procedure of defining your requested ports,
    607           let's have a look at a typical scenario when you want to understand what is
    608           actually installed and what is on other hand truely necessary for your system.
    609           Say checking leaves on the MacPorts tree gives this output:</para>
     605          let's have a look at a typical scenario where you want to understand what is
     606          actually installed and what is on the other hand truly necessary for your system.
     607          Say checking leaves of your MacPorts installation gives this output:</para>
    610608
    611609          <programlisting><prompt>%%</prompt> <userinput>port echo leaves</userinput></programlisting>
     
    618616physfs                         @2.0.1_0</screen>
    619617
    620           <para>Now it is up to the maintainer to decide what's needed and what is not.
     618          <para>Now it is up to the user to decide what's needed and what is not.
    621619          Let's say one certainly would want ports starting with autoconf up to coreutils,
    622620          since they are often used in port installation. Set those as requested ports using:</para>
Note: See TracChangeset for help on using the changeset viewer.