[bind10-dev] copyright or explanation for python wrapper _inc.cc files

[JINMEI Tatuya / 神明達哉]

At Mon, 21 May 2012 10:19:43 -0500 (CDT),
"Jeremy C. Reed" <jreed at isc.org> wrote:

> Should we add a copyright to the following python wrappers? And/or add a 

Maybe.  But they are semi auto-generated files, so it may not matter
much.

In any case the more fundamental question is how we want to provide
python documentation for modules provided via C++ wrapper.  xxx_inc
was an attempt to provide reasonably detailed pydoc while reusing the
corresponding C++ doxygen doc as much as possible.  I personally found
it (=detailed pydoc for them, regardless of how we generate it)
useful for my own development, but it doesn't seem to be used by many
others.  Depending on how we should actually provide the doc, specific
issues regarding _inc files may become moot.

> comment to top of each file that says what it came from or to point to 
> instructions for maintaining.  Or include a README in each directory 
> (with the copyright if relevant for generated files). Some have a 
> README, but some don't.
> 
> src/lib/python/isc/datasrc/iterator_inc.cc
> src/lib/python/isc/datasrc/client_inc.cc
> src/lib/python/isc/datasrc/finder_inc.cc
> src/lib/python/isc/datasrc/updater_inc.cc
> src/lib/python/isc/datasrc/journal_reader_inc.cc
> 
> src/lib/python/isc/util/cio/socketsessionforwarder_inc.cc
> src/lib/python/isc/util/cio/socketsessionreceiver_inc.cc
> src/lib/python/isc/util/cio/socketsession_inc.cc
> 
> src/lib/python/isc/acl/dns_requestacl_inc.cc
> src/lib/python/isc/acl/dns_requestcontext_inc.cc
> src/lib/python/isc/acl/dns_requestloader_inc.cc
> src/lib/python/isc/acl/dnsacl_inc.cc
> 
> src/lib/dns/python/nsec3hash_python_inc.cc
> src/lib/dns/python/tsigerror_python_inc.cc
> src/lib/dns/python/message_python_inc.cc

---
JINMEI, Tatuya