Changeset 40979 for trunk/doc-new


Ignore:
Timestamp:
Oct 20, 2008, 4:03:28 AM (11 years ago)
Author:
markd@…
Message:

Edit the recent change to Creating Source Code Patches section. I'll contact
simon@ to see if his original intent has been followed.

File:
1 edited

Legend:

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

    r40919 r40979  
    537537      application.</para>
    538538
    539       <para>You should create one patch file for each file to be patched,
    540       though it is permissible to use existing patches you find that patch
    541       multiple files. Patchfile filenames should uniquely distinguish the file
     539      <para>Generally speaking, you should create one patch file for each file
     540      to be patched. Patchfile filenames should uniquely distinguish the file
    542541      and generally be of the form
    543542      <filename>patch-</filename><replaceable>&lt;directory&gt;</replaceable>-<replaceable>&lt;filename&gt;.diff</replaceable>,
     
    547546      port.</para>
    548547
    549       <para>If fixing an issues needs changes in multiple files all changes
    550       should be stored in one patch file. The patch should then be named after
    551       the issue which is fixed,
    552       <filename>patch-</filename><replaceable>&lt;issue&gt;.diff</replaceable>.</para>
     548      <para>You may use patch files that patch multiple files under these
     549      conditions:</para>
     550
     551      <itemizedlist>
     552        <listitem>
     553          <para>You find existing patch files that do so</para>
     554        </listitem>
     555
     556        <listitem>
     557          <para>If fixing a particular problem or bug requires changes in
     558          multiple files -in those cases the patch filename should reference
     559          the problem or bug, for example:
     560          <filename>patch-</filename><replaceable>&lt;destroot_variable_fix&gt;.diff</replaceable></para>
     561        </listitem>
     562      </itemizedlist>
     563
     564      <para>To create a patch to modify a single file, follow the steps
     565      below.</para>
    553566
    554567      <orderedlist>
Note: See TracChangeset for help on using the changeset viewer.