On Oct 30, 2012, at 2:08 PM, Peter Eisentraut <pete...@gmx.net> wrote:
>> True, which is why I was thinking of something relatively light-weight >> and self-contained like sundown. > > That's a markdown library, which transforms markdown to HTML, right? So > what would we do with the HTML? Put it into the HTML directory (share/docs/html/extensions/$extension.html) and inject its name into the TOC. I'd also be in favor of adding hooks to generate man pages. > I don't agree with this approach. There is no need to be prescriptive. > Enforcing a documentation format won't make better, or any, > documentation anyway. My point isn't to be prescriptive, but that actual code tends to win out in the end, as opposed to discussion. (Which, yes, I have started.) > That said, if there are things we could put in, e.g., pgxs, to make > building documentation simpler, we can discuss that. Yeah, that would be ideal. But if no one has really thought about how to go about it yet… David -- Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-hackers