[src/trunk]: src/usr.bin/make make: clean up comments

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

details:   https://anonhg.NetBSD.org/src/rev/f9f392ae2566
branches:  trunk
changeset: 959129:f9f392ae2566
user:      rillig <rillig%NetBSD.org@localhost>
date:      Mon Feb 01 19:39:31 2021 +0000

description:
make: clean up comments

diffstat:

 usr.bin/make/lst.c  |   6 +++---
 usr.bin/make/main.c |  25 ++++++++++++-------------
 2 files changed, 15 insertions(+), 16 deletions(-)

diffs (84 lines):

diff -r ea565235ce44 -r f9f392ae2566 usr.bin/make/lst.c
--- a/usr.bin/make/lst.c        Mon Feb 01 19:31:34 2021 +0000
+++ b/usr.bin/make/lst.c        Mon Feb 01 19:39:31 2021 +0000
@@ -1,4 +1,4 @@
-/* $NetBSD: lst.c,v 1.103 2021/02/01 18:55:15 rillig Exp $ */
+/* $NetBSD: lst.c,v 1.104 2021/02/01 19:39:31 rillig Exp $ */
 
 /*
  * Copyright (c) 1988, 1989, 1990, 1993
@@ -34,7 +34,7 @@
 
 #include "make.h"
 
-MAKE_RCSID("$NetBSD: lst.c,v 1.103 2021/02/01 18:55:15 rillig Exp $");
+MAKE_RCSID("$NetBSD: lst.c,v 1.104 2021/02/01 19:39:31 rillig Exp $");
 
 static ListNode *
 LstNodeNew(ListNode *prev, ListNode *next, void *datum)
@@ -276,7 +276,7 @@
 }
 
 /*
- * Return the pointer to the last item in the vector.
+ * Remove the last item from the vector, return the pointer to it.
  * The returned data is valid until the next modifying operation.
  */
 void *
diff -r ea565235ce44 -r f9f392ae2566 usr.bin/make/main.c
--- a/usr.bin/make/main.c       Mon Feb 01 19:31:34 2021 +0000
+++ b/usr.bin/make/main.c       Mon Feb 01 19:39:31 2021 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: main.c,v 1.520 2021/01/30 21:25:10 rillig Exp $        */
+/*     $NetBSD: main.c,v 1.521 2021/02/01 19:39:31 rillig Exp $        */
 
 /*
  * Copyright (c) 1988, 1989, 1990, 1993
@@ -73,18 +73,19 @@
  *
  * Utility functions defined in this file:
  *
- *     Main_ParseArgLine       Parse and process command line arguments from
- *                             a single string.  Used to implement the
- *                             special targets .MFLAGS and .MAKEFLAGS.
+ *     Main_ParseArgLine
+ *                     Parse and process command line arguments from a
+ *                     single string.  Used to implement the special targets
+ *                     .MFLAGS and .MAKEFLAGS.
  *
- *     Error                   Print a tagged error message.
+ *     Error           Print a tagged error message.
  *
- *     Fatal                   Print an error message and exit.
+ *     Fatal           Print an error message and exit.
  *
- *     Punt                    Abort all jobs and exit with a message.
+ *     Punt            Abort all jobs and exit with a message.
  *
- *     Finish                  Finish things up by printing the number of
- *                             errors which occurred, and exit.
+ *     Finish          Finish things up by printing the number of errors
+ *                     that occurred, and exit.
  */
 
 #include <sys/types.h>
@@ -110,7 +111,7 @@
 #include "trace.h"
 
 /*     "@(#)main.c     8.3 (Berkeley) 3/19/94" */
-MAKE_RCSID("$NetBSD: main.c,v 1.520 2021/01/30 21:25:10 rillig Exp $");
+MAKE_RCSID("$NetBSD: main.c,v 1.521 2021/02/01 19:39:31 rillig Exp $");
 #if defined(MAKE_NATIVE) && !defined(lint)
 __COPYRIGHT("@(#) Copyright (c) 1988, 1989, 1990, 1993 "
            "The Regents of the University of California.  "
@@ -344,9 +345,7 @@
        }
 }
 
-/*
- * does path contain any relative components
- */
+/* Is path relative, or does it contain any relative component "." or ".."? */
 static Boolean
 is_relpath(const char *path)
 {