mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-01-06 12:09:26 +08:00
9a2c3737b0
The ptid_t contructors, accessors and predicates are documented in _three_ places, and each place uses a different wording. E.g, the descriptions in the .c file of the new ptid_lwp_p, ptid_tid_p weren't updated in the final revision like the descriptions in the .h file were. Clearly, switching to a style that has a single central description avoids such issues. Worse, some of the existing descriptions are plain wrong, such as: /* Attempt to find and return an existing ptid with the given PID, LWP, and TID components. If none exists, create a new one and return that. */ ptid_t ptid_build (int pid, long lwp, long tid); The function does nothing that complicated. It's just a simple constructor. So this gets rid of all the unnecessary descriptions, leaving only the ones near the function declarations in the header file, and fixes/clarifies those that remain. gdb/ 2013-10-04 Pedro Alves <palves@redhat.com> * common/ptid.c (null_ptid, minus_one_ptid, ptid_build) (pid_to_ptid, ptid_get_pid, ptid_get_lwp, ptid_get_tid) (ptid_equal, ptid_is_pid, ptid_lwp_p, ptid_tid_p): Replace describing comments with references to ptid.h. * common/ptid.h: Remove intro description of constructors, accessors and predicates. (struct ptid): Reformat. (minus_one_ptid, ptid_build, pid_to_ptid, ptid_get_pid) (ptid_get_lwp, ptid_get_tid, ptid_equal, ptid_is_pid): Change describing comments. |
||
---|---|---|
.. | ||
agent.c | ||
agent.h | ||
ax.def | ||
break-common.h | ||
btrace-common.h | ||
buffer.c | ||
buffer.h | ||
common-utils.c | ||
common-utils.h | ||
create-version.sh | ||
filestuff.c | ||
filestuff.h | ||
format.c | ||
format.h | ||
gdb_assert.h | ||
gdb_dirent.h | ||
gdb_locale.h | ||
gdb_signals.h | ||
gdb_stat.h | ||
gdb_string.h | ||
gdb_thread_db.h | ||
gdb_vecs.c | ||
gdb_vecs.h | ||
gdb_wait.h | ||
glibc_thread_db.h | ||
host-defs.h | ||
i386-cpuid.h | ||
i386-gcc-cpuid.h | ||
i386-xstate.h | ||
linux-btrace.c | ||
linux-btrace.h | ||
linux-osdata.c | ||
linux-osdata.h | ||
linux-procfs.c | ||
linux-procfs.h | ||
linux-ptrace.c | ||
linux-ptrace.h | ||
mips-linux-watch.c | ||
mips-linux-watch.h | ||
ptid.c | ||
ptid.h | ||
queue.h | ||
signals.c | ||
vec.c | ||
vec.h | ||
version.h | ||
xml-utils.c | ||
xml-utils.h |