from Francisco Alcoba: mention TortoiseSVN diff and patch features
authorulfl <ulfl@f5534014-38df-0310-8fa8-9805f1628bb7>
Thu, 14 Oct 2004 18:05:39 +0000 (18:05 +0000)
committerulfl <ulfl@f5534014-38df-0310-8fa8-9805f1628bb7>
Thu, 14 Oct 2004 18:05:39 +0000 (18:05 +0000)
git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@12298 f5534014-38df-0310-8fa8-9805f1628bb7

docbook/edg_src/EDG_chapter_sources.xml
docbook/edg_src/EDG_chapter_tools.xml

index ea7606941adc15133c07e8dc563909e6e5e6369b..ca186936ede4b813f9493d2ae8e01e228cdc5bba 100644 (file)
@@ -581,7 +581,30 @@ diff -ur ../ethereal-0.10.6/epan/dissectors/packet-dcerpc.c ./epan/dissectors/pa
        have a built-in "diff" feature.
        </para>
        <para>
-       XXX - add details at least for recommended TortoiseSVN
+       If you use TortoiseSVN:
+       </para>
+       <para>
+       TortoiseSVN (to be precise subversion) keeps track of the files you have 
+       changed in the directories it controls, and will generate for you a 
+       unified diff file compiling the differences. To do so - after updating 
+       your sources from the SVN repository if needed - just right-click on the 
+       highest level directory and choose "TortoiseSVN" -> "Create patch...". 
+       You will be asked for a name and then the diff file will be created. The 
+       names of the files in the patch will be relative to the directory you have 
+       right-clicked on, so it will need to be applied on that level too.
+       </para>
+       <para>
+       When you create the diff file, it will include any difference TortoiseSVN 
+       finds in files in and under the directory you have right-clicked on, and 
+       nothing else. This means that changes you might have made for your 
+       specific configuration - like modifying "config.nmake" so that it uses 
+       your lib directory - will also be included, and you will need to remove 
+       these lines from the diff file. It also means that only changes will be 
+       recorded, i.e. if you have created new files -say, a new packet-xxx for a 
+       new protocol dissector- it will not be included in the diff, you need to 
+       add it separately. And, of course, if you have been working separately in 
+       two different patches, the .diff file will include both topics, which is 
+       probably not a good idea.
        </para>
        </section>
 
index 11c91b1ce414407446fbec83a26c8bff3ec27165..3384cf26194444efb3632cbf8efd52cd5af92ab3 100644 (file)
@@ -1059,7 +1059,14 @@ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.]]>
        <section id="ChToolsWin32Diff">
        <title>Win32 native: -</title>
        <para>
-       The authors don't know of any working win32 native diff implementation.
+       The authors don't know of any win32 native command line diff 
+       implementation. 
+       </para>
+       <para>
+       The subversion client TortoiseSVN has a build in diff feature, see 
+       <xref linkend="ChToolsTortoiseSVN"/>. If this can be used to create diff 
+       files in the required format, so other persons can use them, is currently 
+       unknown.
        </para>
        </section>
 
@@ -1126,6 +1133,11 @@ written by Larry Wall and Paul Eggert]]>
        <para>
        The authors don't know of any working win32 native patch implementation.
        </para>
+       <para>
+       The subversion client TortoiseSVN has a build in patch feature, see 
+       <xref linkend="ChToolsTortoiseSVN"/>. The last time tested (Version 1.1.0), 
+       this feature failed to apply patches known to be ok.
+       </para>
        </section>
 
        </section>