[Git][NTPsec/ntpsec][master] Document the requirement for Python.h and friends.

[Eric S. Raymond]

Eric S. Raymond pushed to branch master at NTPsec / ntpsec


Commits:
f816ccfa by Eric S. Raymond at 2016-10-20T17:27:31-04:00
Document the requirement for Python.h and friends.

- - - - -


2 changed files:

- INSTALL
- devel/hacking.txt


Changes:

=====================================
INSTALL
=====================================
--- a/INSTALL
+++ b/INSTALL
@@ -15,7 +15,9 @@ to run and in addition, the development headers installed to build.
 Python 2.x, x >= 6, or Python 3.x >= 3::
    Required to build, and for various scripts such as ntpviz.  Our
    Python code has been written polyglot to also run with production
-   versions of Python 3.
+   versions of Python 3.  Note that you will need both the ordinary
+   python intallation and Python dev tools, if your OS makes such
+   a distinction.
 
 bison::
    Required to build.


=====================================
devel/hacking.txt
=====================================
--- a/devel/hacking.txt
+++ b/devel/hacking.txt
@@ -16,8 +16,10 @@ due to multiple languages, we hold the set of allowed languages
 to a minimum.
 
 Time-critical code must be written in C. Use Python for any code that
-is not time-critical, as this reduces line count and complexity
-(thus, also, expected defect rates).
+is not time-critical, as this reduces line count and complexity (thus,
+also, expected defect rates). If you need a NTP-specific C function
+not available in Python, try to improve the libntpc extension to
+expose it.
 
 The only scripting language allowed and supported other than Python is
 POSIX sh (this is more restricted than bash!).  Python is preferred, as
@@ -101,8 +103,10 @@ close to that callsite as possible.
 
 === Coding style and indentation ==
 
-Dr. Dave Mills likes this code indented formatted in a consistent way.
-The file "dot.emacs" has the emacs C-mode indentation style that Dave likes.
+Dr. Dave Mills liked this code indented formatted in a consistent way.
+The file "dot.emacs" has the emacs C-mode indentation style that Dave
+likes. It's a bit archaic, but we've stuck with it to preserve
+continuity; you should, too.
 
 === Conventions for #ifdef guard names ===
 



View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/f816ccfabdce3d8cc88422f7a86bb32523744d7c
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ntpsec.org/pipermail/vc/attachments/20161020/2427fcf1/attachment.html>