Changeset 31753 for trunk/doc-new/man


Ignore:
Timestamp:
Dec 6, 2007, 1:44:48 AM (12 years ago)
Author:
boeyms@…
Message:

Additions to draft port(1) DocBook XML source.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/man/xml/port.1.xml

    r31428 r31753  
    4141      <arg>-F <replaceable>cmdfile</replaceable></arg>
    4242                        -->
    43                         <arg><replaceable>options</replaceable></arg>
     43      <group>
     44        <synopfragmentref linkend="options">options</synopfragmentref>
     45      </group>
    4446                        <group>
    4547                                <arg choice="plain"><replaceable>action</replaceable></arg>
     
    5557      </group>
    5658                        -->
    57                         <arg rep="repeat"><replaceable>target</replaceable>&nbsp;</arg>
     59                        <group rep="repeat"><synopfragmentref linkend="target">
     60                                        target</synopfragmentref>&nbsp;</group>
    5861                        <!--
    5962                        <group rep="repeat">
     
    7174                                <replaceable>setting</replaceable>=<replaceable>value</replaceable>&nbsp;
    7275                        </arg>
     76      <synopfragment id="options">
     77        <arg>-vdqfonRusbckixpt</arg>
     78        <arg>-D <replaceable>portdir</replaceable></arg>
     79        <arg>-F <replaceable>cmdfile</replaceable></arg>
     80      </synopfragment>
     81
     82      <synopfragment id="target">
     83        <group>
     84          <arg choice="plain"><replaceable>portname</replaceable></arg>
     85          <arg choice="plain"><replaceable>pseudo-portname</replaceable></arg>
     86          <arg choice="plain"><replaceable>port-url</replaceable></arg>
     87        </group>
     88                                <sbr />
     89                                <group rep="repeat">
     90                                        <arg>
     91                                                <replaceable>@version</replaceable>
     92                                        </arg>
     93                                        <group rep="repeat">
     94                                                <arg choice="plain">
     95                                                        +<replaceable>variant</replaceable>
     96                                                </arg>
     97                                                <arg choice="plain">
     98                                                        -<replaceable>variant</replaceable>
     99                                                </arg>
     100                                        </group>
     101                                        &#xA0;
     102                                </group>
     103      </synopfragment>
     104
    73105    </cmdsynopsis>
    74106  </refsynopsisdiv>
     
    114146
    115147  <refsection>
     148    <title>GLOBAL OPTIONS</title>
     149
     150    <variablelist>
     151      <varlistentry>
     152        <term><option>-q</option></term>
     153
     154        <listitem>
     155          <para>quiet mode (suppress messages)</para>
     156        </listitem>
     157      </varlistentry>
     158
     159      <varlistentry>
     160        <term><option>-v</option></term>
     161
     162        <listitem>
     163          <para>verbose mode (generate verbose messages)</para>
     164        </listitem>
     165      </varlistentry>
     166
     167      <varlistentry>
     168        <term><option>-n</option></term>
     169
     170        <listitem>
     171          <para>debug mode (generate debugging messages, implies
     172          <option>-v</option>)</para>
     173        </listitem>
     174      </varlistentry>
     175
     176      <varlistentry>
     177        <term><option>-n</option></term>
     178
     179        <listitem>
     180          <para>don&rsquo;t follow dependencies in upgrade (only for
     181          upgrading)</para>
     182        </listitem>
     183      </varlistentry>
     184
     185      <varlistentry>
     186        <term><option>-R</option></term>
     187
     188        <listitem>
     189          <para>also upgrade dependents (only for upgrading)</para>
     190        </listitem>
     191      </varlistentry>
     192
     193      <varlistentry>
     194        <term><option>-u</option></term>
     195
     196        <listitem>
     197          <para>uninstall non-active ports when upgrading and
     198          uninstalling</para>
     199        </listitem>
     200      </varlistentry>
     201
     202      <varlistentry>
     203        <term><option>-f</option></term>
     204
     205        <listitem>
     206          <para>force mode (ignore state file)</para>
     207        </listitem>
     208      </varlistentry>
     209
     210      <varlistentry>
     211        <term><option>-o</option></term>
     212
     213        <listitem>
     214          <para>honor state files older than Portfile</para>
     215        </listitem>
     216      </varlistentry>
     217
     218      <varlistentry>
     219        <term><option>-s</option></term>
     220
     221        <listitem>
     222          <para>source-only mode (build and install from source, ignore all
     223          binary archives, do not create/recreate binary archives) (only
     224          applies when archive mode is enabled)</para>
     225        </listitem>
     226      </varlistentry>
     227
     228      <varlistentry>
     229        <term><option>-b</option></term>
     230
     231        <listitem>
     232          <para>binary-only mode (build and install from binary archives,
     233          ignore source, abort if no archive present; do not create/recreate
     234          binary archives from source) (only applies when archive mode is
     235          enabled)</para>
     236        </listitem>
     237      </varlistentry>
     238
     239      <varlistentry>
     240        <term><option>-c</option></term>
     241
     242        <listitem>
     243          <para>autoclean mode (execute clean after install)</para>
     244        </listitem>
     245      </varlistentry>
     246
     247      <varlistentry>
     248        <term><option>-k</option></term>
     249
     250        <listitem>
     251          <para>keep mode (don't autoclean after install)</para>
     252        </listitem>
     253      </varlistentry>
     254
     255      <varlistentry>
     256        <term><option>-D</option></term>
     257
     258        <listitem>
     259          <para>specify <replaceable>portdir</replaceable>, the home directory
     260          for a port (see ... below)</para>
     261        </listitem>
     262      </varlistentry>
     263
     264      <varlistentry>
     265        <term><option>-F</option></term>
     266
     267        <listitem>
     268          <para>Read and process the <replaceable>file</replaceable> of
     269          commands specified by the argument. If the argument is '-', then
     270          read commands from stdin. If the option is given multiple times,
     271          then multiple files will be read.</para>
     272        </listitem>
     273      </varlistentry>
     274
     275      <varlistentry>
     276        <term><option>-i</option></term>
     277
     278        <listitem>
     279          <para>Read commands from stdin. Short for <option>-F</option>
     280          -</para>
     281        </listitem>
     282      </varlistentry>
     283
     284      <varlistentry>
     285        <term><option>-x</option></term>
     286
     287        <listitem>
     288          <para>In batch and interactive mode, exit on the first error
     289          encountered. Otherwise, errors during batch execution are simply
     290          reported.</para>
     291        </listitem>
     292      </varlistentry>
     293
     294      <varlistentry>
     295        <term><option>-p</option></term>
     296
     297        <listitem>
     298          <para>Despite any errors encountered, proceed to process multiple
     299          ports and commands.</para>
     300        </listitem>
     301      </varlistentry>
     302
     303      <varlistentry>
     304        <term><option>-t</option></term>
     305
     306        <listitem>
     307          <para>enable trace mode debug facilities on platforms that support
     308          it (Mac OS X). This feature is two-folded. It consists in
     309          automatically detecting and reporting undeclared dependencies based
     310          on what files the port reads or what programs the port executes. In
     311          verbose mode, it will also report unused dependencies for each stage
     312          of the port installation. It also consists in forbidding and
     313          reporting file creation and file writes outside allowed directories
     314          (temporary directories and <varname>${workpath}</varname>).</para>
     315        </listitem>
     316      </varlistentry>
     317    </variablelist>
     318  </refsection>
     319
     320  <refsection>
    116321    <title>SEE ALSO</title>
    117322
Note: See TracChangeset for help on using the changeset viewer.