From 4ad4774fd056a358d2ff0bdaa3ed19fce7dd2a85 Mon Sep 17 00:00:00 2001 From: Kevin Neufeld Date: Tue, 15 Jul 2008 06:57:32 +0000 Subject: [PATCH] Started migration of the functions in reference.xml using the concept to a new "reference_new.xml" using DocBook's concept. Once migration is complete, reference.xml will be removed and reference_new.xml will be renamed to reference.xml. The included template.xml file is not used, except to provide example usage of DocBook's refentry tag. git-svn-id: http://svn.osgeo.org/postgis/trunk@2850 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/Makefile.in | 10 +- doc/html/images/caution.png | Bin 0 -> 1250 bytes doc/html/images/check.png | Bin 0 -> 1030 bytes doc/html/images/important.png | Bin 0 -> 722 bytes doc/html/images/note.png | Bin 0 -> 6118 bytes doc/html/images/tip.png | Bin 0 -> 449 bytes doc/html/images/warning.png | Bin 0 -> 1241 bytes doc/postgis.xml | 2 + doc/reference.xml | 117 +------ doc/reference_new.xml | 571 ++++++++++++++++++++++++++++++++++ doc/release_notes.xml | 427 +++++++++++++------------ doc/template.xml | 69 ++++ 12 files changed, 868 insertions(+), 328 deletions(-) create mode 100644 doc/html/images/caution.png create mode 100644 doc/html/images/check.png create mode 100644 doc/html/images/important.png create mode 100644 doc/html/images/note.png create mode 100644 doc/html/images/tip.png create mode 100644 doc/html/images/warning.png create mode 100644 doc/reference_new.xml create mode 100644 doc/template.xml diff --git a/doc/Makefile.in b/doc/Makefile.in index 4ab81bc2b..fd8fe81fd 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -15,7 +15,13 @@ XSLBASE = @XSLBASE@ XSLTPROC_COMMONOPTS = \ --param section.autolabel 1 \ --param section.label.includes.component.label 1 \ - --param chunk.section.depth 0 + --param chunk.section.depth 0 \ + --param generate.section.toc.level 1 \ + --param funcsynopsis.style ansi \ + --param admon.graphics 1 \ + --param admon.textlabel 0 \ + --param simplesect.in.toc 0 \ + --param use.id.as.filename 1 XSLTPROC_HTMLOPTS = \ --stringparam html.stylesheet style.css \ @@ -38,7 +44,7 @@ else all: html/postgis.html endif -postgis-out.xml: postgis.xml introduction.xml installation.xml faq.xml using_postgis.xml performance_tips.xml reference.xml reporting.xml release_notes.xml ../Version.config +postgis-out.xml: postgis.xml introduction.xml installation.xml faq.xml using_postgis.xml performance_tips.xml reference.xml reference_new.xml reporting.xml release_notes.xml ../Version.config cat $< | sed "s/@@LAST_RELEASE_VERSION@@/@POSTGIS_LIB_VERSION@/g" > $@ chunked-html: postgis-out.xml diff --git a/doc/html/images/caution.png b/doc/html/images/caution.png new file mode 100644 index 0000000000000000000000000000000000000000..5b7809ca4a9c8d778087522e5ce04b6e90099595 GIT binary patch literal 1250 zcmeAS@N?(olHy`uVBq!ia0vp^5+KaM3?#3wJbQ|Pftew|C&U%V<=|it5MYpyU{F+K zFf?Rva$<;zVn|MA$j)XcE@r5%W@u>vqT-$&hMpcE*)wGd!;~q-Q>IkUnZqz=PVt;M zK*p3gbLK2v%CK~4^3tV1#?q}@8MbbX+PXD)>(;G%_cH9=n|$sZ!?|yxmE{-7;w@N47?rU=3X_NkV zU|o{PnRTZ;lXp4>+)hZU_|Lw%*va*6=<@jI@BP^`_OsZ?pZg-2AaGf|;i2L0<>du@ zeRrO4er03}pLSxdREd>pap^;~&E+}=JYKy#vHnLI=Z$}pPyA_`zG;G~<$`Br2do;7 z$Heivv0AeyJYVI({@6?X6r+V~XS2Cs!|bddDqJz@2lKf$~4dA1c%lfOT+5KMUSWi#X5(9ePxx_W1Bsf2+N)z4*}Q$iB}K{RAP literal 0 HcmV?d00001 diff --git a/doc/html/images/check.png b/doc/html/images/check.png new file mode 100644 index 0000000000000000000000000000000000000000..d6b28fc1ba27ae3a203d1ff94231f9cbf260f7f8 GIT binary patch literal 1030 zcmV+h1o``kP)004R=004l4008;_004mK004C`008P>0026d000+nm#LZ5000A# zNklG1^-VSJMteOfJip%)}?d*W&Dc%Gt7PZpJC6R{|pPC|CjK{`G4-%;r|~# zd@utDASP10`RCgwh5WAh3{Nbh7#L(l85lnOU|`!ck6})l1B0QZ4I@YmKmaiT1D%mr z0~S*y?OSiS1&04Kg0C9{~2}z!>#N5f9JT; z|6ks|^gve&5I`UUO$ixTQQ!HWp=<{*Mt}cjSp4e0VsQEYd)F`hz@`=;fIwcx8-~aB z?fyUUGSI8mb_@)^fZ?`n8ADH)5rd+JE(bRC00D$ImOsCJ8CW!93&VG(NCpNjb_Rz1 zdl+(L-v18@3t_>f2Oxl;2L5MweD~&qlSdE#|M}wwJdnF5&s}#?)P{jUU73O5)`S1X z4|jcUDM{O1d-{LkQ9`@g+!%70K;fD$T?FHmgl=l={F zzW(P3YWj3w*N$z3!W$rf80uTQ{xihS`p>ZR-G7D!Z~m)>R{Vc`_v$6@e_+#q|%niR8nD(sv zQy*%6o=ZUVEincH1Q3&zk?wESXE%VZ1I74w7 zs54ks^b^B{)BhRRfoYY6nSp^7=(?l(7)qR#806Hn)JZWAAb>#W@O@HLz(IwZ+y60~ zz0APy_6q~U-n|Ug?~gO2B}VC!Vi*Vj1Q6rHhYtmXg@u{Vo;vw(!irs-&%QG<>IgG4 z6ea{Q$S5cS%PIy?9RW-N439uGKR-X-Is+iU04a?isb8YK$^ZZW07*qoM6N<$f(iK8 A`2YX_ literal 0 HcmV?d00001 diff --git a/doc/html/images/important.png b/doc/html/images/important.png new file mode 100644 index 0000000000000000000000000000000000000000..12c90f607a1b27ddde0a7d922ae255e8c90e883e GIT binary patch literal 722 zcmV;@0xkWCP)Gdz_qOoSb{LwMwNgp7=gl$4aErG%}mjHRWNrKOy`y@b8JoTa6ut*xc4t*y1SwY|N)#>U3Z&d%1> z*52OU=jZ3|@9+2b_y7O@tTMkk%M`~Kg@u8&dg_P^_0l3yQb639!jLZt^Lx<-O17UeeJ z-|=!77W(jGx&e#?FOku-gKofoU0$~4M+dhLFueEauP`}l7LV=;lsOdn%WHure=x;k`m0(bF&MU#) z-qv#^n8(MjB|ykioqII#+`g4no-MU=BK|Sahu_3M_-d*=7hq=~t?^}A)G7 zbairN0An*{V`DL9V>K}|HDobmIW;*pIW=W9HaTQ6F*7kTGI9=S@Bjb+07*qoM6N<$ Ef=i}M4FCWD literal 0 HcmV?d00001 diff --git a/doc/html/images/note.png b/doc/html/images/note.png new file mode 100644 index 0000000000000000000000000000000000000000..b1bcaed1ed88c650a8703e244eebb4455527009a GIT binary patch literal 6118 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 literal 0 HcmV?d00001 diff --git a/doc/html/images/tip.png b/doc/html/images/tip.png new file mode 100644 index 0000000000000000000000000000000000000000..5c4aab3bb3543191c360387c4af9a3cbaa051345 GIT binary patch literal 449 zcmeAS@N?(olHy`uVBq!ia0vp^l0YoM0VEi-?r};1DW)WEcNYeRRlUkaK;CUn7srr_ zTcwkB3m#VBagbEhuIO1a$!w|j^feEHv@=+|woj32oF*6|l<3XH$!T}Lao)e6jJhoQ z_vr?OZVprC|7iZ8xaicUR0b&zR-JdP408=+?zC0Rn8IN&QLTWhMIcU0X8P7uUN4WB zR_?a_;&p>ll{>(OzfJ4N{OX={Q&zNgO}j31DC;|ya^r9Fjd348&p+!^cT+^sws+=& zCu*T*mRNK3PE;$BNx$Fa_9(Y=&DoXLMFRd#U31O)<`W^F&-o=xbIqK-c?mr!bmn>! zky6TW;ML~4nXw$T{yra=OteL6G!=B;0=?;6;u=vBoS#-wo>-L1;Gm(b>6x3Dp6Z*J zo|&AjV4`QFXQ5zesc&GRZ(yj9T$EW{Qt6OeSzMBtte0A>mr`1gpI4%noS!>!m*Ngk zP=bxiOwUU!DFvFBnrfM1VQy}0X_lO7WM-b2nq**TZkb|inr2~`WR#dJWc*7VsEZGz hD*$LMgOO>4k%_i}w!yxSoa=!y44$rjF6*2UngF(YpwIvS literal 0 HcmV?d00001 diff --git a/doc/html/images/warning.png b/doc/html/images/warning.png new file mode 100644 index 0000000000000000000000000000000000000000..1c33db8f34a8b42b373179b46a2d8d8a10e061a9 GIT binary patch literal 1241 zcmeHH+e?!H6#vDtmgHCxG{Q}12(7`~)|MMe^RnTlY0JD#q1sIwW1DTCqzzwWg@Q=t zBC2Iceu@w4LHM97Gb5%*E%9MN*%m}jvs!{N@Pd8$H}vS?TsRzlzr#5kPPe|YG%fXL zDu6VdR$WC$&Oc)^X#ZjK-7LU>{!F!o39xr+d_Vw5fMTEwpb-s#9q<5Nzz6gIepyU?Lctpr{ZK zVzWaWPAC)#17S8h%;AIuf(Q_yeIybEqS0s^i1YdJcsv0ln9M{Xkpz;-I_^=P))~D~!!Hvpq{Dl8O{rN@cECkt>#DncX%I(O&3i_YgL-$m$VU zT3cLBLS%M1`o{TBX}S|Tbhc)vk!Yp)%rdDd&my(RPsxl%lU$)tC?(1~WuEwClUQn! n$Q8O{Mxt@ukkcT{K0> literal 0 HcmV?d00001 diff --git a/doc/postgis.xml b/doc/postgis.xml index 600765407..2f1f50595 100644 --- a/doc/postgis.xml +++ b/doc/postgis.xml @@ -8,6 +8,7 @@ + @@ -48,6 +49,7 @@ &using_postgis; &performance_tips; &reference; + &reference_new; &reporting; &release_notes; diff --git a/doc/reference.xml b/doc/reference.xml index 6dc57362e..e30029b8d 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -19,86 +19,10 @@ OpenGIS Functions - - Management Functions - - - - AddGeometryColumn(varchar, varchar, varchar, integer, varchar, - integer) - - - Syntax: AddGeometryColumn(<schema_name>, - <table_name>, <column_name>, <srid>, - <type>, <dimension>). Adds a geometry column to an - existing table of attributes. The schema_name - is the name of the table schema (unused for pre-schema PostgreSQL - installations). The srid must be an integer - value reference to an entry in the SPATIAL_REF_SYS table. The - type must be an uppercase string corresponding - to the geometry type, eg, 'POLYGON' or 'MULTILINESTRING'. - - - - - DropGeometryColumn(varchar, varchar, varchar) - - - Syntax: DropGeometryColumn(<schema_name>, - <table_name>, <column_name>). Remove a geometry column - from a spatial table. Note that schema_name will need to match the - f_schema_name field of the table's row in the geometry_columns - table. - - - - - ST_SetSRID(geometry, integer) - - - Set the SRID on a geometry to a particular integer value. - Useful in constructing bounding boxes for queries. - - - - - Geometry Relationship Functions - - ST_Distance(A geometry, B geometry) - - - Return the cartesian distance between two geometries in - projected units. Does not use indexes. - - - - - ST_DWithin(A geometry, B geometry, sriddistance float) - - - Returns true if geometries are within the specified sriddistance - of one another. sriddistance is in units defined by the spatial reference system and both - geometries must have the same SRID. - Uses indexes if available. - - ---Find the nearest hospital to each school ---that is within 3000 units of the school. --- We do an ST_DWithin search to utilize indexes to limit our search list --- that the non-indexable ST_Distance needs to process ---If the units of the spatial reference is meters then units would be meters -SELECT DISTINCT ON (s.gid) s.gid, s.school_name, s.the_geom, h.hospital_name - FROM schools s - LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.the_geom, 3000) - ORDER BY s.gid, ST_Distance(s.the_geom, h.the_geom); - - - - ST_Equals(geometry, geometry) @@ -1255,17 +1179,6 @@ GROUP BY gid, field1,field2; Management Functions - - DropGeometryTable([<schema_name>], - <table_name>) - - - Drops a table and all its references in geometry_columns. - Note: uses current_schema() on schema-aware pgsql installations if - schema is not provided. - - - UpdateGeometrySRID([<schema_name>], <table_name>, <column_name>, <srid>) @@ -1560,20 +1473,20 @@ GROUP BY gid, field1,field2; - - ST_distance_sphere(point, point) + + ST_Distance_Sphere(point, point) Returns linear distance in meters between two lat/lon points. Uses a spherical earth and radius of 6370986 meters. Faster than distance_spheroid(), but less + linkend="ST_Distance_Spheroid">ST_Distance_Spheroid(), but less accurate. Only implemented for points. - - ST_distance_spheroid(point, point, spheroid) + + ST_Distance_Spheroid(point, point, spheroid) Returns linear distance between two lat/lon points given a @@ -1638,14 +1551,6 @@ GROUP BY gid, field1,field2; - - ST_distance(geometry, geometry) - - - Returns the smaller distance between two geometries. - - - ST_max_distance(linestring,linestring) @@ -2235,7 +2140,7 @@ UPDATE sometable - + ST_Transform(geometry,integer) @@ -3022,16 +2927,6 @@ WHERE n*100.00/length < 1; - - ST_Distance - - - Return the distance between two geometries. - - SQL-MM 3: 5.1.23 - - - ST_EndPoint diff --git a/doc/reference_new.xml b/doc/reference_new.xml new file mode 100644 index 000000000..56892dbaa --- /dev/null +++ b/doc/reference_new.xml @@ -0,0 +1,571 @@ + + + PostGIS Reference + + The functions given below are the ones which a user of PostGIS is + likely to need. There are other functions which are required support + functions to the PostGIS objects which are not of use to a general + user. + + + PostGIS has begun a transition from the existing naming convention + to an SQL-MM-centric convention. As a result, most of the functions that + you know and love have been renamed using the standard spatial type (ST) + prefix. Previous functions are still available, though are not listed in + this document where updated functions are equivalent. These will be + deprecated in a future release. + + + + Management Functions + + + + AddGeometryColumn + + Adds a geometry column to an existing table of + attributes. + + + + + + text AddGeometryColumn + + varchar + table_name + + varchar + column_name + + integer + srid + + varchar + type + + integer + dimension + + + + text AddGeometryColumn + + varchar + schema_name + + varchar + table_name + + varchar + column_name + + integer + srid + + varchar + type + + integer + dimension + + + + text AddGeometryColumn + + varchar + catalog_name + + varchar + schema_name + + varchar + table_name + + varchar + column_name + + integer + srid + + varchar + type + + integer + dimension + + + + + + Description + + Adds a geometry column to an existing table of attributes. The + schema_name is the name of the table schema (unused + for pre-schema PostgreSQL installations). The srid + must be an integer value reference to an entry in the SPATIAL_REF_SYS + table. The type must be an uppercase string + corresponding to the geometry type, eg, 'POLYGON' or + 'MULTILINESTRING'. + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL. + + + + + Examples + + +-- Create a new simple PostgreSQL table +postgis=# CREATE TABLE my_schema.my_spatial_table (id serial); + +-- Describing the table shows a simple table with a single "id" column. +postgis=# \d my_schema.my_spatial_table + Table "my_schema.my_spatial_table" + Column | Type | Modifiers +--------+---------+------------------------------------------------------------------------- + id | integer | not null default nextval('my_schema.my_spatial_table_id_seq'::regclass) + +-- Add a spatial column to the table +postgis=# SELECT AddGeometryColumn ('my_schema','my_spatial_table','the_geom',4326,'POINT',2); + +-- Describe the table again reveals the addition of a new "the_geom" column. +postgis=# \d my_schema.my_spatial_table + Table "my_schema.my_spatial_table" + Column | Type | Modifiers +----------+----------+------------------------------------------------------------------------- + id | integer | not null default nextval('my_schema.my_spatial_table_id_seq'::regclass) + the_geom | geometry | +Check constraints: + "enforce_dims_the_geom" CHECK (ndims(the_geom) = 2) + "enforce_geotype_the_geom" CHECK (geometrytype(the_geom) = 'POINT'::text OR the_geom IS NULL) + "enforce_srid_the_geom" CHECK (srid(the_geom) = 4326) + + + + + See Also + + , + + + + + + DropGeometryColumn + + Removes a geometry column from a spatial + table. + + + + + + text DropGeometryColumn + + varchar + table_name + + varchar + column_name + + + + text DropGeometryColumn + + varchar + schema_name + + varchar + table_name + + varchar + column_name + + + + text DropGeometryColumn + + varchar + catalog_name + + varchar + schema_name + + varchar + table_name + + varchar + column_name + + + + + + Description + + Removes a geometry column from a spatial table. Note that + schema_name will need to match the f_schema_name field of the table's + row in the geometry_columns table. + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL. + + + + + See Also + + , + + + + + + DropGeometryTable + + Drops a table and all its references in + geometry_columns. + + + + + + boolean DropGeometryTable + + varchar + table_name + + + + boolean DropGeometryTable + + varchar + schema_name + + varchar + table_name + + + + + + Description + + Drops a table and all its references in geometry_columns. Note: + uses current_schema() on schema-aware pgsql installations if schema is + not provided. + + + + See Also + + , + + + + + + UpdateGeometrySRID + + Updates the SRID of all features in a geometry + column + + + + + + text UpdateGeometrySRID + + varchar + table_name + + varchar + column_name + + integer + srid + + + + text UpdateGeometrySRID + + varchar + schema_name + + varchar + table_name + + varchar + column_name + + integer + srid + + + + text UpdateGeometrySRID + + varchar + catalog_name + + varchar + schema_name + + varchar + table_name + + varchar + column_name + + integer + srid + + + + + + Description + + Updates the SRID of all features in a geometry column, updating + constraints and reference in geometry_columns. Note: uses + current_schema() on schema-aware pgsql installations if schema is not + provided. + + + + See Also + + + + + + + + Geometry Constructors + + + + Geometry Accessors + + + + Geometry Editors + + + + ST_SetSRID + + Sets the SRID on a geometry to a particular integer + value. + + + + + + boolean ST_SetSRID + + Geometry + geom + + integer + srid + + + + + + Description + + Sets the SRID on a geometry to a particular integer value. + Useful in constructing bounding boxes for queries. + + + This function does not transform the geometry is any way - + it simply sets the projection the geometry that it's currently in. + Use if you want to transform the + geometry into a new projection. + + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL. + + + + + See Also + + + + + + + + + Geometry Outputs + + + + Operators + + + + + Spatial Relationships + + + + ST_Distance + + Returns the cartesian distance between two geometries in + projected units. + + + + + + boolean ST_Distance + + Geometry + g1 + + Geometry + g2 + + + + + + Description + + Returns the cartesian distance between two geometries in + projected units. + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL. + + + + + This method implements the SQL/MM specification: SQL-MM 3: 5.1.23 + + + + + Examples + + postgis=# SELECT ST_Distance('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry); + st_distance +----------------- + 1.4142135623731 +(1 row) + + + + See Also + + , , + + + + + + ST_DWithin + + Returns true if the geometries are within the specified + distance of one another + + + + + + boolean ST_DWithin + + geometry + g1 + + geometry + g2 + + double precision + distance + + + + + + Description + + Returns true if the geometries are within the specified distance + of one another. The distance is specified in units defined by the + spatial reference system of the geometries. For this function to make + sense, the source geometries must both be of the same coorindate projection, + having the same SRID. + + + This function call will automatically include a bounding box + comparison that will make use of any indexes that are available on + the geometries. + + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL. + + + + + Examples + +--Find the nearest hospital to each school +--that is within 3000 units of the school. +-- We do an ST_DWithin search to utilize indexes to limit our search list +-- that the non-indexable ST_Distance needs to process +--If the units of the spatial reference is meters then units would be meters +SELECT DISTINCT ON (s.gid) s.gid, s.school_name, s.the_geom, h.hospital_name + FROM schools s + LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.the_geom, 3000) + ORDER BY s.gid, ST_Distance(s.the_geom, h.the_geom); + + + + + See Also + + + + + + + + Spatial Predicates + + + + Linear Referencing + + + + Long Transactions Support + + + + Misc + + + \ No newline at end of file diff --git a/doc/release_notes.xml b/doc/release_notes.xml index 94bd67e73..f017c2ed3 100644 --- a/doc/release_notes.xml +++ b/doc/release_notes.xml @@ -1,11 +1,9 @@ Appendix - - - Release Notes - - + Release Notes + + Release 1.3.3 Release date: 2008/04/12 @@ -14,9 +12,9 @@ KML support, adds a ST_SimplifyPreserveTopology function, makes the build more sensitive to GEOS versions, and fixes a handful of severe but rare failure cases. - + - + Release 1.3.2 Release date: 2007/12/01 @@ -24,18 +22,18 @@ This release fixes bugs in ST_EndPoint() and ST_Envelope, improves support for JDBC building and OS/X, and adds better support for GML output with ST_AsGML(), including GML3 output. - + - + Release 1.3.1 Release date: 2007/08/13 This release fixes some oversights in the previous release around version numbering, documentation, and tagging. - + - + Release 1.3.0 Release date: 2007/08/09 @@ -45,7 +43,7 @@ function names to the SQL-MM convension, using the spatial type (SP) prefix. - + Added Functionality JDBC: Added Hibernate Dialect (thanks to Norman Barker) @@ -55,9 +53,9 @@ http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html Added ST_DWithin relational function. - + - + Performance Enhancements Added cached and indexed point-in-polygon short-circuits for the @@ -65,9 +63,9 @@ Added inline index support for relational functions (except ST_Disjoint) - + - + Other Changes Extended curved geometry support into the geometry accessor and @@ -77,10 +75,10 @@ using a spatial type (ST) prefix. Added initial support for PostgreSQL 8.3 - - + + - + Release 1.2.1 Release date: 2007/01/11 @@ -88,7 +86,7 @@ This release provides bug fixes in PostgreSQL 8.2 support and some small performance enhancements. - + Changes Fixed point-in-polygon shortcut bug in Within(). @@ -104,10 +102,10 @@ JavaDoc is compiled and packaged. Fixed classpath problems with GCJ. Fixed pgjdbc 8.2 compatibility, losing support for jdk 1.3 and older. - - + + - + Release 1.2.0 Release date: 2006/12/08 @@ -116,7 +114,7 @@ serialization/deserialization capabilities for SQL-MM defined curved geometries, as well as performance enhancements. - + Changes Added curved geometry type support for @@ -124,10 +122,10 @@ Added point-in-polygon shortcircuit to the Contains and Within functions to improve performance for these cases. - - + + - + Release 1.1.6 Release date: 2006/11/02 @@ -137,7 +135,7 @@ parameters and an improvement in reprojections (take Z in consideration). Upgrade is encouraged. - + Upgrading If you are upgrading from release 1.0.3 or later follow the @@ -150,9 +148,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes fixed CAPI change that broke 64-bit platforms @@ -160,9 +158,9 @@ loader/dumper: fixed regression tests and usage output Fixed setSRID() bug in JDBC, thanks to Thomas Marti - + - + Other changes use Z ordinate in reprojections @@ -177,10 +175,10 @@ Replace hand-made, fragile JDBC version parser with Properties - - + + - + Release 1.1.5 Release date: 2006/10/13 @@ -188,7 +186,7 @@ This is an bugfix release, including a critical segfault on win32. Upgrade is encouraged. - + Upgrading If you are upgrading from release 1.0.3 or later follow the @@ -201,9 +199,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes Fixed MingW link error that was causing pgsql2shp to segfault on @@ -222,16 +220,16 @@ Fixed version tag in jdbc code that still said "1.1.3" in the "1.1.4" release. - + - + New Features Added -S option for non-multi geometries to shp2pgsql - - + + - + Release 1.1.4 Release date: 2006/09/27 @@ -239,7 +237,7 @@ This is an bugfix release including some improvements in the Java interface. Upgrade is encouraged. - + Upgrading If you are upgrading from release 1.0.3 or later follow the @@ -252,9 +250,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes Fixed support for PostgreSQL 8.2 @@ -266,9 +264,9 @@ Fixed regress tests to pass with GEOS-3.0.0 Improved pgsql2shp run concurrency. - + - + Java changes reworked JTS support to reflect new upstream JTS developers' @@ -282,10 +280,10 @@ <nbarker@ittvis.com> Reorganized java directory layout a little. - - + + - + Release 1.1.3 Release date: 2006/06/30 @@ -294,7 +292,7 @@ (most notably long transaction support) and portability enhancements. Upgrade is encouraged. - + Upgrading If you are upgrading from release 1.0.3 or later follow the @@ -307,9 +305,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes / correctness BUGFIX in distance(poly,poly) giving wrong results. @@ -322,9 +320,9 @@ WKT parser: forbidden construction of multigeometries with EMPTY elements (still supported for GEOMETRYCOLLECTION). - + - + New functionalities NEW Long Transactions support. @@ -332,9 +330,9 @@ NEW DumpRings() function. NEW AsHEXEWKB(geom, XDR|NDR) function. - + - + JDBC changes Improved regression tests: MultiPoint and scientific @@ -344,9 +342,9 @@ Added proper accessor functions for all fields in preparation of making those fields private later - + - + Other changes NEW regress test support for loader/dumper. @@ -361,10 +359,10 @@ Don't link pgsql2shp to more libs then required. Initial support for PostgreSQL 8.2. - - + + - + Release 1.1.2 Release date: 2006/03/30 @@ -373,7 +371,7 @@ portability enhancements. Upgrade is encouraged. - + Upgrading If you are upgrading from release 1.0.3 or later follow the @@ -386,9 +384,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes BUGFIX in SnapToGrid() computation of output bounding box @@ -398,9 +396,9 @@ jdbc2 SRID handling fixes in JTS code Fixed support for 64bit archs - + - + New functionalities Regress tests can now be run *before* postgis @@ -415,19 +413,19 @@ Embedded access control in estimated_extent() for builds against pgsql >= 8.0.0 - + - + Other changes More portable ./configure script Changed ./run_test script to have more sane default behaviour - - + + - + Release 1.1.1 Release date: 2006/01/23 @@ -439,7 +437,7 @@ preventing GeometryCollection objects to be used in topological operations. - + Upgrading If you are upgrading from release 1.0.3 or later follow the @@ -452,9 +450,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes Fixed a premature exit in postgis_restore.pl @@ -471,9 +469,9 @@ BUGFIX in line_substring() Added support for localized cluster in regress tester - + - + New functionalities New Z and M interpolation in line_substring() @@ -481,10 +479,10 @@ New Z and M interpolation in line_interpolate_point() added NumInteriorRing() alias due to OpenGIS ambiguity - - + + - + Release 1.1.0 Release date: 2005/12/21 @@ -498,7 +496,7 @@ GEOS-2.2.x before installing PostGIS, this will ensure future GEOS upgrades won't require a rebuild of the PostGIS library. - + Credits This release includes code from Mark Cave Ayland for caching of @@ -510,9 +508,9 @@ Devrim GUNDUZ provided RPM specfiles. Carl Anderson helped with the new area building functions. See the credits section for more names. - + - + Upgrading If you are upgrading from release 1.0.3 or later you @@ -528,9 +526,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + New functions scale() and transscale() companion methods to translate() @@ -562,9 +560,9 @@ RemovePoint(linestring, offset) ReplacePoint(linestring, offset, point) - + - + Bug fixes Fixed memory leak in polygonize() @@ -573,27 +571,27 @@ Fixed USE_GEOS, USE_PROJ and USE_STATS elements of postgis_version() output to always reflect library state. - + - + Function semantic changes SnapToGrid doesn't discard higher dimensions Changed Z() function to return NULL if requested dimension is not available - + - + Performance improvements Much faster transform() function, caching proj4 objects Removed automatic call to fix_geometry_columns() in AddGeometryColumns() and update_geometry_stats() - + - + JDBC2 works Makefile improvements @@ -614,9 +612,9 @@ fix EWKT constructors to accept SRID=4711; representation added preliminary read-only support for java2d geometries - + - + Other new things Full autoconf-based configuration, with PostgreSQL source @@ -629,9 +627,9 @@ Debian and RPM specfiles New lwpostgis_upgrade.sql script - + - + Other changes JTS support improvements @@ -646,17 +644,17 @@ obsoleted direct use of postgis_proc_upgrade.pl scripts version unified with release version - - + + - + Release 1.0.6 Release date: 2005/12/06 Contains a few bug fixes and improvements. - + Upgrading If you are upgrading from release 1.0.3 or later you @@ -669,9 +667,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes Fixed palloc(0) call in collection deserializer (only gives @@ -688,18 +686,18 @@ Fixed bug in segmentize() Fixed bbox computation of SnapToGrid output - + - + Improvements Initial support for postgresql 8.2 Added missing SRID mismatch checks in GEOS ops - - + + - + Release 1.0.5 Release date: 2005/11/25 @@ -713,7 +711,7 @@ conform to unix standards (return 0 on success). - + Upgrading If you are upgrading from release 1.0.3 or later you @@ -726,9 +724,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Library changes Fixed memory alignment problems @@ -741,9 +739,9 @@ Speedup of serializer functions Fixed a bug in force_3dm(), force_3dz() and force_4d() - + - + Loader changes Fixed return code of shp2pgsql @@ -755,19 +753,19 @@ attributes Segfault fix in shp2pgsql (utf8 encoding) - + - + Other changes Schema aware postgis_proc_upgrade.pl, support for pgsql 7.2+ New "Reporting Bugs" chapter in manual - - + + - + Release 1.0.4 Release date: 2005/09/09 @@ -776,7 +774,7 @@ particular, it fixes a memory leak preventing successful build of GiST indexes for large spatial tables. - + Upgrading If you are upgrading from release 1.0.3 you DO @@ -789,9 +787,9 @@ Upgrade from any release prior to 1.0.0RC6 requires an hard upgrade. - + - + Bug fixes Memory leak plugged in GiST indexing @@ -806,9 +804,9 @@ Fixed bug in MakeLine dimension handling Fixed bug in translate() corrupting output bounding box - + - + Improvements Documentation improvements @@ -822,10 +820,10 @@ GiST indexing cleanup Looser syntax acceptance in box3d parser - - + + - + Release 1.0.3 Release date: 2005/08/08 @@ -834,7 +832,7 @@ affecting correctness of stored geometries - and a few improvements. - + Upgrading Due to a bug in a bounding box computation routine, the upgrade @@ -854,9 +852,9 @@ no args for syntax help). Optionally run utils/postgis_proc_upgrade.pl to refresh postgis procedures and functions signatures (see Soft upgrade). - + - + Bug fixes Severe bugfix in lwgeom's 2d bounding box computation @@ -868,9 +866,9 @@ Bugfix in dumper handling of user-defined queries Bugfix in create_undef.pl script - + - + Improvements Small performance improvement in canonical input function @@ -882,17 +880,17 @@ Improvement in the postgis_restore.pl script New rebuild_bbox_caches.pl util script - - + + - + Release 1.0.2 Release date: 2005/07/04 Contains a few bug fixes and improvements. - + Upgrading If you are upgrading from release 1.0.0RC6 or up you @@ -901,9 +899,9 @@ Upgrading from older releases requires a dump/reload. See the upgrading chapter for more informations. - + - + Bug fixes Fault tolerant btree ops @@ -914,25 +912,25 @@ Cleaner build scripts (avoided mix of CFLAGS and CXXFLAGS) - + - + Improvements New index creation capabilities in loader (-I switch) Initial support for postgresql 8.1dev - - + + - + Release 1.0.1 Release date: 2005/05/24 Contains a few bug fixes and some improvements. - + Upgrading If you are upgrading from release 1.0.0RC6 or up you @@ -941,17 +939,17 @@ Upgrading from older releases requires a dump/reload. See the upgrading chapter for more informations. - + - + Library changes BUGFIX in 3d computation of length_spheroid() BUGFIX in join selectivity estimator - + - + Other changes/additions BUGFIX in shp2pgsql escape functions @@ -972,10 +970,10 @@ BUGFIX in Paris projections definitions postgis_restore.pl cleanups - - + + - + Release 1.0.0 Release date: 2005/04/19 @@ -984,7 +982,7 @@ in the loader (most notably support for older postgis versions), and more docs. - + Upgrading If you are upgrading from release 1.0.0RC6 you DO @@ -993,9 +991,9 @@ Upgrading from any other precedent release requires a dump/reload. See the upgrading chapter for more informations. - + - + Library changes BUGFIX in transform() releasing random memory address @@ -1005,9 +1003,9 @@ BUGFIX in join selectivity estimator (defaults, leaks, tuplecount, sd) - + - + Other changes/additions BUGFIX in shp2pgsql escape of values starting with tab or @@ -1025,10 +1023,10 @@ BUGFIX in estimator testers (support for LWGEOM and schema parsing) - - + + - + Release 1.0.0RC6 Release date: 2005/03/30 @@ -1036,38 +1034,38 @@ Sixth release candidate for 1.0.0. Contains a few bug fixes and cleanups. - + Upgrading You need a dump/reload to upgrade from precedent releases. See the upgrading chapter for more informations. - + - + Library changes BUGFIX in multi() early return [when noop] from multi() - + - + Scripts changes dropped {x,y}{min,max}(box2d) functions - + - + Other changes BUGFIX in postgis_restore.pl scrip BUGFIX in dumper's 64bit support - - + + - + Release 1.0.0RC5 Release date: 2005/03/25 @@ -1075,7 +1073,7 @@ Fifth release candidate for 1.0.0. Contains a few bug fixes and a improvements. - + Upgrading If you are upgrading from release 1.0.0RC4 you DO @@ -1084,27 +1082,27 @@ Upgrading from any other precedent release requires a dump/reload. See the upgrading chapter for more informations. - + - + Library changes BUGFIX (segfaulting) in box3d computation (yes, another!). BUGFIX (segfaulting) in estimated_extent(). - + - + Other changes Small build scripts and utilities refinements. Additional performance tips documented. - - + + - + Release 1.0.0RC4 Release date: 2005/03/18 @@ -1112,15 +1110,15 @@ Fourth release candidate for 1.0.0. Contains bug fixes and a few improvements. - + Upgrading You need a dump/reload to upgrade from precedent releases. See the upgrading chapter for more informations. - + - + Library changes BUGFIX (segfaulting) in geom_accum(). @@ -1136,18 +1134,18 @@ Consistency check fix in SnapToGrid(). Box2d output changed back to 15 significant digits. - + - + Scripts changes NEW distance_sphere() function. Changed get_proj4_from_srid implementation to use PL/PGSQL instead of SQL. - + - + Other changes BUGFIX in loader and dumper handling of MultiLine shapes @@ -1168,10 +1166,10 @@ improved version handling, central Version.config improvements in postgis_restore.pl - - + + - + Release 1.0.0RC3 Release date: 2005/02/24 @@ -1179,15 +1177,15 @@ Third release candidate for 1.0.0. Contains many bug fixes and improvements. - + Upgrading You need a dump/reload to upgrade from precedent releases. See the upgrading chapter for more informations. - + - + Library changes BUGFIX in transform(): missing SRID, better error @@ -1209,9 +1207,9 @@ Reduced memory usage by early releasing query-context palloced one. - + - + Scripts changes BUGFIX in 72 index bindings. @@ -1223,9 +1221,9 @@ Some functions made IMMUTABLE from STABLE, for performance improvement. - + - + JDBC changes jdbc2: small patches, box2d/3d tests, revised docs and @@ -1247,9 +1245,9 @@ servers. jdbc2: Fixed handling of measured geometries in EWKT. - + - + Other changes new performance tips chapter in manual @@ -1265,10 +1263,10 @@ spatial_ref_sys: changed Paris entries to match the ones distributed with 0.x. - - + + - + Release 1.0.0RC2 Release date: 2005/01/26 @@ -1276,15 +1274,15 @@ Second release candidate for 1.0.0 containing bug fixes and a few improvements. - + Upgrading You need a dump/reload to upgrade from precedent releases. See the upgrading chapter for more informations. - + - + Library changes BUGFIX in pointarray box3d computation @@ -1301,27 +1299,27 @@ Faster binary outputs Stricter OGC WKB/WKT constructors - + - + Scripts changes More correct STABLE, IMMUTABLE, STRICT uses in lwpostgis.sql stricter OGC WKB/WKT constructors - + - + Other changes Faster and more robust loader (both i18n and not) Initial autoconf script - - + + - + Release 1.0.0RC1 Release date: 2005/01/13 @@ -1330,15 +1328,15 @@ internal storage of postgis types redesigned to be smaller and faster on indexed queries. - + Upgrading You need a dump/reload to upgrade from precedent releases. See the upgrading chapter for more informations. - + - + Changes Faster canonical input parsing. @@ -1362,7 +1360,6 @@ PostGIS extension API. UTF8 support in loader. - - - + + \ No newline at end of file diff --git a/doc/template.xml b/doc/template.xml new file mode 100644 index 000000000..cf08c4fef --- /dev/null +++ b/doc/template.xml @@ -0,0 +1,69 @@ + + + + + ST_MyMethod + + Returns something useful + + + + + + boolean ST_MyMethod + Geometry g1 + Geometry g2 + + + + + boolean ST_MyMethod + Geometry g1 + Geometry g2 + varchar myparam + + + + + + Description + + Some useful description here. + + + + This function call will automatically include a bounding box + comparison that will make use of any indexes that are available on the + geometries. + + + + + + This method implements the + OpenGIS Simple + Features Implementation Specification for SQL + + + + + + This method implements the SQL/MM specification: SQL-MM 3: 5.1.23 + + + + + + Examples + + + + + + + See Also + + , ... + + + \ No newline at end of file -- 2.50.1