Re: pgAgent manpage

Dave Page wrote:
>
>
> On 26/12/05 22:36, "Raphaël Enrici" <blacknoz(at)club-internet(dot)fr> wrote:
>
>
>>Hi Dave, friends,
>>
>>santa claus just passed through my house and left this manpage near my
>>shoes... So, merry christmas!
>>
>>pgagent.xml is the docbook-xml source for this manpage and pgagent.1 was
>>compiled with the following command under Debian/Sarge:
>>docbook2x-man pgagent.xml
>>
>>I can convert the old pgadmin3.1 that I ship with Debian packages to
>>docbook-xml if needed. I'd prefer that we all ship these manpages for
>>next releases instead of releasing them specifically for Debian, what do
>>you think of adding them to the main install process?
>
>
> Hi Raph,
>
> I've got no problems with that at all. Can you prepare both XML files and a
> suitable makefile?

Ok, I'm preparing the files. Until I'm ready can you recheck the pgAgent
manpage I sent (in particular the synopsis) please.

> I guess we might also need a macro to make sure
> docbook-xml is actually installed - I can probably help with that if
> required, though it would probably be guesswork to a certain extent!

As far as I know a patched version of docbook2x-man is deistributed
directly with PostgreSQL, maybe it would be interesting to take a look
to how they are organizing the stuff?

> I've never seen a localised man page, though I guess they probably do exist
> - so so we use doc/man or doc/en_US/man?

I confirm they do exist :) On my system all C manpages are installed in
/usr/share/man/man[1|2|...] and localised ones are installed in
/usr/share/man/(fr_FR|es_ES|...)/man[1|2|...]

I would use doc/man and doc/man/fr_FR & so on. It should be investigated
though. One more time, let's take a look to how it's done for PostgreSQL.

Regards,
Raph