From: Josh J. <jun...@gm...> - 2009-07-28 04:07:39
|
Andrea- Thanks for the excellent feedback, please keep it coming. I will review each of your points and post a better reply later this week. I am limited to a blackberry keyboard until then and don't really enjoy typing on it. I can start by letting yoi know that it is very likely that some of the chapter may be formatted incorrectly or missing due to the Sphinx conversion. I did not give it a really heavy review once I converted, only a quick review. I will make note of each point you have presented. Thanks for your time, it is greatly appreciated. On 7/25/09, Andrea Aime <aa...@op...> wrote: > Hi, > I'm reading the online Jython book at: > http://jythonpodcast.hostjava.net/jythonbook > > On the IRC channel fwierzbicki suggested I send > any feedback about the book to the jython-dev mailing > list, so here it is: > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#reserved-words > -> the "if" keyword is missing > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#print-statement > -> all the jython examples are missing in this paragraph? > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#try-except-finally > -> leaves me wondering if the exceptions are in a class hierchy and if a > catch catches matching subclasses as well (like in java) and if it's > possible to make it catch multiple exception types > -> if you scroll down you'll get a sentence starting with > "Assert statements are used for ..." but there is no title about the > assert keyword. Also, nothing is said about skipping the asserts in > production code (is it possible? no idea). > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#other-python-statements > -> "References a variable a global" > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#while-loop > -> the code example in java should compute z inside the loop, but to > be fair, it should have the (x-y) expression in the println > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#for-loop > -> "we pass the value 10 into the range which gives us all values > between 0 and 10". With 10 excluded... when I read it I thought "nope, > between 0 and 9". May be a bit confusing, thought I don't have > suggestions on how to fix it. > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#continue-statement > -> "Why is this example useful? It’s not really…" :-) > Leaves me wondering if continue can be targeted to a label (if it is > possible, a more interesting example could be computing prime numbers > using the dumb algorithm) > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#break-statement > -> "x = 10 while x >= 0:" is not actually interpreted by the jython > interpreter: > ---- > x = 10 while x >= 0: > ^ > SyntaxError: no viable alternative at input 'while > ---- > A similar problem occurs also in an earlier example in the same page > > http://jythonpodcast.hostjava.net/jythonbook/chapter1.html#documenting-code > -> leaves me wondering if there is any javadoc like tool for jython > (a link would be sufficient) > > http://jythonpodcast.hostjava.net/jythonbook/chapter2.html#python-data-types > -> the says Numeric is a "Data type". Then what is "float"? A class? > >>> x.__class__ --> <type 'float'> > Does jython have the concept of primitive and Object like in Java, or > is everything an object? > > http://jythonpodcast.hostjava.net/jythonbook/chapter2.html#strings-and-string-methods > -> "rfind(sub[,start[,end]]) Searches and finds the first occurrence of > the given string" ... does not really tell the difference between find > and rfind, I guess rfind starts searching from the end of the > string? > > http://jythonpodcast.hostjava.net/jythonbook/chapter2.html#lists > -> "Much like the Array in the Java language, using the list[index] > notation will allow us to access an item". "Array" in Java is an utility > class, this might be confusing if the reader knows about it: > http://java.sun.com/j2se/1.5.0/docs/api/java/lang/reflect/Array.html > > http://jythonpodcast.hostjava.net/jythonbook/chapter2.html#list-comprehensions > -> the java example at the end does not do anything, does not change the > original array, does not create modified copy of it > > Well, enough for today, will post more as I move forward. > > Cheers > Andrea > > ------------------------------------------------------------------------------ > _______________________________________________ > Jython-dev mailing list > Jyt...@li... > https://lists.sourceforge.net/lists/listinfo/jython-dev > -- Sent from my mobile device Josh Juneau jun...@gm... http://jj-blogger.blogspot.com Twitter ID: javajuneau |