This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]