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: [ANNOUNCEMENT] GDB 8.1 released!


On 02/02/2018 03:40 PM, Joel Brobecker wrote:

> We could even split the languages section off from the last paragraph
> into its own section, vis:
> 
> | What is GDB?
> | ------------
> |
> | GDB, the GNU Project debugger, allows you to see what is going on
> | `inside' another program while it executes -- or what another program
> | was doing at the moment it crashed.
> |
> | GDB can do four main kinds of things (plus other things in support of
> | these) to help you catch bugs in the act:
> |
> |  * Start your program, specifying anything that might affect its behavior.
> |  * Make your program stop on specified conditions.
> |  * Examine what has happened, when your program has stopped.
> |  * Change things in your program, so you can experiment with correcting
> |    the effects of one bug and go on to learn about another.
> |
> | Those programs might be executing on the same machine as GDB (native)
> | or on another machine (remote).

Maybe add "or on a simulator".

> GDB can run on most popular UNIX and | Microsoft Windows variants.

Maybe add macOS here.

> |
> | What Languages does GDB Support?
> | --------------------------------
> |
> | GDB supports the following languages (in alphabetical order):
> |  * Ada
> |  * Assembly
> |  * C
> |  * C++
> |  * D
> |  * Fortran
> |  * Go
> |  * Objective-C
> |  * OpenCL
> |  * Modula-2
> |  * Pascal
> |  * Rust
> 

Sounds good to me.

Yeah.  I don't have a strong opinion there though I lean on listing
all as it avoids singling out anyone/any project and coming up with
some kind of metric to decide which ones are important.  Since it's
a graphically separated list with some markup, not some
paragraph-contributing-to-the-size-of-a-hard-to-read-wall-of-text, those
who don't care about the list can just quickly and easily move their
eyes past it in a split second.  I.e., I don't think 10 vs 20 entries
makes a difference in terms of readability.

> As explained above, I fear that having this exhuastive list might
> attract attention to regions of GDB that might have bitrotted a bit.
I think not listing active languages is worse than also listing
bitrotted languages, so I think on balance it's still better.

Thanks,
Pedro Alves


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