Re: [patch+doc] New gdbinit.5 man page

Jan Kratochvil
2013-02-19T16:28:02Z

On Wed, 13 Feb 2013 18:42:25 +0100, Eli Zaretskii wrote:
> I just don't see how it will make maintenance simpler. But I'm
> prepared to be convinced ;-)

On Tue, 12 Feb 2013 17:11:18 +0100, Eli Zaretskii wrote:
> Why is this better than maintaining man pages in their roff format?

One reason is that mostly any other format is more convenient to write and
maintain than roff. So that means to write man pages either in pod or in
texinfo (or maybe in some other format but not roff).

At least the content of man page for gdb/gdb_gcore.sh (/usr/bin/gcore) should
be available also in texinfo as gcore's script description is currently not
present in the GDB manual.

Having gdb/gdb_gcore.sh man page in texinfo and other (like /usr/bin/gdb) man
pages in other format seems more complicated to me than having all the man
pages in single format (which is texinfo in this case).

Another reason is that GDB contributors already have to know texinfo for the
GDB manual updates so it means a more difficult learning curve to require
another documentation format (such as pod) knowledge from contributors.

Is there some reason why not to have all the GDB man pages in texinfo?

Thanks,
Jan