Re: pg_xlogdump 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. +