Minor fixes.
authorTom Lane
Mon, 22 Jan 2001 16:11:17 +0000 (16:11 +0000)
committerTom Lane
Mon, 22 Jan 2001 16:11:17 +0000 (16:11 +0000)
doc/src/sgml/xfunc.sgml

index cafaf47b4e5f0be15be96fdc1962d0a3f18d97ed..766aa905b901cb2dfba30df980f6faef3b1b8113 100644 (file)
@@ -1,5 +1,5 @@
 
 
  
@@ -874,12 +874,12 @@ PG_FUNCTION_INFO_V1(funcname);
      PG_GETARG_xxx()
      macro that corresponds to the argument's datatype, and the result
      is returned using a
-     PG_GETARG_xxx()
+     PG_RETURN_xxx()
      macro for the return type.
     
 
     
-     Here we show the same functions as above, coded in new style:
+     Here we show the same functions as above, coded in version-1 style:
 
 
 #include <string.h>
@@ -916,6 +916,7 @@ PG_FUNCTION_INFO_V1(makepoint);
 Datum
 makepoint(PG_FUNCTION_ARGS)
 {
+    /* Here, the pass-by-reference nature of Point is not hidden */
     Point     *pointx = PG_GETARG_POINT_P(0);
     Point     *pointy = PG_GETARG_POINT_P(1);
     Point     *new_point = (Point *) palloc(sizeof(Point));
@@ -969,7 +970,7 @@ concat_text(PG_FUNCTION_ARGS)
 
     
      The CREATE FUNCTION commands are the same as
-     for the old-style equivalents.
+     for the version-0 equivalents.
     
 
     
@@ -994,7 +995,9 @@ concat_text(PG_FUNCTION_ARGS)
      test for NULL inputs to a non-strict function, return a NULL
      result (from either strict or non-strict functions), return
      set results, and implement trigger functions and
-     procedural-language call handlers.  For more details see
+     procedural-language call handlers.  Version-1 code is also more
+     portable than version-0, because it does not break ANSI C restrictions
+     on function call protocol.  For more details see
      src/backend/utils/fmgr/README in the source
      distribution.