added pj_init_plus, proj_api.h

git-svn-id: http://svn.osgeo.org/metacrs/proj/trunk@946 4e78687f-474d-0410-85f9-8d5e500ac6b2

1 files changed, 21 insertions, 10 deletions

diff --git a/man/man3/pj_init.3 b/man/man3/pj_init.3
index d0b7e997..4edcabb6 100644
--- a/man/man3/pj_init.3
+++ b/man/man3/pj_init.3
@@ -1,30 +1,36 @@
 .\" @(#)pj_init.3 - 4.1
 .nr LL 5.5i
-.TH PJ_INIT 3U "2000/03/21 Rel. 4.4" 
+.TH PJ_INIT 3U "2001/04/05 Rel. 4.4" 
 .ad b
 .hy 1
 .SH NAME
 pj_init \- initialize cartographic projection
 .br
+pj_init_plus \- initialize cartographic projection
+.br
 pj_fwd \- forward cartographic projection
 .br
 pj_inv \- inverse cartographic projection
 .br
+pj_transform \- transform between coordinate systems
+.br
 pj_free \- de-initialize projection
 .SH SYNOPSIS
 .nf
-#include <projects.h>
+#include <proj_api.h>
+
+projPJ pj_init(int argc, char **argv)
 
-PJ *pj_init(int argc, char **argv)
+projPJ pj_init_plus(const char *defn)
 
-projUV pj_fwd(projUV val, PJ *proj)
+projUV pj_fwd(projUV val, projPJ proj)
 
-projUV pj_inv(projUV val, PJ *proj)
+projUV pj_inv(projUV val, projPJ proj)
 
-int pj_transform(PJ *src_cs, PJ *dst_cs, long point_count, 
+int pj_transform(projPJ src_cs, projPJ dst_cs, long point_count, 
                  double *x, double *y, double *z)
                
-void pj_free(PJ *proj)
+void pj_free(projPJ proj)
 
 .SH DESCRIPTION
 Procedure \fBpj_init\fR selects and initializes a cartographic projection
@@ -37,6 +43,10 @@ Earth's radius or elliptical parameters.
 If the initialization of the projection is successful a valid
 address is returned otherwise a NULL value.
 
+The \fBpj_init_plus\fR function operates similarly to \fBpj_init\fR but
+takes a single string containing the definition, with each parameter
+prefixed with a plus sign.  For example "+proj=utm +zone=11 +ellps=WGS84".
+
 Once initialization is performed either forward or inverse
 projections can be performed with the returned value of \fBpj_init\fR
 used as the argument \fBproj\fR.
@@ -48,7 +58,7 @@ set to HUGE_VAL (defined in \fImath.h\fR).
 
 \fBNote:\fR all projections have a forward mode, but some do not have
 an inverse projection.
-If the projection does not have an inverse the PJ structure element
+If the projection does not have an inverse the projPJ structure element
 \fIinv\fR will be NULL.
 
 The \fBpj_transform\fR function may be used to transform points between
@@ -70,11 +80,12 @@ a 33\(de latitude of true scale and prints the projected
 cartesian values in meters:
 .nf
 \f(CW
-#include <projects.h>
+#include <proj_api.h>
+
 main(int argc, char **argv) {
 	char *args[] = { "proj=merc", "ellps=clrk66", "lat_ts=33" };
 	projUV p;
-	PJ *pj;
+	projPJ pj;
 
 	if (!(pj = pj_init(3, args)))
 	   exit(1);