[49351] branches/new-help-system/base/doc

raimue at macports.org raimue at macports.org
Tue Apr 7 21:56:03 PDT 2009


Revision: 49351
          http://trac.macports.org/changeset/49351
Author:   raimue at macports.org
Date:     2009-04-07 21:56:03 -0700 (Tue, 07 Apr 2009)
Log Message:
-----------
doc/port.1, doc/port.1.txt:
Fix list item continuations and more little details

Modified Paths:
--------------
    branches/new-help-system/base/doc/port.1
    branches/new-help-system/base/doc/port.1.txt

Modified: branches/new-help-system/base/doc/port.1
===================================================================
--- branches/new-help-system/base/doc/port.1	2009-04-08 04:54:04 UTC (rev 49350)
+++ branches/new-help-system/base/doc/port.1	2009-04-08 04:56:03 UTC (rev 49351)
@@ -482,8 +482,10 @@
 \fIportdir\fR
 .RE
 .sp
-Search strings that will expand to a set of matching ports can be constructed based on the "\fIpseudo\-portname\fR selector":regex combination used\&. \fIportnames\fR\' containing valid UNIX glob patterns will also expand to the set of matching ports\&. Any action passed to port will be invoked on each of them\&. For example:
+Search strings that will expand to a set of matching ports can be constructed based on the "\fIpseudo\-portname\fR selector":regex combination used\&. \fIportnames\fR\' containing valid UNIX glob patterns will also expand to the set of matching ports\&. Any action passed to port will be invoked on each of them\&.
 .sp
+For example:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -502,8 +504,10 @@
 .RE
 .\}
 .sp
-Logical operators "and", "or", "not", "!", "(" and ")" may be used to combine individual \fIportnames\fR, port glob patterns and/or \fIpseudo\-portnames\fR to construct complex port expressions that expand to the set of matching ports\&. For example:
+Logical operators "and", "or", "not", "!", "(" and ")" may be used to combine individual \fIportnames\fR, port glob patterns and/or \fIpseudo\-portnames\fR to construct complex port expressions that expand to the set of matching ports\&.
 .sp
+For example:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -633,9 +637,10 @@
 .PP
 search
 .RS 4
-Search for an available port whose name matches a regular expression\&. For example:
-.RE
+Search for an available port whose name matches a regular expression\&.
 .sp
+For example:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -643,7 +648,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port search vim
+port search vim
 .EB lightgray
 .fi
 .fam
@@ -651,6 +656,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 info
 .RS 4
@@ -667,9 +673,8 @@
 is provided, the information will be formatted in a somewhat more attractive fashion for human readers\&. This is the default when no options at all are specified to info\&. If the option
 \fB\-\-index\fR
 is provided, the information will be pulled from the PortIndex rather than from the Portfile\&. In this case variant information, such as dependencies, will not affect the output\&.
-
+.sp
 For example:
