Re: [patch] Share options between info and man page

Eli Zaretskii
2014-06-10T02:52:56Z

> From: Mingjie Xing <mingjie.xing@gmail.com>
> Date: Tue, 10 Jun 2014 08:46:10 +0800
> Cc: gdb-patches@sourceware.org
>
> 2014-06-09 22:52 GMT+08:00 Eli Zaretskii <eliz@gnu.org>:
> > The text of these two portions is different, so you are actually
> > changing the man page contents. Also, the @node and @section lines
> > are probably inappropriate for a man page.
>
> Yes, but you can see that the man page contents are almost same with
> those sections.

Then please also suggest changes to make them exactly the same. I'm
OK with making the maintenance burden easier, but I don't want to lose
content.

> For an example, gcc's man page and info page use the
> same file 'invoke.texi' which includes @node and @section lines.

I'm sorry, but GCC's example is unlikely to convince me, because I
consider the GCC documentation to be one of the worst examples in the
GNU project. I can never find useful up to date information there
when I'm looking for it.

It should be easy to keep the @node and @chapter out of the man page.

Thanks.