Changeset 37464 for trunk/doc-new


Ignore:
Timestamp:
Jun 8, 2008, 9:31:09 PM (11 years ago)
Author:
markd@…
Message:

Minor refinements to port style section.

File:
1 edited

Legend:

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

    r37419 r37464  
    718718      <para>The left column should consist of single words, and will be
    719719      separated from the more complex right side by spaces in multiples of
    720       four. Variable assignments ("set libver") and variant declarations
    721       ("variant mysql5") are exceptions, and may be considered a single word
    722       on the left side, with a single space between words.</para>
     720      four. Variable assignments and variant declarations are exceptions, and
     721      may be considered a single word on the left side, with a single space
     722      between words.</para>
     723
     724      <programlisting>set libver "8.5"
     725
     726
     727variant mysql5 { ... }</programlisting>
    723728
    724729      <para>Frequently multiple items are necessary in the second column. For
    725730      example, to set multiple source download locations, multiple
    726731      "master_sites" must be defined. Unless the second column items are few
    727       and short you should use multiple lines, separate lines with a
    728       backslash, and (to emphasize the unity of the block) indent the lines
    729       after the first at a deeper level as shown in this example.</para>
    730 
    731       <programlisting>destroot.keepdirs   ${destroot}${prefix}/var/run \
    732                     ${destroot}${prefix}/var/log \
    733                     ${destroot}${prefix}/var/cache/mrtg</programlisting>
     732      and short you should place each additional item on a new line and
     733      separate lines with a backslash. Indent the lines after the first line
     734      to make it clear the items are second column values and also to
     735      emphasize the unity of the block.</para>
     736
     737      <programlisting>destroot.keepdirs    ${destroot}${prefix}/var/run \
     738                     ${destroot}${prefix}/var/log \
     739                     ${destroot}${prefix}/var/cache/mrtg</programlisting>
    734740    </section>
    735741
Note: See TracChangeset for help on using the changeset viewer.