Inconsistent application of [, ...] in documentation
От | Oliver Rice |
---|---|
Тема | Inconsistent application of [, ...] in documentation |
Дата | |
Msg-id | CAKYAq67vavWsuaPGwqmT7K7n1wPEGZZxSKv4LH_dDG0j08q04A@mail.gmail.com обсуждение исходный текст |
Ответы |
Re: Inconsistent application of [, ...] in documentation
|
Список | pgsql-bugs |
Hi,
In the "Synopsis" part of "SQL Commands" section of the docs the "[, ...]" token appears to be applied inconsistently to either the preceding 1 token, or all preceding tokens within the same group.
For example:
Variant A:
GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } [, ...] | ALL [ PRIVILEGES ] } ON { [ TABLE ]table_name
[, ...] | ALL TABLES IN SCHEMAschema_name
[, ...] } TOrole_specification
[, ...] [ WITH GRANT OPTION ]
Relevant Extract:
"ALL TABLES IN SCHEMAschema_name
[, ...]"
Correct Usage:
"ALL TABLES IN SCHEMA public, api_v1"
Incorrect Usage:
"ALL TABLES IN SCHEMA public, ALL TABLES IN SCHEMA api_v1"
Variant B:
GRANT { EXECUTE | ALL [ PRIVILEGES ] } ON { { FUNCTION | PROCEDURE | ROUTINE }routine_name
[ ( [ [argmode
] [arg_name
]arg_type
[, ...] ] ) ] [, ...] | ALL { FUNCTIONS | PROCEDURES | ROUTINES } IN SCHEMAschema_name
[, ...] } TOrole_specification
[, ...] [ WITH GRANT OPTION ]
Relevant Extract:
"( [ [argmode
] [arg_name
]arg_type
[, ...] ] )"
Correct Usage:
"( first_param TEXT, second_param TEXT )"
Incorrect Usage:
"( first_param TEXT, TEXT)"
--So in Variant A, "[, ...]" is intended to apply to the immediately preceding token but in variant B it is intended to apply to all preceding tokens in the same group.
Thank you,
Oliver
В списке pgsql-bugs по дате отправления: