pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedpg_xlogdump docs
4+ messages / 2 participants
[nested] [flat]
* pg_xlogdump docs
@ 2013-05-03 23:27 Bruce Momjian <bruce@momjian.us>
2013-05-03 23:36 ` Re: pg_xlogdump docs Alvaro Herrera <alvherre@2ndquadrant.com>
0 siblings, 1 reply; 4+ messages in thread
From: Bruce Momjian @ 2013-05-03 23:27 UTC (permalink / raw)
To: pgsql-docs
I just noticed that pg_xlogdump uses an underscore in the file name,
pg_xlogdump.sgml, unlike every other extension. Should this be fixed?
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: pg_xlogdump docs
2013-05-03 23:27 pg_xlogdump docs Bruce Momjian <bruce@momjian.us>
@ 2013-05-03 23:36 ` Alvaro Herrera <alvherre@2ndquadrant.com>
2013-05-03 23:42 ` Re: pg_xlogdump docs Bruce Momjian <bruce@momjian.us>
0 siblings, 1 reply; 4+ messages in thread
From: Alvaro Herrera @ 2013-05-03 23:36 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: pgsql-docs
Bruce Momjian wrote:
> I just noticed that pg_xlogdump uses an underscore in the file name,
> pg_xlogdump.sgml, unlike every other extension. Should this be fixed?
I did mess about with hyphens vs. underscores vs. nothing at all. Most
seem to use no char, so "pgrowlocks.sgml" for example, but that
convention seemed ugly for filenames so I went with the underscore.
Note that the SGML ID does not have anything, so the URL is similar to
others:
http://www.postgresql.org/docs/devel/static/pgxlogdump.html
We do have other files that use underscores, anyway.
--
Álvaro Herrera http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: pg_xlogdump docs
2013-05-03 23:27 pg_xlogdump docs Bruce Momjian <bruce@momjian.us>
2013-05-03 23:36 ` Re: pg_xlogdump docs Alvaro Herrera <alvherre@2ndquadrant.com>
@ 2013-05-03 23:42 ` Bruce Momjian <bruce@momjian.us>
2013-05-03 23:48 ` Re: pg_xlogdump docs Alvaro Herrera <alvherre@2ndquadrant.com>
0 siblings, 1 reply; 4+ messages in thread
From: Bruce Momjian @ 2013-05-03 23:42 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@2ndquadrant.com>; +Cc: pgsql-docs
On Fri, May 3, 2013 at 07:36:09PM -0400, Alvaro Herrera wrote:
> Bruce Momjian wrote:
> > I just noticed that pg_xlogdump uses an underscore in the file name,
> > pg_xlogdump.sgml, unlike every other extension. Should this be fixed?
>
> I did mess about with hyphens vs. underscores vs. nothing at all. Most
> seem to use no char, so "pgrowlocks.sgml" for example, but that
> convention seemed ugly for filenames so I went with the underscore.
> Note that the SGML ID does not have anything, so the URL is similar to
> others:
> http://www.postgresql.org/docs/devel/static/pgxlogdump.html
>
> We do have other files that use underscores, anyway.
Well, we have only four:
generate_history.pl information_schema.sgml mk_feature_tables.pl
pg_xlogdump.sgml
Two are Perl scripts. I agree the lack of an underscore makes it look
ugly, but if we are going to improve it, I think we should all of them
or none of them.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: pg_xlogdump docs
2013-05-03 23:27 pg_xlogdump docs Bruce Momjian <bruce@momjian.us>
2013-05-03 23:36 ` Re: pg_xlogdump docs Alvaro Herrera <alvherre@2ndquadrant.com>
2013-05-03 23:42 ` Re: pg_xlogdump docs Bruce Momjian <bruce@momjian.us>
@ 2013-05-03 23:48 ` Alvaro Herrera <alvherre@2ndquadrant.com>
0 siblings, 0 replies; 4+ messages in thread
From: Alvaro Herrera @ 2013-05-03 23:48 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: pgsql-docs
Bruce Momjian wrote:
> On Fri, May 3, 2013 at 07:36:09PM -0400, Alvaro Herrera wrote:
> > We do have other files that use underscores, anyway.
>
> Well, we have only four:
>
> generate_history.pl information_schema.sgml mk_feature_tables.pl
> pg_xlogdump.sgml
>
> Two are Perl scripts.
There are lots more in ref/ though.
> I agree the lack of an underscore makes it look ugly, but if we are
> going to improve it, I think we should all of them or none of them.
I think renaming the whole bunch of old files is out of the question. I
am not opposed to renaming the new file if you think it's worth it.
--
Álvaro Herrera http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2013-05-03 23:48 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2013-05-03 23:27 pg_xlogdump docs Bruce Momjian <bruce@momjian.us>
2013-05-03 23:36 ` Alvaro Herrera <alvherre@2ndquadrant.com>
2013-05-03 23:42 ` Bruce Momjian <bruce@momjian.us>
2013-05-03 23:48 ` Alvaro Herrera <alvherre@2ndquadrant.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