Bruce Momjian wrote:
> I looked at that URL, and it is good example of what _not_ to do with
> interactive docs, IMHO.  The manual page is _very_ short, and shows no
> examples.  The comments have various examples/cases, with corrections
> later to earlier postings.  I would think this is not what we want. We
> want a longer manual page, with _correct_ examples that show typical
> usage.
> I know folks like those comments, but isn't it showing cases where the
> curt documentation just doesn't cut it?

Bruce is spot on here.  Manuals pages that don't need an extensive
amount of comments are likely the best way to go, and they're even
distributed with the source code of PostgreSQL, unlike the comments.


Regards and best wishes,

Justin Clift

"My grandfather once told me that there are two kinds of people: those
who work and those who take the credit. He told me to try to be in the
first group; there was less competition there."
- Indira Gandhi

---------------------------(end of broadcast)---------------------------
TIP 2: you can get off all lists at once with the unregister command
   (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])

Reply via email to