Обсуждение: Minor doc correction for SPI_execute_with_args

Hi

The documentation for SPI_execute_with_args:

  http://www.postgresql.org/docs/current/static/spi-spi-execute-with-args.html

claims it returns the same value as SPI_execute, whereas it actually
calls SPI_execute_plan which can produce two additional error codes.


Regards

Ian Barwick

--
 Ian Barwick                   http://www.2ndQuadrant.com/
 PostgreSQL Development, 24x7 Support, Training & Services

Ian Barwick <ian@2ndquadrant.com> writes:
> The documentation for SPI_execute_with_args:
>   http://www.postgresql.org/docs/current/static/spi-spi-execute-with-args.html
> claims it returns the same value as SPI_execute, whereas it actually
> calls SPI_execute_plan which can produce two additional error codes.

But SPI_execute also calls _SPI_execute_plan.  Moreover, the documented
reasons for SPI_execute_plan to return additional error codes don't match
up too closely with SPI_execute_with_args (eg, there's no "plan"
argument, so saying "plan was prepared with some parameters" is pretty
meaningless here).

If what you're looking at is the extra error conditions right at the start
of SPI_execute_with_args, my inclination would be to document them without
any reference to SPI_execute_plan, ie we'd add text much like what's
under SPI_execute_plan but with the descriptions of the error codes
adjusted to agree with this function.

            regards, tom lane