On Sat, Aug 1, 2009 at 3:21 AM, Kay Schluehr <firstname.lastname@example.org> wrote:
I do think Apress can market its books however it likes but I consider
it as a fraud when the relationship between Jython and Django is
practically immaterial and all there is about Django on Jython is that
it works. Well, it's still your book and you have to live with that.
IMO an evident starting point of improving Jythons documentation is the
"User guide". It needs more and a better structure ( and an enumeration
of sections ;) and at some points even less ( a major chapter for
JRealod? ). There are also major mistakes in the guide: since when are
Integer, Float and String Python types? Last time I looked at Python
those were named int, float and str...
I see 5 major sections right now:
1) Installation + Configuration of the Jython interpreter ( including a
mention of Netbeans which is incomplete BTW because the Netbeans plugin
lacks the registry file ).
2) Java compatibility. This includes type mappings, working with the
classpath but also reflecting Java properties. ( To work with Java
consistently some registry file settings have a wrong default value in
particular respectJavaAccessibility which must be set to false. If you
want full Java attribute access protection just use Java ).
3) Jython API and a technical perspective on JVM integration. This is
for potential Jython core developers. Embedding of Jython in other Java
applications can be handled in a subsection.
4) Compliancy with CPython. This covers major differences and utilities
5) Practical utilization of Java with examples of Servlets, Swing, JDBC