binutils-gdb/gdb/common
Pedro Alves 9a2c3737b0 Clean up ptid.h/ptid.c.
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.
2013-10-04 10:04:14 +00:00
..
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 * common/filestuff.c (gdb_fopen_cloexec): Do not try to use "e" 2013-09-14 06:26:35 +00:00
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 gdb: btrace: fix build errors on older glibc builds 2013-09-29 03:57:34 +00:00
linux-btrace.h
linux-osdata.c
linux-osdata.h
linux-procfs.c
linux-procfs.h
linux-ptrace.c Always run the PTRACE_O_TRACESYSGOOD tests even if PTRACE_O_TRACEFORK is not supported. 2013-10-03 10:13:34 +00:00
linux-ptrace.h
mips-linux-watch.c
mips-linux-watch.h
ptid.c Clean up ptid.h/ptid.c. 2013-10-04 10:04:14 +00:00
ptid.h Clean up ptid.h/ptid.c. 2013-10-04 10:04:14 +00:00
queue.h
signals.c
vec.c
vec.h
version.h
xml-utils.c
xml-utils.h