Re: [Pgsqlrpms-hackers] Re: DBlink documentation

Tom Lane wrote:
> Joe Conway <mail(at)joeconway(dot)com> writes:
> > I'm happy to lump all the docs back into the README if that's what you
> > want, but I split it up in the first place because it was getting very long.
>
> No, I'm not really proposing that we force all contrib modules to have
> only a README. I'm just annoyed by the lack of consistency (dblink/doc
> versus tsearch2/docs, and some of the other modules seem to have some
> doc files just loose in their top directory).
>
> It's not only the downstream packagers that have missed these: the
> Makefiles don't install them either.
>
> It'd be a good idea to settle on what we want the installed file layout
> to be --- do we need to create subdirectories under {prefix}/doc to
> forestall name conflicts?

I personally never saw those doc/ files when I was modifying dblink. I
had to grope around in the regression tests to see how the functions
worked.

--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073