pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedQUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
9+ messages / 8 participants
[nested] [flat]
* QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
@ 2001-07-09 04:30 Justin Clift <justin@postgresql.org>
2001-07-09 12:31 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Bruce Momjian <pgman@candle.pha.pa.us>
2001-07-09 14:32 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Thomas Lockhart <lockhart@fourpalms.org>
2001-07-09 21:08 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Peter Eisentraut <peter_e@gmx.net>
0 siblings, 3 replies; 9+ messages in thread
From: Justin Clift @ 2001-07-09 04:30 UTC (permalink / raw)
To: pgsql-general@postgresql.org; pgsql-docs
Hi all,
We've had the go-ahead from the Linux Documentation Project (LDP) guys
to create a new PostgreSQL HOW-TO for a while now. I was going to start
it off just to make sure we had something, so that it could be put
around instead of Al Dev's Database Guide (the bad one).
Well, I haven't had time. Here's my thought, I'd like to know what
people think.
- How about we create a new PostgreSQL HOW-TO, have it as part of the
main distribution, and have that be the one which the LDP guys use?
They use DocBook format, as do we, and I feel this will allow us to keep
a very in-sync relationship between the new PostgreSQL HOW-TO and the
present version.
It also means that no one person has total control of it, and it can be
contributed to by anyone that has a suggestion and/or can generate a
diff.
So, what do people think?
:-)
Regards and best wishes,
Justin Clift
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
@ 2001-07-09 12:31 ` Bruce Momjian <pgman@candle.pha.pa.us>
2001-07-09 13:23 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Yasuo Ohgaki <yasuo_ohgaki@hotmail.com>
2 siblings, 1 reply; 9+ messages in thread
From: Bruce Momjian @ 2001-07-09 12:31 UTC (permalink / raw)
To: Justin Clift <justin@postgresql.org>; +Cc: pgsql-general@postgresql.org; pgsql-docs
> Hi all,
>
> We've had the go-ahead from the Linux Documentation Project (LDP) guys
> to create a new PostgreSQL HOW-TO for a while now. I was going to start
> it off just to make sure we had something, so that it could be put
> around instead of Al Dev's Database Guide (the bad one).
>
> Well, I haven't had time. Here's my thought, I'd like to know what
> people think.
>
> - How about we create a new PostgreSQL HOW-TO, have it as part of the
> main distribution, and have that be the one which the LDP guys use?
>
> They use DocBook format, as do we, and I feel this will allow us to keep
> a very in-sync relationship between the new PostgreSQL HOW-TO and the
> present version.
>
> It also means that no one person has total control of it, and it can be
> contributed to by anyone that has a suggestion and/or can generate a
> diff.
I always wondered how a HOTTO differs from an FAQ or the existing docs.
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
2001-07-09 12:31 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Bruce Momjian <pgman@candle.pha.pa.us>
@ 2001-07-09 13:23 ` Yasuo Ohgaki <yasuo_ohgaki@hotmail.com>
2001-07-09 14:08 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Mitch Vincent <mvincent@cablespeed.com>
0 siblings, 1 reply; 9+ messages in thread
From: Yasuo Ohgaki @ 2001-07-09 13:23 UTC (permalink / raw)
To: Bruce Momjian <pgman@candle.pha.pa.us>; Justin Clift <justin@postgresql.org>; +Cc: pgsql-general@postgresql.org; pgsql-docs
> > Hi all,
> >
> > We've had the go-ahead from the Linux Documentation Project (LDP) guys
> > to create a new PostgreSQL HOW-TO for a while now. I was going to start
> > it off just to make sure we had something, so that it could be put
> > around instead of Al Dev's Database Guide (the bad one).
*SNIP*
>
> I always wondered how a HOWTO differs from an FAQ or the existing docs.
I think
- HOWTO: Simpler documents that describe how to set sysmtems up and use.
- FAQ: Documents that list question and answer for subjects.
- Other: Books/Articles/Manuals/References describe subjects in detail and much
longer than HOWTO. (?)
For a long time, I thougt HOWTO is docuement for "quick start". Isn't it?
--
Ohgaki, Yasuo
Mail: yohgaki@dd.iij4u.or.jp
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
2001-07-09 12:31 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Bruce Momjian <pgman@candle.pha.pa.us>
2001-07-09 13:23 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Yasuo Ohgaki <yasuo_ohgaki@hotmail.com>
@ 2001-07-09 14:08 ` Mitch Vincent <mvincent@cablespeed.com>
2001-07-11 01:53 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 9+ messages in thread
From: Mitch Vincent @ 2001-07-09 14:08 UTC (permalink / raw)
To: pgsql-general@postgresql.org; pgsql-docs
> For a long time, I thougt HOWTO is docuement for "quick start". Isn't it?
I'm not sure there is an understood meaning of what a HOWTO actually it.
It's an explanation of how to do something, I guess... Generally I've found
(as in your example) that it's putting software together and making it work,
like Apache/SSL/Frontpage/something -- for that there is no single document
that describes how to set it up. I really don't think the PostgreSQL
installation guide could get much more simple -- why re-invent the wheel
here?
-Mitch
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
2001-07-09 12:31 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Bruce Momjian <pgman@candle.pha.pa.us>
2001-07-09 13:23 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Yasuo Ohgaki <yasuo_ohgaki@hotmail.com>
2001-07-09 14:08 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Mitch Vincent <mvincent@cablespeed.com>
@ 2001-07-11 01:53 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2001-07-11 03:26 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
0 siblings, 1 reply; 9+ messages in thread
From: Thomas Lockhart @ 2001-07-11 01:53 UTC (permalink / raw)
To: Mitch Vincent <mvincent@cablespeed.com>; +Cc: pgsql-general@postgresql.org; pgsql-docs
> > For a long time, I thougt HOWTO is docuement for "quick start". Isn't it?
> I'm not sure there is an understood meaning of what a HOWTO actually it.
> It's an explanation of how to do something, I guess... Generally I've found
> (as in your example) that it's putting software together and making it work,
> like Apache/SSL/Frontpage/something -- for that there is no single document
> that describes how to set it up. I really don't think the PostgreSQL
> installation guide could get much more simple -- why re-invent the wheel
> here?
To have adequate representation of PostgreSQL in the LDP docs set.
It may be sufficient to package the installation guide with some
Linux-specific FAQ information (which afaik is now obsolete and could be
freshened and moved to the SGML-based docs).
- Thomas
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
2001-07-09 12:31 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Bruce Momjian <pgman@candle.pha.pa.us>
2001-07-09 13:23 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Yasuo Ohgaki <yasuo_ohgaki@hotmail.com>
2001-07-09 14:08 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Mitch Vincent <mvincent@cablespeed.com>
2001-07-11 01:53 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Thomas Lockhart <lockhart@alumni.caltech.edu>
@ 2001-07-11 03:26 ` Justin Clift <justin@postgresql.org>
0 siblings, 0 replies; 9+ messages in thread
From: Justin Clift @ 2001-07-11 03:26 UTC (permalink / raw)
To: thomas@pgsql.com; +Cc: Mitch Vincent <mvincent@cablespeed.com>; pgsql-general@postgresql.org; pgsql-docs
Yep.
That's exactly why we need to get it done. A document already exists.
And it's badly wrong. And we can't just "fix it".
We need a replacement. :-)
I like Thomas's suggestion of using the existing installation guide, and
making sure it has Linux specific stuff in it too.
So, I think that's what we'll do.
Regards and best wishes,
Justin Clift
Thomas Lockhart wrote:
>
> To have adequate representation of PostgreSQL in the LDP docs set.
>
> It may be sufficient to package the installation guide with some
> Linux-specific FAQ information (which afaik is now obsolete and could be
> freshened and moved to the SGML-based docs).
>
> - Thomas
>
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Don't 'kill -9' the postmaster
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
@ 2001-07-09 14:32 ` Thomas Lockhart <lockhart@fourpalms.org>
2 siblings, 0 replies; 9+ messages in thread
From: Thomas Lockhart @ 2001-07-09 14:32 UTC (permalink / raw)
To: Justin Clift <justin@postgresql.org>; +Cc: pgsql-general@postgresql.org; pgsql-docs
> ... How about we create a new PostgreSQL HOW-TO...
Yes, yes, yes. I've been wanting to do the same thing for some time now.
Count me in for some work.
- Thomas
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
@ 2001-07-09 21:08 ` Peter Eisentraut <peter_e@gmx.net>
2 siblings, 0 replies; 9+ messages in thread
From: Peter Eisentraut @ 2001-07-09 21:08 UTC (permalink / raw)
To: Justin Clift <justin@postgresql.org>; +Cc: pgsql-general@postgresql.org; pgsql-docs
Justin Clift writes:
> - How about we create a new PostgreSQL HOW-TO, have it as part of the
> main distribution, and have that be the one which the LDP guys use?
Our Tutorial needs A LOT of work. Perhaps these efforts could somehow be
combined. I know I'm going to do some work on the Tutorial soon if no one
beats me to it. I don't know whether the LDP has any specific artistic
expectations for its HOWTOs, though.
--
Peter Eisentraut peter_e@gmx.net http://funkturm.homeip.net/~peter
^ permalink raw reply [nested|flat] 9+ messages in thread
* RE: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution
@ 2001-07-09 13:20 Michael Ansley (UK) <Michael.Ansley@intec-telecom-systems.com>
0 siblings, 0 replies; 9+ messages in thread
From: Michael Ansley (UK) @ 2001-07-09 13:20 UTC (permalink / raw)
To: 'Bruce Momjian' <pgman@candle.pha.pa.us>; +Cc: pgsql-general@postgresql.org; pgsql-docs
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
I've always found the HOWTOs useful to get something up and going for
the first time. HOWTOs *don't* generally explain how or why things
work or don't work, and make various blanket assumptions about your
environment (although they will normally indicate those). What they
do is get a particular package up and working for you. A good
example is the Apache+SSL+FrontPage+SomethingElse HOWTO. When I got
to the end of the HOWTO, I still didn't have much idea of how the
packages worked, but I had a working system that I could start trying
things out on. And from there, I could start understanding the
system. It's the first step in a long process, but that first step
is frequently the most frustrating (and where a lot of people stop),
and the HOWTOs are written to ease that first step. So, yes it is
different from a FAQ. I'm not sure if there is a section like this
in the existing docs, I'm not that familiar with them. But anyway,
that's what I understand a HOWTO to be, and I've found them extremely
useful in the past.
Cheers...
>> -----Original Message-----
>> From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
>> Sent: 09 July 2001 13:31
>> To: Justin Clift
>> Cc: pgsql-general@postgresql.org; pgsql-docs@postgresql.org
>> Subject: [GENERAL] Re: [DOCS] QUERY - Including the new LDP
>> PostgreSQL
>> HOWTO in the main PostgreSQL distribution
>>
>>
>> > Hi all,
>> >
>> > We've had the go-ahead from the Linux Documentation
>> Project (LDP) guys
>> > to create a new PostgreSQL HOW-TO for a while now. I was
>> going to start
>> > it off just to make sure we had something, so that it could be
>> > put around instead of Al Dev's Database Guide (the bad one).
>> >
>> > Well, I haven't had time. Here's my thought, I'd like to know
>> > what people think.
>> >
>> > - How about we create a new PostgreSQL HOW-TO, have it as
>> part of the
>> > main distribution, and have that be the one which the LDP guys
>> > use?
>> >
>> > They use DocBook format, as do we, and I feel this will
>> allow us to keep
>> > a very in-sync relationship between the new PostgreSQL
>> HOW-TO and the
>> > present version.
>> >
>> > It also means that no one person has total control of it,
>> and it can be
>> > contributed to by anyone that has a suggestion and/or can
>> generate a
>> > diff.
>>
>> I always wondered how a HOTTO differs from an FAQ or the
>> existing docs.
>>
>> --
>> Bruce Momjian | http://candle.pha.pa.us
>> pgman@candle.pha.pa.us | (610) 853-3000
>> + If your life is a hard drive, | 830 Blythe Avenue
>> + Christ can be your backup. | Drexel Hill,
>> Pennsylvania 19026
>>
>> ---------------------------(end of
>> broadcast)---------------------------
>> TIP 4: Don't 'kill -9' the postmaster
>>
-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 6.5.3 for non-commercial use <http://www.pgp.com;
iQA/AwUBO0mvYXympNV/C086EQLWOQCg6ULUWZYuaIewgkXwsjBzbi6xpAMAoJ1o
3Jcoif6bvt7dTRwan7U+th9i
=V2r7
-----END PGP SIGNATURE-----
^ permalink raw reply [nested|flat] 9+ messages in thread
end of thread, other threads:[~2001-07-11 03:26 UTC | newest]
Thread overview: 9+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-07-09 04:30 QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
2001-07-09 12:31 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Bruce Momjian <pgman@candle.pha.pa.us>
2001-07-09 13:23 ` Yasuo Ohgaki <yasuo_ohgaki@hotmail.com>
2001-07-09 14:08 ` Mitch Vincent <mvincent@cablespeed.com>
2001-07-11 01:53 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Thomas Lockhart <lockhart@alumni.caltech.edu>
2001-07-11 03:26 ` Re: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Justin Clift <justin@postgresql.org>
2001-07-09 14:32 ` Thomas Lockhart <lockhart@fourpalms.org>
2001-07-09 21:08 ` Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Peter Eisentraut <peter_e@gmx.net>
2001-07-09 13:20 RE: [GENERAL] Re: QUERY - Including the new LDP PostgreSQL HOWTO in the main PostgreSQL distribution Michael Ansley (UK) <Michael.Ansley@intec-telecom-systems.com>
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