First of all - thanks for the detailed feedback. I am supposed to be going through the user guide and doing a final QA check before the 2.5.0 release so your email is timely. If you do find anything you can fix; the user guide is a wiki - feel free to apply fixes yourself.
I will reply again later when I have time, Jody Milton Jonathan wrote: > Dear Jody and all, > > I'm new to GeoTools, and when going through the User Guide I found some > inconsistencies that got me confused at the beginning (but great work > with documentation in general, thanks!). Actually, some of these seem to > be quite silly, but all together they slowed me down a little. > > Some of these issues also relate to a post sent by Ryan Moquin last january: > http://www.nabble.com/A-little-puzzled-about-geotools-and-Maven2-td14992010.html#a14992010 > > First thing relates to setting up Maven. In the "01 Welcome" section, > when we go to the items "03 First Project" and "04 How to Read a > Shapefile", the User Guide states that Maven dependencies should be set > up to things like "gt2-main", "gt2-shapefile", etc. (see > http://docs.codehaus.org/display/GEOTDOC/03+First+Project). Everything > works fine when using version 2.4.4, however Maven couldn't find those > dependencies when I configured it to use 2.5-M3 (which is what the User > Guide is talking about). I tried using 2.5-SNAPSHOT, which Maven does > find, but it then gives me lots of problems when trying to run these > first examples. In the end, I found out that everything works properly > if I just switch those Maven dependencies to "gt-main" and > "gt-shapefile" (without the 2). Is this really the right thing to do? > (if it is, then let's correct the Guide!) > > Other than that, I also found some issues in the "09 Main" section, when > trying out building FeatureTypes in item "03 SimpleFeatureTypeBuilder > and SimpleFeatureBuilder" > (http://docs.codehaus.org/display/GEOTDOC/03+SimpleFeatureTypeBuilder+and+SimpleFeatureBuilder) > > The first example there explains how to use a "SimpleTypeBuilder", > however that class is not found anywhere, as Ryan also found out in that > post. I guess that this class should be "SimpleFeatureTypeBuilder", as > in the title of the section, right? > > Further on, the second example in the same page talks about using the > method "CommonFactoryFinder.getSimpleTypeFeatureFactory" to retrieve a > "SimpleTypeFactory" object. However, I couldn't find neither of those > classes. Here, I haven't yet played around to find out how to do it > right - maybe SimpleTypeFactory should be replaced by > FeatureTypeFactoryImpl? Or maybe DefaultFeatureTypeFactory2? > > Finally, it also looks like the method "DataUtilities.create" used in > the end of that page should read "DataUtilities.createType". > > Thanks for all! > Milton > > > > ------------------------------------------------------------------------- > This SF.Net email is sponsored by the Moblin Your Move Developer's challenge > Build the coolest Linux based applications with Moblin SDK & win great prizes > Grand prize is a trip for two to an Open Source event anywhere in the world > http://moblin-contest.org/redirect.php?banner_id=100&url=/ > _______________________________________________ > Geotools-gt2-users mailing list > Geotools-gt2-users@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users > ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ _______________________________________________ Geotools-gt2-users mailing list Geotools-gt2-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users
