summaryrefslogtreecommitdiffstats
path: root/contrib/ntp/html/patches.htm
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/ntp/html/patches.htm')
-rw-r--r--contrib/ntp/html/patches.htm70
1 files changed, 70 insertions, 0 deletions
diff --git a/contrib/ntp/html/patches.htm b/contrib/ntp/html/patches.htm
new file mode 100644
index 0000000..154d4b8
--- /dev/null
+++ b/contrib/ntp/html/patches.htm
@@ -0,0 +1,70 @@
+<html><head><title>
+Patching Procedures
+</title></head><body><h3>
+Patching Procedures
+</h3>
+
+<IMG align=left SRC=pic/rabbit.gif>From <i>pogo</i>, Walt Kelly
+<br clear=left><hr>
+
+<p>A distribution so widely used as this one eventually develops
+numerous barnacles as the result of <a href=porting.htm>porting</a>
+to new systems, idiosyncratic new features and just plain bugs. In order
+to help keep order and make maintenance bearable, we ask that proposed
+changes to the distribution be submitted in the following form.
+
+<ol>
+
+<p><li>Please submit patches to <a href=mailto:mills@udel.edu>David L.
+Mills &lt;mills@udel.edu&gt;</a> in the form of either unified-diffs
+(<tt>diff -u</tt>) or context-diffs (<tt>diff -c</tt>).</li>
+
+<p><li>Please include the <strong>output</strong> from
+<tt>config.guess</tt> in the description of your patch. If
+<tt>config.guess</tt> does not produce any output for your machine,
+please fix that, too!</li>
+
+<p><li>Please base the patch on the root directory of the distribution.
+The preferred procedure here is to copy your patch to the root directory
+and mumble</li>
+
+<p><tt>patch -p &lt;your_patch&gt;</tt></li>
+
+<p><li>Please avoid patching the RCS subdirectories; better yet, clean
+them out before submitting patches.</li>
+
+<p><li>If you have whole new files, as well as patches, wrap the files
+and patches in a shell script. If you need to compress it, use either
+GNU zip or the stock Unix compress utility.</li>
+
+<p><li>Don't forget the documentation that may be affected by the patch.
+Send us patches for the <tt>./html</tt> files as well. See the <a
+href=htmlprimer.htm>A Beginner's Guide to HTML</a> page for a
+tutorial.</li>
+
+<p><li>We would be glad to include your name, electric address and
+descriptive phrase in the <a href=copyright.htm>Copyright</a> page,
+if you wish.</li>
+
+</ol>
+
+<p>Prior to ntp3-5.83 (releases up to and including ntp3.5f) a
+complete patch history back to the dark ages was kept in the
+<tt>./patches</tt> directory, which might have been helpful to see
+if the same problem occured in another port, etc. Patches were saved in
+that directory with file name in the form <tt>patch.<i>nnn</i></tt>,
+where <i>nnn</i> was approaching 200. All patches in that directory have
+been made; so, if yours was there, it was in the distribution.
+
+<p>Since we have been getting multple patches for some bugs, plus many
+changes are implemented locally, no two maintainers here use the same
+tools, and since we're not using any bug-tracking software or even
+source code control, there is currently no tracking of specific changes.
+
+<p>The best way to see what's changed between two distributions is to
+run a <tt>diff</tt> against them.
+<p>Thanks for your contribution and happy chime.
+
+<hr><a href=index.htm><img align=left src=pic/home.gif></a><address><a
+href=mailto:mills@udel.edu> David L. Mills &lt;mills@udel.edu&gt;</a>
+</address></a></body></html>
OpenPOWER on IntegriCloud