Changeset 31024 for trunk/doc-new


Ignore:
Timestamp:
Nov 14, 2007, 5:03:46 AM (12 years ago)
Author:
markd@…
Message:

Move the text in the "document conventions" section into the intro body; it is awkward
to have a single subsection in the TOC for the intro chapter.

File:
1 edited

Legend:

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

    r28845 r31024  
    4646  descended from the Berkeley Software Distribution (BSD).</para>
    4747
    48   <section id="introduction.conventions">
    49     <title>Document Conventions</title>
     48  <para>The following notational conventions are used in the MacPorts Guide to
     49  distinguish between terminal input/output, file text, and other special text
     50  types.</para>
    5051
    51     <para>The MacPorts Guide uses some notational conventions to distinguish
    52     between terminal input/output, file text, and other special text
    53     types.</para>
     52  <itemizedlist>
     53    <listitem>
     54      <para>Terminal I/O and file text.</para>
    5455
    55     <itemizedlist>
    56       <listitem>
    57         <para>Terminal I/O and file text.</para>
     56      <programlisting><prompt>%% </prompt><userinput>Commands to be typed into a terminal window.</userinput></programlisting>
    5857
    59         <programlisting><prompt>%% </prompt><userinput>Commands to be typed into a terminal window.</userinput></programlisting>
     58      <screen>Command output to a terminal window.</screen>
    6059
    61         <screen>Command output to a terminal window.</screen>
     60      <programlisting>File text.</programlisting>
     61    </listitem>
    6262
    63         <programlisting>File text.</programlisting>
    64       </listitem>
     63    <listitem>
     64      <para>Other special text types.</para>
    6565
    66       <listitem>
    67         <para>Other special text types.</para>
     66      <para>A hyperlink: <ulink
     67      url="http://en.wikipedia.org/wiki/Spontaneous_combustion">spontaneous
     68      combustion</ulink>.</para>
    6869
    69         <para>A hyperlink: <ulink
    70         url="http://en.wikipedia.org/wiki/Spontaneous_combustion">spontaneous
    71         combustion</ulink>.</para>
     70      <para>A file: <filename>/var/log/system.log</filename>.</para>
    7271
    73         <para>A file: <filename>/var/log/system.log</filename>.</para>
     72      <para>A command: <command>ifconfig</command>.</para>
    7473
    75         <para>A command: <command>ifconfig</command>.</para>
    76 
    77         <para>An option: port <option>install</option></para>
    78       </listitem>
    79     </itemizedlist>
    80   </section>
     74      <para>An option: port <option>install</option></para>
     75    </listitem>
     76  </itemizedlist>
    8177</chapter>
Note: See TracChangeset for help on using the changeset viewer.