From: <ac...@sv...> - 2006-11-29 11:53:31
|
Author: acuster Date: 2006-11-29 03:51:16 -0800 (Wed, 29 Nov 2006) New Revision: 23118 Modified: geotools/trunk/gt/doc/user_manual/C/welcome.xml Log: Docs: massage welcome chapter Modified: geotools/trunk/gt/doc/user_manual/C/welcome.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- geotools/trunk/gt/doc/user_manual/C/welcome.xml 2006-11-29 10:03:15 U= TC (rev 23117) +++ geotools/trunk/gt/doc/user_manual/C/welcome.xml 2006-11-29 11:51:16 U= TC (rev 23118) @@ -55,12 +55,10 @@ Geotools provides almost no graphical user interface functionality= . Several=20 efforts may yield more user interface elements, notably the GO-1 m= odule in=20 the gt/ext/go directory and the=20 - <ulink url=3D"http://geowidgets.sourceforge.net/" type=3D"http"> - GeoWidgets project - </ulink> which will hopefully provide widgets based on the=20 - <ulink url=3D"http://geoapi.sourceforge.net/" type=3D"http"> - GeoAPI - </ulink> interfaces.=20 + <ulink url=3D"http://geowidgets.sourceforge.net/" type=3D"http">Ge= oWidgets</ulink> + project which will hopefully provide widgets based on the=20 + <ulink url=3D"http://geoapi.sourceforge.net/" type=3D"http">GeoAPI= </ulink>=20 + interfaces.=20 </para> =20 <para> @@ -69,9 +67,8 @@ <itemizedlist> <listitem> <para> - <ulink url=3D"http://www.geoserver.org/" type=3D"http"> - Geoserver - </ulink> is a network server to provide maps using the Web=20 + <ulink url=3D"http://www.geoserver.org/" type=3D"http">Geose= rver</ulink>=20 + is a network server to provide maps using the Web=20 Mapping Standard (WMS) or to provide individual features usi= ng the=20 Web Feature Standard (WFS) and its transactional extension, = the Web=20 Feature Standard for Transactions (WFS-T). =20 @@ -79,16 +76,14 @@ </listitem> <listitem> <para> - <ulink url=3D"http://udig.refractions.net/" type=3D"http"> - User-friendly Desktop Internet GIS (uDig) - </ulink> is both a powerful desktop application and a platfo= rm for=20 + <ulink url=3D"http://udig.refractions.net/" type=3D"http">Us= er-friendly=20 + Desktop Internet GIS (uDig)</ulink> is both a powerful deskt= op=20 + application and a platform for=20 the creation of other applications. The platform draws on th= e =20 - <ulink url=3D"http://www.eclipse.org/" type=3D"http"> - Eclipse - </ulink> project and its=20 - <ulink url=3D"http://www.eclipse.org/rcp/" type=3D"http"> - Rich Client Plarform=20 - </ulink> sub-project. =20 + <ulink url=3D"http://www.eclipse.org/" type=3D"http">Eclipse= </ulink>=20 + project and its=20 + <ulink url=3D"http://www.eclipse.org/rcp/" type=3D"http">Ric= h Client=20 + Platform (RCP)</ulink> sub-project. =20 </para> </listitem> </itemizedlist> @@ -98,30 +93,47 @@ There are also many other software projects for=20 spatial data which may be easier to use for simple projects than t= he=20 Geotools library. For example, the=20 - <ulink url=3D"http://www.jump-project.org/" type=3D"http"> - JUMP - </ulink> project and its=20 - <ulink url=3D"http://openjump.org/" type=3D"http"> - OpenJUMP - </ulink> fork are reputedly easy to use. The=20 - <ulink url=3D"http://www.freegis.org/" type=3D"http"> - FreeGIS - </ulink> project attempts to maintain a list of the free software=20 + <ulink url=3D"http://grass.ict.it/" type=3D"http">GRASS</ulink> pr= oject=20 + provides the most powerful free geospatial software platform avail= able=20 + while the=20 + <ulink url=3D"http://www.jump-project.org/" type=3D"http">JUMP</ul= ink> project=20 + and its <ulink url=3D"http://openjump.org/" type=3D"http">OpenJUMP= </ulink>=20 + fork are reputedly easy to use. The=20 + <ulink url=3D"http://www.freegis.org/" type=3D"http">FreeGIS</ulin= k> project=20 + attempts to maintain a list of the free software=20 projects related to geospatial data. Those projects, or others lik= e=20 them, may be a better place to start than working directly with th= e library itself. </para> </warning> =20 + <para> + Geotools is powerful but not yet mature so developers planning appli= cations=20 + which will depend on the library should carefully assess the strengt= hs and=20 + weaknesses of Geotools. Geotools leverages the modern,=20 + object oriented structure of the Java language, uses common, well=20 + documented computational design patterns, and consists of loosely de= pendent=20 + modules to present third party programmers with a coherent, easily=20 + usable code base. Geotools implements the core=20 + global geospatial standards of the International Organization for=20 + Standardization (IS0) and of the Open Geospatial Consortium (OGC) to= ensure=20 + maximal interoperability with other geospatial software. + However, Geotools is still a young project, growing rapidly, and bre= aking=20 + new ground by implementing untested standards. The library is theref= ore=20 + still evolving to address weaknesses in certain areas, to implement = new=20 + functionality, to work around defects in existing standards and to e= mbrace=20 + newer standards as these are proposed.=20 + </para> =20 =20 =20 + =20 <!-- The Users' Manual --> <para> <emphasis role=3D"bold">The Geotools Users' Manual</emphasis> docume= nts the=20 design of the library, explains the use of each modular subsystem, a= nd=20 provides background to the tutorials distributed with the source cod= e itself=20 - in order to help programers develop new geospatial applications usin= g part=20 + in order to help programmers develop new geospatial applications usi= ng part=20 or all of the Geotools library. This manual should help users get st= arted=20 using the Geotools library, we hope to the point that users can cont= inue on their own by reading the GeoAPI and Geotools javadocs along with the= source=20 @@ -139,10 +151,44 @@ <para>=20 The Developers' Guide provides helpful information for those who w= ant to contribute to the library itself. For more information, see the=20 - <ulink url=3D"http://www.geotools.org/Develop/" type=3D"http">deve= lopers page - </ulink> of the web site. + <ulink url=3D"http://www.geotools.org/Develop/" type=3D"http">deve= lopers=20 + page</ulink> of the web site. </para> </note> + =20 + <para> + This manual can be read sequentially but is primarily designed as a=20 + reference.=20 + <itemizedlist> + <listitem> + <para> + <xref linkend=3D"chapter-start"/> will help the impatient get = started + quickly, + </para> + </listitem> + <listitem> + <para> + <xref linkend=3D"chapter-conceptFound"/> and=20 + <xref linkend=3D"chapter-geoSci"/> present background informat= ion on the=20 + terminology, standards and science behind Geotools, and=20 + </para> + </listitem> + <listitem> + <para> + <xref linkend=3D"chapter-design"/> serves as the core of this = manual=20 + by explaining the design of the library and thereby introducin= g the=20 + subsystems of the library.=20 + </para> + </listitem> + </itemizedlist> + Each of the remaining chapters of this manual then discusses one sub= system=20 + in detail. Those chapters therefore serve as a reference to their pa= rticular=20 + subsystem. + </para> + =20 + <para> + Version &manversion; of this manual documents version &geotversion; = of Geotools. + </para> =20 </chapter> =20 |