Doc patch: type modifiers

Started by Jeff Davisabout 18 years ago4 messagespatches
Jump to latest
#1Jeff Davis
pgsql@j-davis.com

From
http://developer.postgresql.org/pgdocs/postgres/sql-createtype.html :

type_modifier_input_function

The name of a function that converts numeric modifier(s) for the
type into internal form.

type_modifier_output_function

The name of a function that converts the internal form of the
type's modifier(s) to external textual form.

But the paragraph above says:

"...take one or more simple constants or identifiers as modifiers..."

So in the description of the input function, "numeric" is wrong, and
should be something like "textual" (for the sake of symmetry).

Patch attached.

Regards,
Jeff Davis

Attachments:

typmod_doc.patchtext/x-patch; charset=UTF-8; name=typmod_doc.patchDownload+1-1
#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Jeff Davis (#1)
Re: Doc patch: type modifiers

Jeff Davis <pgsql@j-davis.com> writes:

From
http://developer.postgresql.org/pgdocs/postgres/sql-createtype.html :
type_modifier_input_function
The name of a function that converts numeric modifier(s) for the
type into internal form.

Yeah, this text is a holdover from the original user-definable-modifiers
patch, in which the modifiers indeed had to be numbers. I don't quite
like your suggestion of using "textual", though, because that makes it
sound like the input and output functions are exact inverses, which they
are not. How about "... converts an array of modifier(s) for ..."?

regards, tom lane

#3Jeff Davis
pgsql@j-davis.com
In reply to: Tom Lane (#2)
Re: Doc patch: type modifiers

On Tue, 2008-05-27 at 12:08 -0400, Tom Lane wrote:

Yeah, this text is a holdover from the original user-definable-modifiers
patch, in which the modifiers indeed had to be numbers. I don't quite
like your suggestion of using "textual", though, because that makes it
sound like the input and output functions are exact inverses, which they
are not. How about "... converts an array of modifier(s) for ..."?

Sounds good to me.

Regards,
Jeff Davis

#4Tom Lane
tgl@sss.pgh.pa.us
In reply to: Jeff Davis (#3)
Re: Doc patch: type modifiers

Jeff Davis <pgsql@j-davis.com> writes:

On Tue, 2008-05-27 at 12:08 -0400, Tom Lane wrote:

How about "... converts an array of modifier(s) for ..."?

Sounds good to me.

OK, done.

regards, tom lane