This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH] Doxygenate gdbtypes.h
- From: Mark Kettenis <mark dot kettenis at xs4all dot nl>
- To: stanshebs at earthlink dot net
- Cc: gdb-patches at sourceware dot org
- Date: Tue, 4 Mar 2014 01:39:37 +0100 (CET)
- Subject: Re: [PATCH] Doxygenate gdbtypes.h
- Authentication-results: sourceware.org; auth=none
- References: <53151B5D dot 5000309 at earthlink dot net>
> Date: Mon, 03 Mar 2014 16:16:29 -0800
> From: Stan Shebs <stanshebs@earthlink.net>
>
> Since minsyms.h and utils.h are churning a bit, I turned my attention to
> gdbtypes.h. As with defs.h, I've done only minimal content change,
> although the patch looks large because of many unavoidable paragraph
> refills.
>
> I added an additional block comment at the top that is a bit of general
> discussion, similar to content that was in gdbint.texinfo. Doxygen
> starts to win for us here, as not only does it create a separate page
> for this block, but mentions of symbols become links to definitions and
> detailed documentation.
>
> I'll push this in a few days.
I wish you didn't. This really adds a lot of random garbage all
through the comments we carefully wrote over the last 20 years.
It's an act of vandalism.