From 3aa6856ae81484ff7db975f724f212191f0e23e1 Mon Sep 17 00:00:00 2001
From: John Gilmore <gnu@cygnus>
Date: Sat, 26 Sep 1992 01:49:18 +0000
Subject: [PATCH] * infrun.c, inftarg.c, inferior.h:  Comment and lint
 cleanups.

---
 gdb/ChangeLog  |  4 ++++
 gdb/inferior.h |  2 ++
 gdb/infrun.c   |  6 +-----
 gdb/inftarg.c  | 26 +++++++++++++-------------
 4 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index d21de67bfed..2ce5bd36a3c 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,7 @@
+Fri Sep 25 18:48:20 1992  John Gilmore  (gnu@cygnus.com)
+
+	* infrun.c, inftarg.c, inferior.h:  Comment and lint cleanups.
+
 Fri Sep 25 15:13:44 1992  Stu Grossman  (grossman at cygnus.com)
 
 	* tm-sparc.h, dbxread.c (read_ofile_symtab):  Install Jim Wilson's
diff --git a/gdb/inferior.h b/gdb/inferior.h
index b6c07244716..c893f349a75 100644
--- a/gdb/inferior.h
+++ b/gdb/inferior.h
@@ -122,6 +122,8 @@ close_exec_file PARAMS ((void));
 extern void
 reopen_exec_file PARAMS ((void));
 
+/* The `resume' routine should only be called in special circumstances.
+   Normally, use `proceed', which handles a lot of bookkeeping.  */
 extern void
 resume PARAMS ((int, int));
 
diff --git a/gdb/infrun.c b/gdb/infrun.c
index f2562f6ce29..8a01acf0314 100644
--- a/gdb/infrun.c
+++ b/gdb/infrun.c
@@ -1,6 +1,4 @@
-/* Target independent code for starting (run) and stoping an inferior
-   process.
-
+/* Target-struct-independent code to start (run) and stop an inferior process.
    Copyright 1986, 1987, 1988, 1989, 1991, 1992 Free Software Foundation, Inc.
 
 This file is part of GDB.
@@ -146,8 +144,6 @@ insert_step_breakpoint PARAMS ((void));
 static void
 resume_cleanups PARAMS ((int));
 
-extern struct target_ops child_ops;	/* In inftarg.c */
-
 /* Sigtramp is a routine that the kernel calls (which then calls the
    signal handler).  On most machines it is a library routine that
    is linked into the executable.
diff --git a/gdb/inftarg.c b/gdb/inftarg.c
index d40d55a7b00..5717408f65a 100644
--- a/gdb/inftarg.c
+++ b/gdb/inftarg.c
@@ -1,5 +1,4 @@
-/* This file inplements the host independent child process statum.
-
+/* Target-vector operations for controlling Unix child processes, for GDB.
    Copyright 1990, 1991, 1992 Free Software Foundation, Inc.
    Contributed by Cygnus Support.
 
@@ -61,6 +60,9 @@ child_create_inferior PARAMS ((char *, char *, char **));
 static void
 child_mourn_inferior PARAMS ((void));
 
+static int
+child_can_run PARAMS ((void));
+
 extern char **environ;
 
 /* Forward declaration */
@@ -154,16 +156,14 @@ child_attach (args, from_tty)
 #endif  /* ATTACH_DETACH */
 }
 
-/*
- * child_detach()
- * takes a program previously attached to and detaches it.
- * The program resumes execution and will no longer stop
- * on signals, etc.  We better not have left any breakpoints
- * in the program or it'll die when it hits one.  For this
- * to work, it may be necessary for the process to have been
- * previously attached.  It *might* work if the program was
- * started via the normal ptrace (PTRACE_TRACEME).
- */
+
+/* Take a program previously attached to and detaches it.
+   The program resumes execution and will no longer stop
+   on signals, etc.  We'd better not have left any breakpoints
+   in the program or it'll die when it hits one.  For this
+   to work, it may be necessary for the process to have been
+   previously attached.  It *might* work if the program was
+   started via the normal ptrace (PTRACE_TRACEME).  */
 
 static void
 child_detach (args, from_tty)
@@ -459,7 +459,7 @@ child_can_run ()
 {
   return(1);
 }
-
+
 struct target_ops child_ops = {
   "child",			/* to_shortname */
   "Unix child process",		/* to_longname */
-- 
2.30.2