-.RE
 .sp
 .if n \{\
 .RS 4
@@ -678,12 +683,12 @@
 .ps -1
 .nf
 .BB lightgray
-    port info vim +ruby
-    port info \-\-category \-\-name apache*
-    port \-q info \-\-category \-\-name \-\-version category:java
-    port info \-\-line \-\-category \-\-name all
-    port info \-\-pretty \-\-fullname \-\-depends gtk2
-    port info \-\-index python24
+port info vim +ruby
+port info \-\-category \-\-name apache*
+port \-q info \-\-category \-\-name \-\-version category:java
+port info \-\-line \-\-category \-\-name all
+port info \-\-pretty \-\-fullname \-\-depends gtk2
+port info \-\-index python24
 .EB lightgray
 .fi
 .fam
@@ -691,6 +696,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 variants
 .RS 4
@@ -722,9 +728,8 @@
 ports, use
 \fB\-u\fR\&. To recursively uninstall all dependents of this port, use
 \fB\-\-follow\-dependents\fR\&.
-
+.sp
 For example:
-.RE
 .sp
 .if n \{\
 .RS 4
@@ -733,9 +738,9 @@
 .ps -1
 .nf
 .BB lightgray
-    port uninstall vim
-    port \-u uninstall
-    port uninstall \-\-follow\-dependents python24
+port uninstall vim
+port \-u uninstall
+port uninstall \-\-follow\-dependents python24
 .EB lightgray
 .fi
 .fam
@@ -743,6 +748,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 activate
 .RS 4
@@ -775,9 +781,10 @@
 .PP
 provides
 .RS 4
-Determines which port owns a given file and can take either a relative or absolute path\&. For example:
-.RE
+Determines which port owns a given file and can take either a relative or absolute path\&.
 .sp
+For example:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -785,8 +792,8 @@
 .ps -1
 .nf
 .BB lightgray
-    port provides /opt/local/etc/irssi\&.conf
-    port provides include/tiff\&.h
+port provides /opt/local/etc/irssi\&.conf
+port provides include/tiff\&.h
 .EB lightgray
 .fi
 .fam
@@ -794,11 +801,14 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 sync
 .RS 4
-Performs a sync operation only on the ports tree of a MacPorts installation, pulling in the latest revision available of the Portfiles from the MacPorts rsync server\&. To update you would normally do:
+Performs a sync operation only on the ports tree of a MacPorts installation, pulling in the latest revision available of the Portfiles from the MacPorts rsync server\&.
 .sp
+To update you would normally do:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -815,24 +825,8 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
-If any of the ports tree(s) uses a file: URL that points to a local
-subversion working copy, sync will perform an svn update on the working
-copy with the user set to the owner of the working copy\&.
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
+If any of the ports tree(s) uses a file: URL that points to a local subversion working copy, sync will perform an svn update on the working copy with the user set to the owner of the working copy\&.
 .RE
-.\}
-.RE
 .PP
 outdated
 .RS 4
@@ -847,10 +841,9 @@
 (no dependencies) and
 \fB\-R\fR
 (dependents) above\&.
-
+.sp
 Upgrade the installed
 \fIportname\fR\&. For example:
-.RE
 .sp
 .if n \{\
 .RS 4
@@ -859,7 +852,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port upgrade vim
+port upgrade vim
 .EB lightgray
 .fi
 .fam
@@ -868,21 +861,7 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
 To upgrade all outdated ports:
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
-.RE
-.\}
 .sp
 .if n \{\
 .RS 4
@@ -891,7 +870,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port upgrade outdated
+port upgrade outdated
 .EB lightgray
 .fi
 .fam
@@ -900,21 +879,9 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
-To upgrade \'portname\' and the ports that depend on it:
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
-.RE
-.\}
+To upgrade
+\fIportname\fR
+and the ports that depend on it:
 .sp
 .if n \{\
 .RS 4
@@ -923,7 +890,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port \-R upgrade libiconv
+port \-R upgrade libiconv
 .EB lightgray
 .fi
 .fam
@@ -932,21 +899,7 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
 To force a rebuild use:
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
-.RE
-.\}
 .sp
 .if n \{\
 .RS 4
@@ -955,7 +908,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port \-fn upgrade vim
+port \-fn upgrade vim
 .EB lightgray
 .fi
 .fam
@@ -964,22 +917,12 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
-To upgrade \'portname\' without following its dependencies before, use *\-n*\&.
+To upgrade
+\fIportname\fR
+without following its dependencies before, use
+\fB\-n\fR\&.
+.sp
 For example:
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
-.RE
-.\}
 .sp
 .if n \{\
 .RS 4
@@ -988,7 +931,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port \-n upgrade wireshark
+port \-n upgrade wireshark
 .EB lightgray
 .fi
 .fam
@@ -996,28 +939,25 @@
 .if n \{\
 .RE
 .\}
-.sp
 .if n \{\
-.RS 4
+.sp
 .\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
-Note that in selecting the variants to use in the upgraded build of the
-port, any variants specified on the command line take highest precedence,
-then the variants active in the latest installed version of the port, and
-finally the global variants specified in variants\&.conf, if any\&.  Note that
-upgrade will not normally rebuild a port only to change the selected
-variants; you can either specify *\-f*, or deactivate the port and reinstall
-it with different variants\&.
-.EB lightgray
-.fi
-.fam
+.RS 4
+.BM yellow
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
 .ps +1
-.if n \{\
+\fBNote\fR
+.ps -1
+.br
+By selecting the variants to use in the upgraded build of the port, any variants specified on the command line take highest precedence, then the variants active in the latest installed version of the port, and finally the global variants specified in variants\&.conf, if any\&. Note that upgrade will not normally rebuild a port only to change the selected variants; you can either specify
+\fB\-f\fR, or deactivate the port and reinstall it with different variants\&.
+.sp .5v
+.EM yellow
 .RE
-.\}
+.RE
 .PP
 clean
 .RS 4
@@ -1027,25 +967,9 @@
 \fIactionflag\fR\&. This is the default when no flag is given\&. To remove the distribution files (fetched tarballs, patches, etc), specify
 \fB\-\-dist\fR\&. To remove the archive(s) for the current version of a port, pass
 \fB\-\-archive\fR\&. To remove the work files, distribution files and archives, pass
-\fB\-\-all\fR\&. For example:
-.RE
+\fB\-\-all\fR\&.
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
-    port clean \-\-dist vim
-    port clean \-\-archive vim
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
-.RE
-.\}
+For example:
 .sp
 .if n \{\
 .RS 4
@@ -1054,8 +978,8 @@
 .ps -1
 .nf
 .BB lightgray
-To remove only certain version(s) of a port\'s archives (version is any
-valid UNIX glob pattern), you can use:
+port clean \-\-dist vim
+port clean \-\-archive vim
 .EB lightgray
 .fi
 .fam
@@ -1064,6 +988,8 @@
 .RE
 .\}
 .sp
+To remove only certain version(s) of a port\(cqs archives (version is any valid UNIX glob pattern), you can use:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -1071,7 +997,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port clean \-\-archive vim 6\&.2\&.114
+port clean \-\-archive vim 6\&.2\&.114
 .EB lightgray
 .fi
 .fam
@@ -1080,21 +1006,7 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
 or:
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
-.RE
-.\}
 .sp
 .if n \{\
 .RS 4
@@ -1103,7 +1015,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port clean \-\-archive vim \'6\&.*\'
+port clean \-\-archive vim \'6\&.*\'
 .EB lightgray
 .fi
 .fam
@@ -1111,6 +1023,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 echo
 .RS 4
@@ -1120,9 +1033,10 @@
 \fIpseudo\-portname selectors\fR
 and the evaluation of port expressions\&.
 \fBecho\fR
-may be used to determine the exact set of ports to which a given string of arguments will expand, without performing any further operations on them\&. For example:
-.RE
+may be used to determine the exact set of ports to which a given string of arguments will expand, without performing any further operations on them\&.
 .sp
+For example:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -1130,9 +1044,9 @@
 .ps -1
 .nf
 .BB lightgray
-    port echo category:net
-    port echo maintainer:jmpp and name:netw
-    port echo maintainer:jmpp and \e( net* or category:text \e)
+port echo category:net
+port echo maintainer:jmpp and name:netw
+port echo maintainer:jmpp and \e( net* or category:text \e)
 .EB lightgray
 .fi
 .fam
@@ -1140,6 +1054,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 list
 .RS 4
@@ -1172,9 +1087,10 @@
 .PP
 selfupdate
 .RS 4
-Updates the MacPorts system, ports tree(s) and base tools if needed, from the MacPorts rsync server, installing the newest infrastructure available\&. To update you would typ\- ically do:
-.RE
+Updates the MacPorts system, ports tree(s) and base tools if needed, from the MacPorts rsync server, installing the newest infrastructure available\&.
 .sp
+To update you would typically do:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -1182,7 +1098,7 @@
 .ps -1
 .nf
 .BB lightgray
-    sudo port \-d selfupdate
+sudo port \-d selfupdate
 .EB lightgray
 .fi
 .fam
@@ -1191,26 +1107,14 @@
 .RE
 .\}
 .sp
-.if n \{\
-.RS 4
-.\}
-.fam C
-.ps -1
-.nf
-.BB lightgray
-See \'sync\' for more information about updating ports tree(s)\&.
-.EB lightgray
-.fi
-.fam
-.ps +1
-.if n \{\
+See
+\fIsync\fR
+for more information about updating ports tree(s)\&.
 .RE
-.\}
 .PP
 load
 .RS 4
 Provides a shortcut to using launchctl to load a port\(cqs daemon (as installed in /Library/LaunchDaemons)\&. It runs:
-.RE
 .sp
 .if n \{\
 .RS 4
@@ -1219,7 +1123,7 @@
 .ps -1
 .nf
 .BB lightgray
-    launchctl load \-w /Library/LaunchDaemons/org\&.macports\&.${port}\&.plist
+launchctl load \-w /Library/LaunchDaemons/org\&.macports\&.${port}\&.plist
 .EB lightgray
 .fi
 .fam
@@ -1227,6 +1131,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 unload
 .RS 4
@@ -1293,9 +1198,10 @@
 \fIed\fR
 also invokes this command\&.
 
-You can also use the \-\-editor flag on the command line to specify an alternative edi\- tor\&. For example:
-.RE
+You can also use the \-\-editor flag on the command line to specify an alternative edi\- tor\&.
 .sp
+For example:
+.sp
 .if n \{\
 .RS 4
 .\}
@@ -1303,7 +1209,7 @@
 .ps -1
 .nf
 .BB lightgray
-    port edit \-\-editor nano apache2
+port edit \-\-editor nano apache2
 .EB lightgray
 .fi
 .fam
@@ -1311,6 +1217,7 @@
 .if n \{\
 .RE
 .\}
+.RE
 .PP
 unarchive
 .RS 4
@@ -1464,14 +1371,17 @@
 .\}
 .SH "FILES"
 .PP
+${prefix}/etc/macports/macports\&.conf
 .RS 4
 Global configuration file for the MacPorts system\&.
 .RE
 .PP
+${prefix}/etc/macports/sources\&.conf
 .RS 4
 Global listing of the ports trees used by MacPorts\&. This file also enables rsync synchronization\&.
 .RE
 .PP
+${prefix}/etc/macports/variants\&.conf
 .RS 4
 Global variants used when a port is installed\&.
 .RE

Modified: branches/new-help-system/base/doc/port.1.txt
===================================================================
--- branches/new-help-system/base/doc/port.1.txt	2009-04-08 04:54:04 UTC (rev 49350)
+++ branches/new-help-system/base/doc/port.1.txt	2009-04-08 04:56:03 UTC (rev 49351)
@@ -74,21 +74,26 @@
 Search strings that will expand to a set of matching ports can be constructed
 based on the "'pseudo-portname' selector":regex combination used. 'portnames''
 containing valid UNIX glob patterns will also expand to the set of matching
-ports. Any action passed to port will be invoked on each of them. For example:
+ports. Any action passed to port will be invoked on each of them.
+
+For example:
 --------
 port list variant:no_ssl
 port uninstall name:sql
 port echo apache*
 --------
+
 Logical operators "and", "or", "not", "!", "(" and ")" may be used to combine
 individual 'portnames', port glob patterns and/or 'pseudo-portnames' to
-construct complex port expressions that expand to the set of matching ports. For
-example:
+construct complex port expressions that expand to the set of matching ports.
+
+For example:
 --------
 port upgrade installed and apache*
 port echo maintainer:jberry and uninstalled and \( category:java and not commons* \)
 --------
 
+
 OPTIONS
 -------
 
@@ -165,8 +170,9 @@
     programs the port executes. In verbose mode, it will also report unused
     dependencies for each stage of the port installation. It also consists in
     forbidding and reporting file creation and file writes outside allowed
-    direc- tories (temporary directories and ${workpath}).
+    directories (temporary directories and ${workpath}).
 
+
 USER TARGETS
 ------------
 
@@ -174,9 +180,11 @@
 
 search::
     Search for an available port whose name matches a regular expression.
-    For example:
++
+For example:
++
 --------
-    port search vim
+port search vim
 --------
 
 info::
@@ -193,15 +201,17 @@
     when no options at all are specified to info. If the option *--index* is
     provided, the information will be pulled from the PortIndex rather than
     from the Portfile. In this case variant information, such as
-    dependencies, will not affect the output. +
-    For example:
+    dependencies, will not affect the output.
++
+For example:
++
 --------
-    port info vim +ruby
-    port info --category --name apache*
-    port -q info --category --name --version category:java
-    port info --line --category --name all
-    port info --pretty --fullname --depends gtk2
-    port info --index python24
+port info vim +ruby
+port info --category --name apache*
+port -q info --category --name --version category:java
+port info --line --category --name all
+port info --pretty --fullname --depends gtk2
+port info --index python24
 --------
 
 variants::
@@ -220,12 +230,14 @@
 uninstall::
     Deactivate and uninstall portname. To uninstall all installed but
     'inactive' ports, use *-u*. To recursively uninstall all dependents of
-    this port, use *--follow-dependents*. +
-    For example:
+    this port, use *--follow-dependents*.
++
+For example:
++
 --------
-    port uninstall vim
-    port -u uninstall
-    port uninstall --follow-dependents python24
+port uninstall vim
+port -u uninstall
+port uninstall --follow-dependents python24
 --------
 
 activate::
@@ -247,22 +259,30 @@
 
 provides::
     Determines which port owns a given file and can take either a relative or
-    absolute path. For example:
+    absolute path.
++
+For example:
++
 --------
-    port provides /opt/local/etc/irssi.conf
-    port provides include/tiff.h
+port provides /opt/local/etc/irssi.conf
+port provides include/tiff.h
 --------
 
 sync::
     Performs a sync operation only on the ports tree of a MacPorts installation,
     pulling in the latest revision available of the Portfiles from the MacPorts
-    rsync server. To update you would normally do:
-    
-        sudo port -d sync
-    
-    If any of the ports tree(s) uses a file: URL that points to a local
-    subversion working copy, sync will perform an svn update on the working
-    copy with the user set to the owner of the working copy.
+    rsync server.
++
+To update you would normally do:
++
+--------
+sudo port -d sync
+--------
++
+If any of the ports tree(s) uses a file: URL that points to a local
+subversion working copy, sync will perform an svn update on the working
+copy with the user set to the owner of the working copy.
++
 
 outdated::
     Lists the installed ports which need a 'upgrade'.
@@ -270,40 +290,48 @@
 upgrade::
     The upgrade target works on a port and its dependencies. If you want to
     change this behavior, look at the switches for *-n* (no dependencies) and
-    *-R* (dependents) above. +
-    Upgrade the installed 'portname'. For example:
+    *-R* (dependents) above.
++
+--
+Upgrade the installed 'portname'. For example:
 --------
-    port upgrade vim
+port upgrade vim
 --------
 
-    To upgrade all outdated ports:
+To upgrade all outdated ports:
+
 --------
-    port upgrade outdated
+port upgrade outdated
 --------
 
-    To upgrade 'portname' and the ports that depend on it:
+To upgrade 'portname' and the ports that depend on it:
+
 --------
-    port -R upgrade libiconv
+port -R upgrade libiconv
 --------
 
-    To force a rebuild use:
+To force a rebuild use:
+
 --------
-    port -fn upgrade vim
+port -fn upgrade vim
 --------
 
-    To upgrade 'portname' without following its dependencies before, use *-n*.
-    For example:
+To upgrade 'portname' without following its dependencies before, use *-n*.
+
+For example:
+
 --------
-    port -n upgrade wireshark
+port -n upgrade wireshark
 --------
 
-     Note that in selecting the variants to use in the upgraded build of the
-     port, any variants specified on the command line take highest precedence,
-     then the variants active in the latest installed version of the port, and
-     finally the global variants specified in variants.conf, if any.  Note that
-     upgrade will not normally rebuild a port only to change the selected
-     variants; you can either specify *-f*, or deactivate the port and reinstall
-     it with different variants.
+[NOTE]
+By selecting the variants to use in the upgraded build of the port,
+any variants specified on the command line take highest precedence, then the
+variants active in the latest installed version of the port, and finally the
+global variants specified in variants.conf, if any. Note that upgrade will not
+normally rebuild a port only to change the selected variants; you can either
+specify *-f*, or deactivate the port and reinstall it with different variants.
+--
 
 clean::
     Clean the files used for building 'portname'. To just remove the work files,
@@ -311,33 +339,43 @@
     To remove the distribution files (fetched tarballs, patches, etc), specify
     *--dist*. To remove the archive(s) for the current version of a port, pass
     *--archive*. To remove the work files, distribution files and archives, pass
-    *--all*. For example:
+    *--all*.
++
+--
+For example:
+
 --------
-    port clean --dist vim
-    port clean --archive vim
+port clean --dist vim
+port clean --archive vim
 --------
-    To remove only certain version(s) of a port's archives (version is any
-    valid UNIX glob pattern), you can use:
+
+To remove only certain version(s) of a port's archives (version is any
+valid UNIX glob pattern), you can use:
+
 --------
