public inbox for [email protected]
help / color / mirror / Atom feedpunctuation in function tables
2+ messages / 1 participants
[nested] [flat]
* punctuation in function tables
@ 2005-05-20 01:35 Neil Conway <[email protected]>
2005-05-23 01:31 ` Re: punctuation in function tables 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-20 01:35 punctuation in function tables Neil Conway <[email protected]>
@ 2005-05-23 01:31 ` 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