Changeset 105186 for trunk/doc-new


Ignore:
Timestamp:
Apr 13, 2013, 12:10:26 AM (7 years ago)
Author:
ryandesign@…
Message:

portfile-keywords.xml: clarify that comments can precede the PortSystem line, and that PortGroup lines can follow it. Mention the convention of changing "+" to "x" in port names.

File:
1 edited

Legend:

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

    r87570 r105186  
    2020
    2121      <listitem>
    22         <para>The top line of every Portfile; it must be followed by a blank
    23         line. It defines which version of the Portfile interpreter will be
    24         used.</para>
     22        <para>The first non-comment line of every Portfile; it should be
     23        followed by PortGroup inclusions (if any) and then a blank line.
     24        It defines which version of the Portfile interpreter will be used.
     25        (There is currently only one version.)</para>
    2526
    2627        <programlisting>PortSystem          1.0
     
    3637        <para>The name of the port. To avoid special interpretation by shells
    3738        and the like, names should contain only alphanumeric characters,
    38         underscores, dashes or dots.</para>
     39        underscores, dashes or dots. For projects whose proper names contain
     40        "+" characters, change these to "x" (i.e. "libstdc++" becomes
     41        "libstdcxx").</para>
    3942
    4043        <programlisting>name                foo</programlisting>
Note: See TracChangeset for help on using the changeset viewer.