-    port clean --archive vim 6.2.114
+port clean --archive vim 6.2.114
 --------
 
-    or:
+or:
 
 --------
-    port clean --archive vim '6.*'
+port clean --archive vim '6.*'
 --------
+--
 
 echo::
     Writes to stdout the arguments passed to 'port'. This follows the expansion
     of 'pseudo-portnames', portname glob patterns, 'pseudo-portname selectors'
     and the evaluation of port expressions.  *echo* may be used to determine the
     exact set of ports to which a given string of arguments will expand, without
-    performing any further operations on them. For example:
+    performing any further operations on them.
++
+For example:
++
 --------
-    port echo category:net
-    port echo maintainer:jmpp and name:netw
-    port echo maintainer:jmpp and \( net* or category:text \)
+port echo category:net
+port echo maintainer:jmpp and name:netw
+port echo maintainer:jmpp and \( net* or category:text \)
 --------
 
 list::
@@ -363,17 +401,21 @@
 selfupdate::
     Updates the MacPorts system, ports tree(s) and base tools if needed, from
     the MacPorts rsync server, installing the newest infrastructure available.
-    To update you would typ- ically do:
++
+To update you would typically do:
++
 --------
-    sudo port -d selfupdate
+sudo port -d selfupdate
 --------
-    See 'sync' for more information about updating ports tree(s).
++
+See 'sync' for more information about updating ports tree(s).
 
 load::
     Provides a shortcut to using launchctl to load a port's daemon (as installed
     in /Library/LaunchDaemons). It runs:
