This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH 2/3] deprecate "skip enable/etc.", doc string cleanup
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Doug Evans <dje at google dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Mon, 18 Apr 2016 22:53:05 +0300
- Subject: Re: [PATCH 2/3] deprecate "skip enable/etc.", doc string cleanup
- Authentication-results: sourceware.org; auth=none
- References: <047d7bdc05e2ada5ef0530c446d1 at google dot com> <83zisq923i dot fsf at gnu dot org> <CADPb22RDOModEuNmrJOwAfPN7ig6nTOQy=ajcxBbb4M31kM74w at mail dot gmail dot com>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> From: Doug Evans <dje@google.com>
> Date: Mon, 18 Apr 2016 12:42:04 -0700
> Cc: gdb-patches <gdb-patches@sourceware.org>
>
> I certainly don't want to replicate all that text again
> and again (hence the macros).
I understand, but put yourself in the position of someone who needs to
review a patch, and sees something like this:
+Display the status of skips.\n"
+EDDI_USAGE_DOC_STRING_WITH_ALL ("skip", "info skip", "displayed")));
How does that someone know if the resulting text is good English and
will produce a clear help text, or needs to be fixed in some way?