Re: Autodocumenting plpgsql function - Mailing list pgsql-general

From Rémi Cura
Subject Re: Autodocumenting plpgsql function
Date
Msg-id CAJvUf_vA6Zt9_tZXiYC=jtrVcFRmDZ+GRtTMoW3ULZpTStxJRw@mail.gmail.com
Whole thread Raw
In response to Re: Autodocumenting plpgsql function  (Albe Laurenz <laurenz.albe@wien.gv.at>)
Responses Re: Autodocumenting plpgsql function
List pgsql-general
Hey thanks for the answer.

I'm thinking way more than that.
Typically in you comments you include special tags, like @input, then doxygen will parse it and generate an html documentation.

Cheers,

Rémi-C


2013/11/26 Albe Laurenz <laurenz.albe@wien.gv.at>
Rémi Cura wrote:
> somebody knows of a way to autodocument plpgsql function, in a docxygen style
> (adding tags in comments for instance, or creating doc templates to fill).
>
> It would really help to write the doc and maintain it.

I am not sure what you need, but I see two ways to
document a function:

1) With /** .. */ comments in the beginning.
   Maybe doxygen can be used to parse a database dump.

2) With COMMENT ON FUNCTION ... IS '...';
   That also keeps the documentation close to where
   the code is, and it shows up in database dumps.

Yours,
Laurenz Albe

pgsql-general by date:

Previous
From: Karsten Hilbert
Date:
Subject: a PostgreSQL slogan misused
Next
From: Peter Kroon
Date:
Subject: xmlagg doesn't honor LIMIT?