Changeset 122833 for trunk/doc-new


Ignore:
Timestamp:
Jul 31, 2014, 3:22:23 PM (4 years ago)
Author:
cal@…
Message:

guide: Improve section on contributing enhancements

File:
1 edited

Legend:

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

    r122146 r122833  
    369369      <para>Enhancements to existing ports may comprise new functionality for
    370370      a given port, bug fixes or even simple version updates. They should
    371       always be contributed as <filename>Portfile</filename> patches. See
    372       Ticket Submission Guidelines above for a description of all
    373       fields.</para>
     371      always be contributed as patches against the current
     372      <filename>Portfile</filename>. See the <link
     373        linkend="project.tickets">Ticket Submission Guidelines</link> for
     374      a description of all fields.</para>
    374375
    375376      <orderedlist>
    376377        <listitem>
    377           <para>Create a <filename>Portfile</filename> patch with your changes
    378           as described in Portfile Development.</para>
     378          <para>Create a <filename>Portfile</filename> patch with your changes.
     379            See <link linkend="development">Portfile Development</link> for
     380            more information on how to edit Portfiles.</para>
     381        </listitem>
     382
     383        <listitem>
     384          <para>Please run
     385            <programlisting><prompt>%%</prompt> <userinput>port lint --nitpick $portname</userinput></programlisting>
     386            where <userinput>$portname</userinput> is the name of the port you
     387            modified. Please fix any warnings and errors before submitting your
     388            changes.</para>
    379389        </listitem>
    380390
     
    394404
    395405        <listitem>
     406          <para>Put the maintainer's email address into the
     407            <guilabel>Cc</guilabel> field. You can use
     408            <programlisting><prompt>%%</prompt> <userinput>port info --maintainer $portname</userinput></programlisting>
     409            where <userinput>$portname</userinput> is the name of the port you
     410            want to modify. Note that
     411            <email>openmaintainer@macports.org</email> and
     412            <email>nomaintainer@macports.org</email> are not real people and should thus not be Cc'd.</para>
     413        </listitem>
     414
     415        <listitem>
    396416          <para>Attach your Portfile patch file and any new or changed patch
    397           files (don't patch patches) to the ticket.</para>
     417            files to the ticket.</para>
     418        </listitem>
     419
     420        <listitem>
     421          <para>If your ticket doesn't receive any attention within a few days
     422            (for example, because the port you are trying to modify does not
     423            have a maintainer), you may email
     424            <email>macports-dev@lists.macosforge.org</email> and request
     425            a review and/or commit.</para>
    398426        </listitem>
    399427      </orderedlist>
Note: See TracChangeset for help on using the changeset viewer.