Attached is a first draft of a python binding document for which we would like to get feedback and comments.
Author names are mixed up - some on left and some on right Status: As SAGA -> As a SAGA so-far -> currently defined Copyright notice 2007-2010 -> 2012 2 SAGA Python Bindings last para. I don't think you should refer to these as class prototypes as the notion is not part of python. Instead just say: The explicit python bindings are listed in Appendix A. 2.1 Para 1 sentence 2 -> While we expect that language bindings will, in general, follow that hierarchy for Python it is not useful to do so. Omit 2.1 para 3 2.1.1 CAN -> MAY 2.1.2 Omit last two sentences 2.1.2 wrong kind of opening quote before "namespace" - this appears elsewhere too - a global edit with a regexp should find them 2.2 as lightly -> a slightly 2.2 add to text before bullet points: "they" 2.2 The reference for Python naming conventions is: http://www.python.org/dev/peps/pep-0008 2.4 -> The SAGA API includes a number of enums, which are usually related to classes within a specifi c API package. Python does not have a native notion of enums. We follow the recommendation in pep-0008 to define constants on a module level, written in all capital letters with underscores separating words. 2.5 Omit this section - it will be hard to get right and will just cause confusion 4.4 2007 -> 2012 Appendix A - This should start with an explananation of how to interpret what follows I will send comments on the contents of Appendix A as a separate email Steve