[src/trunk]: src/usr.bin/make make: clean up comment for JobStart

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

details:   https://anonhg.NetBSD.org/src/rev/20edf496d48b
branches:  trunk
changeset: 983971:20edf496d48b
user:      rillig <rillig%NetBSD.org@localhost>
date:      Wed Jun 16 03:15:47 2021 +0000

description:
make: clean up comment for JobStart

The parameter 'flags' was renamed in job.c 1.354 from 2020-12-10 without
adjusting the documentation.

The parameter 'previous' was removed in job.c 1.108 from 2006-03-12,
also without adjusting the documentation of JobStart.

No functional change.

diffstat:

 usr.bin/make/job.c |  14 ++++----------
 1 files changed, 4 insertions(+), 10 deletions(-)

diffs (41 lines):

diff -r 39d869b1e7d9 -r 20edf496d48b usr.bin/make/job.c
--- a/usr.bin/make/job.c        Wed Jun 16 01:52:39 2021 +0000
+++ b/usr.bin/make/job.c        Wed Jun 16 03:15:47 2021 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: job.c,v 1.432 2021/04/27 16:25:46 rillig Exp $ */
+/*     $NetBSD: job.c,v 1.433 2021/06/16 03:15:47 rillig Exp $ */
 
 /*
  * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
@@ -142,7 +142,7 @@
 #include "trace.h"
 
 /*     "@(#)job.c      8.2 (Berkeley) 3/19/94" */
-MAKE_RCSID("$NetBSD: job.c,v 1.432 2021/04/27 16:25:46 rillig Exp $");
+MAKE_RCSID("$NetBSD: job.c,v 1.433 2021/06/16 03:15:47 rillig Exp $");
 
 /*
  * A shell defines how the commands are run.  All commands for a target are
@@ -1624,20 +1624,14 @@
 }
 
 /*
- * Start a target-creation process going for the target described by the
- * graph node gn.
- *
- * Input:
- *     gn              target to create
- *     flags           flags for the job to override normal ones.
- *     previous        The previous Job structure for this node, if any.
+ * Start a target-creation process going for the target described by gn.
  *
  * Results:
  *     JOB_ERROR if there was an error in the commands, JOB_FINISHED
  *     if there isn't actually anything left to do for the job and
  *     JOB_RUNNING if the job has been started.
  *
- * Side Effects:
+ * Details:
  *     A new Job node is created and added to the list of running
  *     jobs. PMake is forked and a child shell created.
  *