pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Bruce Momjian <bruce@momjian.us>
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: pg_xlogdump docs
Date: Fri, 3 May 2013 19:42:09 -0400
Message-ID: <20130503234209.GA5631@momjian.us> (raw)
In-Reply-To: <20130503233609.GL2467@eldon.alvh.no-ip.org>
References: <20130503232753.GA16289@momjian.us>
	<20130503233609.GL2467@eldon.alvh.no-ip.org>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-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



view thread (4+ messages)  latest in thread

Message-ID: <20130503234209.GA5631@momjian.us>
Permalink:  ../20130503234209.GA5631@momjian.us/
Also on:    postgresql.org/message-id/20130503234209.GA5631@momjian.us

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: bruce@momjian.us, alvherre@2ndquadrant.com
  Subject: Re: pg_xlogdump docs
  In-Reply-To: <20130503234209.GA5631@momjian.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

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