[27252] trunk/doc/guide/new/xml/portfiledev.xml

[source_changes at macosforge.org]

Revision: 27252
          http://trac.macosforge.org/projects/macports/changeset/27252
Author:   markd at macports.org
Date:     2007-07-25 19:04:55 -0700 (Wed, 25 Jul 2007)

Log Message:
-----------
Add an Portfile patch example.

Modified Paths:
--------------
    trunk/doc/guide/new/xml/portfiledev.xml

Modified: trunk/doc/guide/new/xml/portfiledev.xml
===================================================================
--- trunk/doc/guide/new/xml/portfiledev.xml	2007-07-25 23:14:43 UTC (rev 27251)
+++ trunk/doc/guide/new/xml/portfiledev.xml	2007-07-26 02:04:55 UTC (rev 27252)
@@ -379,11 +379,40 @@
         </listitem>
 
         <listitem>
-          <para>Now use the Unix command <command>diff</command> to create a
-          "unified" diff patch file.</para>
+          <para>Now use the Unix command <command>diff -u </command>to create
+          a "unified" diff patch file.</para>
 
           <programlisting><prompt>%%</prompt> <userinput>diff -u Portfile.org Portfile &gt; Portfile.diff</userinput></programlisting>
         </listitem>
+
+        <listitem>
+          <para>A patch file that is a "unified" diff file is the easiest to
+          interpret by humans and this type should always be used for ports.
+          The <filename>Portfile</filename> patch below will change the
+          version and checksums when applied.</para>
+
+          <programlisting>--- Portfile.org        2007-07-25 18:52:12.000000000 -0700
++++ Portfile    2007-07-25 18:53:35.000000000 -0700
+@@ -2,7 +2,7 @@
+ PortSystem             1.0
+ 
+ name                   nefu
+-version                        1.4.0
++version                        1.3.0
+ categories             net
+ maintainers            nomaintainer at macports.org
+ description            A network monitoring daemon.
+@@ -13,9 +13,9 @@
+
+ homepage               http://rsug.itd.umich.edu/software/${name}
+
+ master_sites           ${homepage}/files/
+-checksums              md5 f0953b21cdb5eb327e40d4b215110b71 \
++checksums              md5 01532e67a596bfff6a54aa36face26ae \
+ extract.suffix  .tgz
+ platforms              darwin
+</programlisting>
+        </listitem>
       </orderedlist>
 
       <para>Now you may attach the <filename>Portfile.diff</filename> to a
@@ -414,8 +443,8 @@
         </listitem>
 
         <listitem>
-          <para>Now use the Unix command <command>diff</command> to create a
-          "unified" diff patch file.</para>
+          <para>Now use the Unix command <command>diff -u</command> to create
+          a "unified" diff patch file.</para>
 
           <programlisting><prompt>%%</prompt> <userinput>cd foo-1.34</userinput>
 <prompt>%%</prompt> <userinput>diff -u Makefile.in.org Makefile.in &gt; patch-Makefile.in</userinput></programlisting>
@@ -429,7 +458,7 @@
         </listitem>
 
         <listitem>
-          <para>A patch made using "-u" ("unified") is the easiest to
+          <para>A patch file that is a "unified" diff file is the easiest to
           interpret by humans and this type should always be used for ports.
           See the example below where a patch adds <varname>DESTDIR</varname>
           support to a <filename>Makefile.in</filename> file.</para>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20070725/ae2e1f16/attachment.html