Date: Fri, 3 May 2013 19:42:09 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: pg_xlogdump docs
Message-ID: <20130503234209.GA5631@momjian.us>
References: <20130503232753.GA16289@momjian.us>
	<20130503233609.GL2467@eldon.alvh.no-ip.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20130503233609.GL2467@eldon.alvh.no-ip.org>
User-Agent: Mutt/1.5.20 (2009-06-14)
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

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