[src/trunk]: src/usr.bin/make make(1): clean up comments in job.c

[rillig <rillig%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0cffece3d579
branches:  trunk
changeset: 975842:0cffece3d579
user:      rillig <rillig%NetBSD.org@localhost>
date:      Mon Sep 07 05:32:12 2020 +0000

description:
make(1): clean up comments in job.c

diffstat:

 usr.bin/make/job.c |  39 ++++++++-------------------------------
 1 files changed, 8 insertions(+), 31 deletions(-)

diffs (81 lines):

diff -r f909d476a856 -r 0cffece3d579 usr.bin/make/job.c
--- a/usr.bin/make/job.c        Mon Sep 07 05:16:32 2020 +0000
+++ b/usr.bin/make/job.c        Mon Sep 07 05:32:12 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: job.c,v 1.227 2020/08/30 19:56:02 rillig Exp $ */
+/*     $NetBSD: job.c,v 1.228 2020/09/07 05:32:12 rillig Exp $ */
 
 /*
  * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
@@ -70,14 +70,14 @@
  */
 
 #ifndef MAKE_NATIVE
-static char rcsid[] = "$NetBSD: job.c,v 1.227 2020/08/30 19:56:02 rillig Exp $";
+static char rcsid[] = "$NetBSD: job.c,v 1.228 2020/09/07 05:32:12 rillig Exp $";
 #else
 #include <sys/cdefs.h>
 #ifndef lint
 #if 0
 static char sccsid[] = "@(#)job.c      8.2 (Berkeley) 3/19/94";
 #else
-__RCSID("$NetBSD: job.c,v 1.227 2020/08/30 19:56:02 rillig Exp $");
+__RCSID("$NetBSD: job.c,v 1.228 2020/09/07 05:32:12 rillig Exp $");
 #endif
 #endif /* not lint */
 #endif
@@ -1255,7 +1255,7 @@
            bmake_free(p1);
        } else if (Dir_MTime(gn, 0) == 0 && (gn->type & OP_SPECIAL) == 0) {
            /*
-            * The node wasn't the target of an operator we have no .DEFAULT
+            * The node wasn't the target of an operator.  We have no .DEFAULT
             * rule to go on and the target doesn't already exist. There's
             * nothing more we can do for this branch. If the -k flag wasn't
             * given, we stop in our tracks, otherwise we just don't update
@@ -1289,22 +1289,10 @@
     return TRUE;
 }
 
-/*-
- *-----------------------------------------------------------------------
- * JobExec --
- *     Execute the shell for the given job. Called from JobStart
- *
- * Input:
- *     job             Job to execute
+/* Execute the shell for the given job. Called from JobStart
  *
- * Results:
- *     None.
- *
- * Side Effects:
- *     A shell is executed, outputs is altered and the Job structure added
- *     to the job table.
- *
- *-----------------------------------------------------------------------
+ * A shell is executed, its output is altered and the Job structure added
+ * to the job table.
  */
 static void
 JobExec(Job *job, char **argv)
@@ -1476,18 +1464,7 @@
     JobSigUnlock(&mask);
 }
 
-/*-
- *-----------------------------------------------------------------------
- * JobMakeArgv --
- *     Create the argv needed to execute the shell for a given job.
- *
- *
- * Results:
- *
- * Side Effects:
- *
- *-----------------------------------------------------------------------
- */
+/* Create the argv needed to execute the shell for a given job. */
 static void
 JobMakeArgv(Job *job, char **argv)
 {