++
 --------
-    launchctl load -w /Library/LaunchDaemons/org.macports.${port}.plist
+launchctl load -w /Library/LaunchDaemons/org.macports.${port}.plist
 --------
 
 unload::
@@ -420,9 +462,12 @@
     Opens Portfile with your default editor specified in your shell's
     environment variable. Alias 'ed' also invokes this command. +
     You can also use the --editor flag on the command line to specify an alternative edi-
-    tor. For example:
+    tor.
++
+For example:
++
 --------
-    port edit --editor nano apache2
+port edit --editor nano apache2
 --------
 
 unarchive::
@@ -507,8 +552,10 @@
 
 EXAMPLES
 --------
+
 The following demonstrates invoking port with the extract target on portdir
 ``textproc/figlet'' and extract.suffix set to ``.tgz'':
+
 --------
 port extract -D textproc/figlet extract.suffix=.tgz
 --------
@@ -516,14 +563,14 @@
 FILES
 -----
 
-${prefix}/etc/macports/macports.conf::
+$\{prefix\}/etc/macports/macports.conf::
     Global configuration file for the MacPorts system.
 
-${prefix}/etc/macports/sources.conf::
+$\{prefix\}/etc/macports/sources.conf::
     Global listing of the ports trees used by MacPorts. This file also enables
     rsync synchronization.
 
-${prefix}/etc/macports/variants.conf::
+$\{prefix\}/etc/macports/variants.conf::
     Global variants used when a port is installed.
 
 ~/.macports/macports.conf::
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090407/6da241d5/attachment-0001.html>


More information about the macports-changes mailing list