This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [patch] Share options between info and man page
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Mingjie Xing <mingjie dot xing at gmail dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Tue, 10 Jun 2014 05:52:47 +0300
- Subject: Re: [patch] Share options between info and man page
- Authentication-results: sourceware.org; auth=none
- References: <CADNgcEyi=PBbjzgK3MA=FM8QjWXz_jv-KuXYe5b4-pu+LUY6xA at mail dot gmail dot com> <831tuy2kzi dot fsf at gnu dot org> <CADNgcExfk1A=EWKGDD4dPD0E0+H5=_a+ssV1qV4-xzXO3OSDyg at mail dot gmail dot com>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> 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.