[commit] cleanup stale exec.{h|c} xfer_memory comments.

Eli Zaretskii eliz@gnu.org
Sat Jun 13 03:47:00 GMT 2009


> From: Pedro Alves <pedro@codesourcery.com>
> Date: Fri, 12 Jun 2009 19:43:07 +0100
> 
> The comment describing section_table_xfer_memory_partial is actually
> still describing the old xfer_memory.  This removes that stale
> description, and adjusts the description in the header a bit better
> to current reality.

Is the convention to describe functions in headers?  That's reasonable
for data structures, but we have a lot of functions documented right
before their source, not in the headers.  I find the documentation in
the .c files easier to use, because you don't need to consult another
file.  This is C, not C++, so the interface and the implementation are
not separated.



More information about the Gdb-patches mailing list