pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedGet docs for contrib on the web somewhere
8+ messages / 4 participants
[nested] [flat]
* Get docs for contrib on the web somewhere
@ 2006-03-08 19:50 Jim C. Nasby <jnasby@pervasive.com>
0 siblings, 1 reply; 8+ messages in thread
From: Jim C. Nasby @ 2006-03-08 19:50 UTC (permalink / raw)
To: pgsql-docs
It would be nice if there was an easy place to see the documentation for
the various contrib projects. Would this be hard to setup? I think the
plain text would be fine, just need to post the readme's somewhere and
link to them.
--
Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-08 22:05 David Fetter <david@fetter.org>
parent: Jim C. Nasby <jnasby@pervasive.com>
0 siblings, 1 reply; 8+ messages in thread
From: David Fetter @ 2006-03-08 22:05 UTC (permalink / raw)
To: Jim C. Nasby <jnasby@pervasive.com>; +Cc: pgsql-docs
On Wed, Mar 08, 2006 at 01:50:47PM -0600, Jim C. Nasby wrote:
> It would be nice if there was an easy place to see the documentation
> for the various contrib projects. Would this be hard to setup? I
> think the plain text would be fine, just need to post the readme's
> somewhere and link to them.
http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/ has at least
the raw files. I'd be delighted to put up something more, tho :)
Cheers,
D
--
David Fetter david@fetter.org http://fetter.org/
phone: +1 415 235 3778
Remember to vote!
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-17 18:22 Jim C. Nasby <jnasby@pervasive.com>
parent: David Fetter <david@fetter.org>
0 siblings, 1 reply; 8+ messages in thread
From: Jim C. Nasby @ 2006-03-17 18:22 UTC (permalink / raw)
To: David Fetter <david@fetter.org>; +Cc: pgsql-docs
On Wed, Mar 08, 2006 at 02:05:44PM -0800, David Fetter wrote:
> On Wed, Mar 08, 2006 at 01:50:47PM -0600, Jim C. Nasby wrote:
> > It would be nice if there was an easy place to see the documentation
> > for the various contrib projects. Would this be hard to setup? I
> > think the plain text would be fine, just need to post the readme's
> > somewhere and link to them.
>
> http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/ has at least
> the raw files. I'd be delighted to put up something more, tho :)
Yeah, but very few people would ever think to look in CVS for
documentation. I think it'd be much better if we could include the
README's in the documentation build process somehow...
--
Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-17 18:40 David Fetter <david@fetter.org>
parent: Jim C. Nasby <jnasby@pervasive.com>
0 siblings, 1 reply; 8+ messages in thread
From: David Fetter @ 2006-03-17 18:40 UTC (permalink / raw)
To: Jim C. Nasby <jnasby@pervasive.com>; +Cc: pgsql-docs
On Fri, Mar 17, 2006 at 12:22:44PM -0600, Jim C. Nasby wrote:
> On Wed, Mar 08, 2006 at 02:05:44PM -0800, David Fetter wrote:
> > On Wed, Mar 08, 2006 at 01:50:47PM -0600, Jim C. Nasby wrote:
> > > It would be nice if there was an easy place to see the documentation
> > > for the various contrib projects. Would this be hard to setup? I
> > > think the plain text would be fine, just need to post the readme's
> > > somewhere and link to them.
> >
> > http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/ has at least
> > the raw files. I'd be delighted to put up something more, tho :)
>
> Yeah, but very few people would ever think to look in CVS for
> documentation. I think it'd be much better if we could include the
> README's in the documentation build process somehow...
I'm all for it. Do you have an idea of how this might work? I
suppose some kind of idiot conversion of READMEs to man pages might be
appropriate. Dunno about what would happen on Windows. Um, help?
Cheers,
D
--
David Fetter <david@fetter.org> http://fetter.org/
phone: +1 415 235 3778 AIM: dfetter666
Skype: davidfetter
Remember to vote!
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-17 21:19 Robert Treat <xzilla@users.sourceforge.net>
parent: David Fetter <david@fetter.org>
0 siblings, 1 reply; 8+ messages in thread
From: Robert Treat @ 2006-03-17 21:19 UTC (permalink / raw)
To: pgsql-docs; +Cc: David Fetter <david@fetter.org>; Jim C. Nasby <jnasby@pervasive.com>
On Friday 17 March 2006 13:40, David Fetter wrote:
> On Fri, Mar 17, 2006 at 12:22:44PM -0600, Jim C. Nasby wrote:
> > On Wed, Mar 08, 2006 at 02:05:44PM -0800, David Fetter wrote:
> > > On Wed, Mar 08, 2006 at 01:50:47PM -0600, Jim C. Nasby wrote:
> > > > It would be nice if there was an easy place to see the documentation
> > > > for the various contrib projects. Would this be hard to setup? I
> > > > think the plain text would be fine, just need to post the readme's
> > > > somewhere and link to them.
> > >
> > > http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/ has at least
> > > the raw files. I'd be delighted to put up something more, tho :)
> >
> > Yeah, but very few people would ever think to look in CVS for
> > documentation. I think it'd be much better if we could include the
> > README's in the documentation build process somehow...
>
> I'm all for it. Do you have an idea of how this might work? I
> suppose some kind of idiot conversion of READMEs to man pages might be
> appropriate. Dunno about what would happen on Windows. Um, help?
>
Could we require contrib authors to provide their documentation as sgml, and
then have the doc build process loop in each contrib module as an appendix
inside the official docs?
--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-18 06:31 Jim C. Nasby <jnasby@pervasive.com>
parent: Robert Treat <xzilla@users.sourceforge.net>
0 siblings, 1 reply; 8+ messages in thread
From: Jim C. Nasby @ 2006-03-18 06:31 UTC (permalink / raw)
To: Robert Treat <xzilla@users.sourceforge.net>; +Cc: pgsql-docs@postgresql.org, David Fetter <david@fetter.org>
On Fri, Mar 17, 2006 at 04:19:58PM -0500, Robert Treat wrote:
> > > Yeah, but very few people would ever think to look in CVS for
> > > documentation. I think it'd be much better if we could include the
> > > README's in the documentation build process somehow...
> >
> > I'm all for it. Do you have an idea of how this might work? I
> > suppose some kind of idiot conversion of READMEs to man pages might be
> > appropriate. Dunno about what would happen on Windows. Um, help?
> >
>
> Could we require contrib authors to provide their documentation as sgml, and
> then have the doc build process loop in each contrib module as an appendix
> inside the official docs?
Can't we just copy the text files over somewhere?
Actually, there was talk of improving the way that the contrib installs
handled the README's, so maybe part of that could be used here.
--
Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-18 07:00 Tom Lane <tgl@sss.pgh.pa.us>
parent: Jim C. Nasby <jnasby@pervasive.com>
0 siblings, 1 reply; 8+ messages in thread
From: Tom Lane @ 2006-03-18 07:00 UTC (permalink / raw)
To: Jim C. Nasby <jnasby@pervasive.com>; +Cc: Robert Treat <xzilla@users.sourceforge.net>; pgsql-docs@postgresql.org, David Fetter <david@fetter.org>
"Jim C. Nasby" <jnasby@pervasive.com> writes:
> On Fri, Mar 17, 2006 at 04:19:58PM -0500, Robert Treat wrote:
>> Could we require contrib authors to provide their documentation as sgml, and
>> then have the doc build process loop in each contrib module as an appendix
>> inside the official docs?
> Can't we just copy the text files over somewhere?
I think the entire point of contrib is that it's "not ready for prime
time" code, and one of the ways in which it's likely to be not ready
is not having sgml-format documentation.
If someone wants to step up and do the work to convert the existing
contrib doc files to sgml, I certainly won't stand in the way --- but
I'm not prepared to remove contrib entries just because they don't have
sgml-format docs.
regards, tom lane
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Get docs for contrib on the web somewhere
@ 2006-03-18 07:16 Robert Treat <xzilla@users.sourceforge.net>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 8+ messages in thread
From: Robert Treat @ 2006-03-18 07:16 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Jim C. Nasby <jnasby@pervasive.com>; pgsql-docs@postgresql.org, David Fetter <david@fetter.org>
On Saturday 18 March 2006 02:00, Tom Lane wrote:
> "Jim C. Nasby" <jnasby@pervasive.com> writes:
> > On Fri, Mar 17, 2006 at 04:19:58PM -0500, Robert Treat wrote:
> >> Could we require contrib authors to provide their documentation as sgml,
> >> and then have the doc build process loop in each contrib module as an
> >> appendix inside the official docs?
> >
> > Can't we just copy the text files over somewhere?
>
> I think the entire point of contrib is that it's "not ready for prime
> time" code, and one of the ways in which it's likely to be not ready
> is not having sgml-format documentation.
>
> If someone wants to step up and do the work to convert the existing
> contrib doc files to sgml, I certainly won't stand in the way --- but
> I'm not prepared to remove contrib entries just because they don't have
> sgml-format docs.
>
Well sure... I'd probably be willing to help out with that, considering that
(in theory) we're going to be removing some of them anyway, so that would cut
down on the work. And this could be a requirement for future contrib items. I
think the real question is would someone be willing to step up and fix the
build process to pull these items into the main docs if they were to be
converted to sgml. I think that's the harder of the two problems to solve.
--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL
^ permalink raw reply [nested|flat] 8+ messages in thread
end of thread, other threads:[~2006-03-18 07:16 UTC | newest]
Thread overview: 8+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2006-03-08 19:50 Get docs for contrib on the web somewhere Jim C. Nasby <jnasby@pervasive.com>
2006-03-08 22:05 ` David Fetter <david@fetter.org>
2006-03-17 18:22 ` Jim C. Nasby <jnasby@pervasive.com>
2006-03-17 18:40 ` David Fetter <david@fetter.org>
2006-03-17 21:19 ` Robert Treat <xzilla@users.sourceforge.net>
2006-03-18 06:31 ` Jim C. Nasby <jnasby@pervasive.com>
2006-03-18 07:00 ` Tom Lane <tgl@sss.pgh.pa.us>
2006-03-18 07:16 ` Robert Treat <xzilla@users.sourceforge.net>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox