[31428] trunk/doc-new/man/xml/port.1.xml

boeyms at macports.org boeyms at macports.org
Thu Nov 22 16:31:05 PST 2007


Revision: 31428
          http://trac.macosforge.org/projects/macports/changeset/31428
Author:   boeyms at macports.org
Date:     2007-11-22 16:31:04 -0800 (Thu, 22 Nov 2007)

Log Message:
-----------
port.1.xml: Beginnings of a new DocBook man page for port(1).

Added Paths:
-----------
    trunk/doc-new/man/xml/port.1.xml

Added: trunk/doc-new/man/xml/port.1.xml
===================================================================
--- trunk/doc-new/man/xml/port.1.xml	                        (rev 0)
+++ trunk/doc-new/man/xml/port.1.xml	2007-11-23 00:31:04 UTC (rev 31428)
@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<refentry>
+  <refmeta>
+    <refentrytitle>PORT</refentrytitle>
+    <manvolnum>1</manvolnum>
+		<refmiscinfo role="name">The MacPorts Project</refmiscinfo>
+		<refmiscinfo role="productname">MacPorts</refmiscinfo>
+		<refmiscinfo role="productnumber">1.6</refmiscinfo>
+  </refmeta>
+
+  <refnamediv>
+    <refname>port</refname>
+
+    <refpurpose>operate on individual or multiple Mac ports</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>port</command>
+			<!-- Detailed option description omitted in favour of general one
+			<group>
+				<arg choice="plain">-v</arg>
+				<arg choice="plain">-d</arg>
+				<arg choice="plain">-q</arg>
+			</group>
+			<group>
+				<arg choice="plain">-n</arg>
+				<arg choice="plain">-R</arg>
+			</group>
+			<group>
+				<arg choice="plain">-s</arg>
+				<arg choice="plain">-b</arg>
+			</group>
+			<group>
+				<arg choice="plain">-c</arg>
+				<arg choice="plain">-k</arg>
+			</group>
+      <arg>-D <replaceable>portdir</replaceable></arg>
+      <arg>-F <replaceable>cmdfile</replaceable></arg>
+			-->
+			<arg><replaceable>options</replaceable></arg>
+			<group>
+				<arg choice="plain"><replaceable>action</replaceable></arg>
+				<group>
+					<arg choice="plain"><replaceable>actionoptions</replaceable></arg>
+				</group>
+			</group>
+			<!--
+      <group>
+          <arg choice="plain"><replaceable>portname</replaceable></arg>
+          <arg choice="plain"><replaceable>pseudo-portname</replaceable></arg>
+          <arg choice="plain"><replaceable>port-url</replaceable></arg>
+      </group>
+			-->
+			<arg rep="repeat"><replaceable>target</replaceable>&nbsp;</arg>
+			<!--
+			<group rep="repeat">
+				<arg>
+					<replaceable>@version</replaceable>
+				</arg>
+				<group rep="repeat">
+					<arg choice="plain">
+						+/-<replaceable>variant</replaceable>
+					</arg>
+				</group>
+			</group>
+			-->
+			<arg rep="repeat">
+				<replaceable>setting</replaceable>=<replaceable>value</replaceable>&nbsp;
+			</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsection>
+    <title>Description</title>
+
+		<para>
+			<!--
+			<command>port</command> is designed to operate on individual or
+			multiple Mac <option>ports</option>, optionally within a single call,
+			based on the requested <option>action</option>.  If no
+			<option>portdir</option> or <option>portname</option> is specified, the
+			current working directory is assumed; if no <option>action</option> is
+			specified the port command enters interactive mode, in which commands are
+			read via stdin. Batch commands may be passed via a
+			<option>cmdfile</option>.  Port <option>options</option> are passed as
+			key=value pairs and take precedence over individual
+			<option>portname</option> options as specified in its Portfile and
+			system-wide settings.
+			-->
+			<command>port</command> is the command-line interface to the MacPorts
+			ports system.  It provides access to information about available ports and
+			allows the management of their installation, upgrading and removal.
+		</para>
+
+		<para>
+			When run without an <replaceable>action</replaceable>,
+			<command>port</command> enters an interactive mode interpreter where
+			multiple actions can be entered in succession.  Otherwise,
+			<command>port</command> acts like an ordinary command-line program.
+		</para>
+		<!--
+		<para>
+			Port <option>variants</option> can specified as
+			<option>+name</option>, which indicates the variant is desired, or
+			<option>-name</option>, indicating the contrary. In case of ambiguities, a
+			port can be fully specified with the
+			<option>@version_revision+variants</option> format.
+		</para>
+		-->
+  </refsection>
+
+  <refsection>
+    <title>SEE ALSO</title>
+
+    <para><citerefentry>
+        <refentrytitle>port</refentrytitle>
+
+        <manvolnum>1</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>macports.conf</refentrytitle>
+
+        <manvolnum>5</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>portgroup</refentrytitle>
+
+        <manvolnum>7</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>portstyle</refentrytitle>
+
+        <manvolnum>7</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>porthier</refentrytitle>
+
+        <manvolnum>7</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>file</refentrytitle>
+
+        <manvolnum>n</manvolnum>
+      </citerefentry></para>
+  </refsection>
+
+  <refsection>
+    <title>AUTHORS</title>
+
+    <para>Landon Fuller <email>landonf at macports.org</email></para>
+
+    <para>Juan Manuel Palacios <email>jmpp at macports.org</email></para>
+
+    <para>Mark Duling <email>markd at macports.org</email></para>
+
+    <para>Kevin Van Vechten <email>kevin at opendarwin.org</email></para>
+
+    <para>Jordan K. Hubbard <email>jkh at macports.org</email></para>
+
+    <para>Chris Ridd <email>cjr at opendarwin.org</email></para>
+
+    <para>Kevin Ballard <email>eridius at macports.org</email></para>
+
+    <para>Markus W. Weissmann <email>mww at macports.org</email></para>
+
+    <para>Boey Maun Suang <email>boeyms at macports.org</email></para>
+  </refsection>
+</refentry>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071122/d62dd775/attachment.html


More information about the macports-changes mailing list