public inbox for [email protected]  

help / color / mirror / Atom feed

punctuation in function tables
2+ messages / 1 participants
[nested] [flat]

* punctuation in function tables
@ 2005-05-20 01:35  Neil Conway <[email protected]>
  0 siblings, 1 reply; 2+ messages in thread

From: Neil Conway @ 2005-05-20 01:35 UTC (permalink / raw)
  To: pgsql-docs

The function definition tables in func.sgml use punctuation 
inconsistently: some descriptions are terminated by a period, some are 
not. Is there any opinion on which variant is "correct"?

If not, I'll update the docs so that sentences in descriptions are 
separated by periods, rather than terminated: so single sentence 
descriptions will have no period, and multiple sentence descriptions 
will have periods except for the last sentence. I have a vague 
recollection that we use this style elsewhere...

-Neil



^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: punctuation in function tables
@ 2005-05-23 01:31  Neil Conway <[email protected]>
  parent: Neil Conway <[email protected]>
  0 siblings, 0 replies; 2+ messages in thread

From: Neil Conway @ 2005-05-23 01:31 UTC (permalink / raw)
  To: Neil Conway <[email protected]>; +Cc: pgsql-docs

Neil Conway wrote:
> The function definition tables in func.sgml use punctuation 
> inconsistently: some descriptions are terminated by a period, some are 
> not. Is there any opinion on which variant is "correct"?

I ended up not including a period in single-sentence function 
descriptions, but using both separating and terminating periods in 
multiple-sentence descriptions. Applied to HEAD.

-Neil




^ permalink  raw  reply  [nested|flat] 2+ messages in thread

end of thread, other threads:[~2005-05-23 01:31 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2005-05-20 01:35 punctuation in function tables Neil Conway <[email protected]>
2005-05-23 01:31 ` Neil Conway <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox