Re: Clarify deleting comments and security labels in synopsis

2023-02-01 Thread Dagfinn Ilmari Mannsåker
Tom Lane writes: > =?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= writes: >> Tom Lane writes: >>> Agreed; as-is, the syntax summary is not just confusing but outright >>> wrong. >>> >>> I think we could go further and split the entry under Parameters >>> to match: > >> Makes sense. Something like t

Re: Clarify deleting comments and security labels in synopsis

2023-01-31 Thread Tom Lane
=?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= writes: > Tom Lane writes: >> Agreed; as-is, the syntax summary is not just confusing but outright >> wrong. >> >> I think we could go further and split the entry under Parameters >> to match: > Makes sense. Something like the attached v2? WFM, will pu

Re: Clarify deleting comments and security labels in synopsis

2023-01-31 Thread Dagfinn Ilmari Mannsåker
Tom Lane writes: > =?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= writes: >> A user on IRC was confused about how to delete a security label using >> the `SECURITY LABLEL ON … IS …` command, and looking at the docs I can >> see why. > >> The synopsis just says `IS 'label'`, which implies that it can

Re: Clarify deleting comments and security labels in synopsis

2023-01-31 Thread Tom Lane
=?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= writes: > A user on IRC was confused about how to delete a security label using > the `SECURITY LABLEL ON … IS …` command, and looking at the docs I can > see why. > The synopsis just says `IS 'label'`, which implies that it can only be a > string. It's n

Clarify deleting comments and security labels in synopsis

2023-01-31 Thread Dagfinn Ilmari Mannsåker
Hi Hackers, A user on IRC was confused about how to delete a security label using the `SECURITY LABLEL ON … IS …` command, and looking at the docs I can see why. The synopsis just says `IS 'label'`, which implies that it can only be a string. It's not until you read the description for `label` th