From e1d253e2ebed67c416627c3b08d44e3ef0655541 Mon Sep 17 00:00:00 2001 From: Paul Ramsey Date: Tue, 7 Feb 2012 17:23:50 +0000 Subject: [PATCH] Documentation URLs, visible whitespace, and minor touchups (#1548) from mwtoews git-svn-id: http://svn.osgeo.org/postgis/trunk@9067 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/extras_tigergeocoder.xml | 6 +++--- doc/extras_topology.xml | 12 ++++++------ doc/faq_raster.xml | 2 +- doc/installation.xml | 12 ++++-------- doc/introduction.xml | 2 +- doc/performance_tips.xml | 17 ++++++++--------- doc/reference_accessor.xml | 4 ++-- doc/reference_constructor.xml | 6 +++--- doc/reference_editor.xml | 10 ++++------ doc/reference_lrs.xml | 2 +- doc/reference_management.xml | 2 +- doc/reference_measure.xml | 22 ++++++++++----------- doc/reference_misc.xml | 2 +- doc/reference_processing.xml | 10 ++++------ doc/reference_raster.xml | 36 +++++++++++++++++------------------ doc/reference_transaction.xml | 4 ++-- doc/reference_type.xml | 2 +- doc/release_notes.xml | 8 ++++---- doc/reporting.xml | 4 ++-- doc/using_postgis_dataman.xml | 2 +- 20 files changed, 78 insertions(+), 87 deletions(-) diff --git a/doc/extras_tigergeocoder.xml b/doc/extras_tigergeocoder.xml index c83c34023..5fe547cf9 100644 --- a/doc/extras_tigergeocoder.xml +++ b/doc/extras_tigergeocoder.xml @@ -4,7 +4,7 @@ Tiger Geocoder - A plpgsql based geocoder written to work with the TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export released by the US Census Bureau. In prior versions the TIGER files were + A plpgsql based geocoder written to work with the TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export released by the US Census Bureau. In prior versions the TIGER files were released in ASCII format. The older geocoder used to work with that format is in extras/tiger_geocoder/tiger_2006andbefore. There are four components to the geocoder: the data loader functions, the address normalizer, the address geocoder, and the reverse geocoder. The latest version updated to use the TIGER 2010 census data is located in the extras/tiger_geocoder/tiger_2010 folder. Although it is designed specifically for the US, a lot of the concepts and functions are applicable and can be adapted to work with other country address and road networks. @@ -302,7 +302,7 @@ Total query runtime: 245 ms. See Also - ,,,, , + , , , , , @@ -367,7 +367,7 @@ Total query runtime: 245 ms. See Also - ,, + , , diff --git a/doc/extras_topology.xml b/doc/extras_topology.xml index 41931ccd9..4e8709712 100644 --- a/doc/extras_topology.xml +++ b/doc/extras_topology.xml @@ -1504,7 +1504,7 @@ ERROR: Two or more edges found See Also - , + , @@ -1555,7 +1555,7 @@ ERROR: Two or more faces found See Also - ,, + , , @@ -1696,7 +1696,7 @@ ERROR: Two or more faces found See Also - , , + , , @@ -2446,7 +2446,7 @@ When tolerance is given it will be used to snap the input geo See Also - , + , @@ -2498,7 +2498,7 @@ When tolerance is given it will be used to snap the input geo See Also - , + , @@ -2544,7 +2544,7 @@ When tolerance is given it will be used to snap the input geo See Also - , + , diff --git a/doc/faq_raster.xml b/doc/faq_raster.xml index 627e9cde1..c02cf65e5 100644 --- a/doc/faq_raster.xml +++ b/doc/faq_raster.xml @@ -122,7 +122,7 @@ Below are some using a where clause gdal_translate -of PNG -outsize 10% 10% "PG:host=localhost dbname='mygisdb' user='postgres' password=whatever' schema='someschema' table=sometable where="owner='jimmy'" " C:\somefile.png gdal_translate -of PNG -outsize 10% 10% "PG:host=localhost dbname='mygisdb' user='postgres' password=whatever' schema='someschema' table=sometable where='ST_Intersects(rast, ST_SetSRID(ST_Point(-71.032,42.3793),4326) )' " C:\intersectregion.png - To see more examples and syntax refer to Reading Raster Data of PostGIS Raster section + To see more examples and syntax refer to Reading Raster Data of PostGIS Raster section diff --git a/doc/installation.xml b/doc/installation.xml index 14dcb8494..dc2d16ff7 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -218,7 +218,7 @@ tar -xvzf postgis-&last_release_version;.tar.gz Alternatively, checkout the source from the - + svn repository @@ -335,8 +335,8 @@ tar -xvzf postgis-&last_release_version;.tar.gz This parameter is currently broken, as the package will only install into the PostgreSQL installation directory. Visit - - http://trac.osgeo.org/postgis/ticket/160 + + http://trac.osgeo.org/postgis/ticket/635 to track this bug. @@ -622,11 +622,7 @@ FROM pg_available_extensions WHERE name LIKE 'postgis%' ; configuration parameter --with-pgconfig. So make sure to modify your PATH to match the detected PostgreSQL installation during configuration or be prepared to deal with the impending - headaches. Visit - - http://trac.osgeo.org/postgis/ticket/186 - - to track this bug. + headaches. diff --git a/doc/introduction.xml b/doc/introduction.xml index 4aa8bbe0a..e6a9e2d64 100644 --- a/doc/introduction.xml +++ b/doc/introduction.xml @@ -248,7 +248,7 @@ More information about MapServer internet map server is available at http://mapserver.gis.umn.edu. + url="http://mapserver.org/">http://mapserver.org. diff --git a/doc/performance_tips.xml b/doc/performance_tips.xml index d14b83631..c5ca4a8ad 100644 --- a/doc/performance_tips.xml +++ b/doc/performance_tips.xml @@ -13,7 +13,7 @@ "extension room" used to store large (in the sense of data size) values that do not fit into normal data pages (like long texts, images or complex geometries with lots of vertices), see - http://www.postgresql.org/docs/current/interactive/storage-toast.html for more + the PostgreSQL Documentation for TOAST for more information). The problem appears if you happen to have a table with rather @@ -162,15 +162,14 @@ VACUUM FULL ANALYZE mytable; - checkpoint_segment_size - (this setting is obsolete in newer versions of PostgreSQL) got replaced with - many configurations with names starting with checkpoint and WAL. + checkpoint_segments - # of WAL files = 16MB each; default is 3 + Maximum number of log file segments between automatic WAL checkpoints + (each segment is normally 16MB); default is 3 @@ -187,7 +186,7 @@ VACUUM FULL ANALYZE mytable; - constraint_exclusion + constraint_exclusion @@ -207,7 +206,7 @@ VACUUM FULL ANALYZE mytable; - shared_buffers + shared_buffers @@ -228,7 +227,7 @@ VACUUM FULL ANALYZE mytable; Runtime - work_mem (the memory used for sort operations and complex queries) + work_mem (the memory used for sort operations and complex queries) @@ -258,7 +257,7 @@ VACUUM FULL ANALYZE mytable; - maintenance_work_mem (used for VACUUM, CREATE INDEX, etc.) + maintenance_work_mem (used for VACUUM, CREATE INDEX, etc.) diff --git a/doc/reference_accessor.xml b/doc/reference_accessor.xml index d0a596c99..ede286d0e 100644 --- a/doc/reference_accessor.xml +++ b/doc/reference_accessor.xml @@ -1770,7 +1770,7 @@ GROUP BY gid, field1,field2; See Also - , + , @@ -2004,7 +2004,7 @@ POINT(3 2) See Also - ,, , + , , , diff --git a/doc/reference_constructor.xml b/doc/reference_constructor.xml index 67eaf33be..38c653bcb 100644 --- a/doc/reference_constructor.xml +++ b/doc/reference_constructor.xml @@ -131,7 +131,7 @@ UPDATE sometable SET geog = ST_GeogFromText('SRID=4326;POINT(' || lon || ' ' || See Also - , + , @@ -625,7 +625,7 @@ LINESTRING(1 2,4 5,7 8) See Also - ,, + , , @@ -908,7 +908,7 @@ LINESTRING(1 2 3,4 5 6,7 8 9) See Also - , , + , , diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml index 280fc53b1..64d490b61 100644 --- a/doc/reference_editor.xml +++ b/doc/reference_editor.xml @@ -1065,8 +1065,7 @@ SELECT ST_AsEWKT(ST_RotateX(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), pi()/2) See Also - , , , Rotate around Point, Create Ellipse functions + , , @@ -1133,8 +1132,7 @@ FROM (SELECT ST_LineToCurve(ST_Buffer(ST_GeomFromText('POINT(234 567)'), 3)) As See Also - , , , Rotate around Point, Create Ellipse functions + , , @@ -1321,7 +1319,7 @@ LINESTRING(-1 2 3,-1 3 4,-1 1 3) See Also - ,, , , + , , , , @@ -1380,7 +1378,7 @@ SRID=3785;POINT(-13732990.8753491 6178458.96425423) See Also - , , , ,, + , , , , , diff --git a/doc/reference_lrs.xml b/doc/reference_lrs.xml index dc28b85b8..c4771af43 100644 --- a/doc/reference_lrs.xml +++ b/doc/reference_lrs.xml @@ -82,7 +82,7 @@ FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As the_line) As foo; See Also - ,,, + , , , diff --git a/doc/reference_management.xml b/doc/reference_management.xml index 3544ec2ff..f3f581b53 100644 --- a/doc/reference_management.xml +++ b/doc/reference_management.xml @@ -836,7 +836,7 @@ DROP TABLE my_schema.my_spatial_table; See Also , ,, , , diff --git a/doc/reference_measure.xml b/doc/reference_measure.xml index 7951afdab..a765766f5 100644 --- a/doc/reference_measure.xml +++ b/doc/reference_measure.xml @@ -93,7 +93,7 @@ SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt, See Also - , ,, + , , , @@ -167,7 +167,7 @@ SELECT ST_3DDistance(poly, mline) As dist3d, See Also - ,,,, , + , , , , , @@ -234,7 +234,7 @@ ST_DWithin( See Also - , ,,, + , , , , @@ -522,7 +522,7 @@ SELECT ST_3DMaxDistance( See Also - ,,, + , , , @@ -716,7 +716,7 @@ SELECT ST_Area(the_geog)/POWER(0.3048,2) As sqft_spheroid, ST_Area(the_geog,fal See Also - , , , + , , , @@ -1200,7 +1200,7 @@ ST_Point | t | t | f | f See Also - , , ,, , + , , , , , @@ -1299,7 +1299,7 @@ ST_Point | t | t | f | f See Also - , , , ,, ,, + , , , , , , , @@ -2023,7 +2023,7 @@ FROM (SELECT See Also - ,, , , , + , , , , , @@ -2563,7 +2563,7 @@ SELECT ST_Equals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 10)')), See Also - , + , @@ -3694,7 +3694,7 @@ SELECT ST_AsEWKT(ST_PointOnSurface(ST_GeomFromEWKT('LINESTRING(0 5 1, 0 0 1, 0 1 Version 1: Takes geomA, geomB, intersectionMatrix and Returns 1 (TRUE) if this Geometry is spatially related to anotherGeometry, by testing for intersections between the Interior, Boundary and Exterior of the two geometries as specified - by the values in the intersectionMatrixPattern. + by the values in the DE-9IM matrix pattern. This is especially useful for testing compound checks of intersection, crosses, etc in one step. Do not call with a GeometryCollection as an argument @@ -4161,7 +4161,7 @@ SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc, See Also - , , + , , diff --git a/doc/reference_misc.xml b/doc/reference_misc.xml index 8d1c20556..19a06acca 100644 --- a/doc/reference_misc.xml +++ b/doc/reference_misc.xml @@ -328,7 +328,7 @@ SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' As bo See Also - , , , ,, + , , , , , diff --git a/doc/reference_processing.xml b/doc/reference_processing.xml index ae243327c..7f645cb93 100644 --- a/doc/reference_processing.xml +++ b/doc/reference_processing.xml @@ -441,17 +441,15 @@ FROM (SELECT ST_Buffer( Examples - Aggregate example - Thread ref: http://postgis.refractions.net/pipermail/postgis-users/2008-June/020331.html -SELECT stusps, + Aggregate example (http://postgis.refractions.net/pipermail/postgis-users/2008-June/020331.html) + SELECT stusps, ST_Multi(ST_Collect(f.the_geom)) as singlegeom FROM (SELECT stusps, (ST_Dump(the_geom)).geom As the_geom FROM somestatetable ) As f GROUP BY stusps Non-Aggregate example - Thread ref: http://postgis.refractions.net/pipermail/postgis-users/2008-June/020331.html -SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'), + SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'), ST_GeomFromText('POINT(-2 3)') )); st_astext @@ -2564,7 +2562,7 @@ GEOMETRYCOLLECTION( See Also - ,, ,, + , , , , diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml index 5075b27c3..8b2271db3 100644 --- a/doc/reference_raster.xml +++ b/doc/reference_raster.xml @@ -452,7 +452,7 @@ NOTICE: Adding blocksize-Y constraint See Also - ,, , , , + , , , , , @@ -717,7 +717,7 @@ postgis_raster_lib_version Description Returns a list of raster formats short_name,long_name and creator options of each format supported by your lib gdal. Use the short_name as input in the format parameter of . - Options vary depending on what drivers your libgdal was compiled with. create_options returns an xml formatted set of CreationOptionList/Option consisting of name and optional type,description and set of VALUE for each creator option for the specific driver. + Options vary depending on what drivers your libgdal was compiled with. create_options returns an xml formatted set of CreationOptionList/Option consisting of name and optional type, description and set of VALUE for each creator option for the specific driver. Availability: 2.0.0 - requires GDAL >= 1.6.0. @@ -1182,7 +1182,7 @@ SELECT ST_AsPNG( See Also - , , , , , , + , , , , , , @@ -2623,7 +2623,7 @@ select st_bandisnodata(rast, 2) from dummy_rast where rid = 1; -- Expected false See Also - ,, , , @@ -3370,7 +3370,7 @@ FROM dummy_rast WHERE rid = 1; See Also - ,, , + , , , @@ -3452,7 +3452,7 @@ WHERE rid = 2; See Also - , + , @@ -3839,7 +3839,7 @@ WHERE rid = 2; See Also - , + , @@ -3947,7 +3947,7 @@ select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- Expected true See Also - ,, , , @@ -4391,7 +4391,7 @@ ORDER BY value, quantile,rid Description - Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage.. If no band is specified nband defaults to 1. + Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. If no band is specified nband defaults to 1. By default only considers pixel values no equal to the nodata value . Set exclude_nodata_value to false to get count all pixels. By default will sample all pixels. To get faster response, set sample_percent to lower than 1 Availability: 2.0.0 @@ -4859,7 +4859,7 @@ SELECT ST_AsJPEG(rast,ARRAY[2,1,3],ARRAY['QUALITY=90','PROGRESSIVE=ON']) As rast See Also - , , ,, + , , , , @@ -5204,7 +5204,7 @@ WHERE rid = 4) As foo; See Also - , + , @@ -5347,7 +5347,7 @@ ORDER BY val; See Also - ,, , + , , , @@ -5924,7 +5924,7 @@ WITH mygeoms See Also - ,, , , , , , + , , , , , , , @@ -6015,7 +6015,7 @@ WITH mygeoms The second argument to the userfunction is a variadic text array. All trailing text arguments to any call are passed through to the specified userfunction, and are contained in the args argument. - For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of Query Language (SQL) Functions. + For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of Query Language (SQL) Functions. The text[] argument to the userfunction is required, regardless of whether you choose to pass any arguments to your user function for processing or not. @@ -6191,7 +6191,7 @@ WHERE rid=167; Description - Creates a new one band raster formed by applying a valid PostgreSQL function specified by the tworastuserfunc on the input raster rast1,rast2 . If no band1 or band2 is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original rasters but will only have one band. + Creates a new one band raster formed by applying a valid PostgreSQL function specified by the tworastuserfunc on the input raster rast1, rast2. If no band1 or band2 is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original rasters but will only have one band. If pixeltype is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or left out, then the new raster band will have the same pixeltype as the input rast1 band. @@ -6202,7 +6202,7 @@ WHERE rid=167; The third argument to the tworastuserfunc is a variadic text array. All trailing text arguments to any call are passed through to the specified tworastuserfunc, and are contained in the userargs argument. - For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of Query Language (SQL) Functions. + For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of Query Language (SQL) Functions. The text[] argument to the tworastuserfunc is required, regardless of whether you choose to pass any arguments to your user function for processing or not. @@ -6697,7 +6697,7 @@ UPDATE wind See Also - ,, ,, , + , , , , , @@ -7171,7 +7171,7 @@ NOTICE: The two rasters provided have different SRIDs See Also - , + , diff --git a/doc/reference_transaction.xml b/doc/reference_transaction.xml index 306db3b06..fb0bc8e35 100644 --- a/doc/reference_transaction.xml +++ b/doc/reference_transaction.xml @@ -4,11 +4,11 @@ This module and associated pl/pgsql functions have been implemented to provide long locking support required by Web Feature Service specification. + url="http://www.opengeospatial.org/standards/wfs">Web Feature Service specification. Users must use serializable + url="http://www.postgresql.org/docs/current/static/transaction-iso.html">serializable transaction level otherwise locking mechanism would break. diff --git a/doc/reference_type.xml b/doc/reference_type.xml index 933babab7..cc80a0709 100644 --- a/doc/reference_type.xml +++ b/doc/reference_type.xml @@ -177,7 +177,7 @@ See Also - , + , diff --git a/doc/release_notes.xml b/doc/release_notes.xml index 56c95aa55..417537f29 100644 --- a/doc/release_notes.xml +++ b/doc/release_notes.xml @@ -254,7 +254,7 @@ Bug fixes - http://trac.osgeo.org/postgis/query?status=closed&milestone=postgis+1.5.0&order=priority + http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS+1.5.0&order=priority @@ -320,7 +320,7 @@ Bug fixes - http://trac.osgeo.org/postgis/query?status=closed&milestone=postgis+1.4.0&order=priority + http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS+1.4.0&order=priority @@ -403,7 +403,7 @@ Added ST_Covers and ST_CoveredBy relational functions. Description and justification of these functions can be found at - http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html + http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html Added ST_DWithin relational function. @@ -627,7 +627,7 @@ GNU trove. Added EJB2 support generously donated by the "Geodetix s.r.l. - Company" http://www.geodetix.it/ + Company" http://www.geodetix.it/ Added EJB3 tutorial / examples donated by Norman Barker <nbarker@ittvis.com> diff --git a/doc/reporting.xml b/doc/reporting.xml index 06b952337..9784a2ba8 100644 --- a/doc/reporting.xml +++ b/doc/reporting.xml @@ -46,7 +46,7 @@ If your changes are more extensive, a Subversion patch is definitely preferred. This is a four step process on Unix (assuming you already have - Subversion + Subversion installed): @@ -84,4 +84,4 @@ - \ No newline at end of file + diff --git a/doc/using_postgis_dataman.xml b/doc/using_postgis_dataman.xml index 29ffce344..3d42dcaa0 100644 --- a/doc/using_postgis_dataman.xml +++ b/doc/using_postgis_dataman.xml @@ -1605,7 +1605,7 @@ AND ST_Relate(a.geom, b.geom, '102101FF2'); Extended Nine-Intersection Model (DE-9IM) by Christian Strobl - GeoTools: Dimensionally Extended Nine-Intersection Matrix + GeoTools: Point Set Theory and the DE-9IM Matrix Encyclopedia of GIS By Hui Xiong -- 2.40.0