Module Name:    src
Committed By:   rillig
Date:           Tue Dec  6 00:12:44 UTC 2022

Modified Files:
        src/usr.bin/make: targ.c

Log Message:
make: clean up comments

No binary change.


To generate a diff of this commit:
cvs rdiff -u -r1.178 -r1.179 src/usr.bin/make/targ.c

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/usr.bin/make/targ.c
diff -u src/usr.bin/make/targ.c:1.178 src/usr.bin/make/targ.c:1.179
--- src/usr.bin/make/targ.c:1.178	Tue Sep 27 17:46:58 2022
+++ src/usr.bin/make/targ.c	Tue Dec  6 00:12:44 2022
@@ -1,4 +1,4 @@
-/*	$NetBSD: targ.c,v 1.178 2022/09/27 17:46:58 rillig Exp $	*/
+/*	$NetBSD: targ.c,v 1.179 2022/12/06 00:12:44 rillig Exp $	*/
 
 /*
  * Copyright (c) 1988, 1989, 1990, 1993
@@ -107,7 +107,7 @@
 #include "dir.h"
 
 /*	"@(#)targ.c	8.2 (Berkeley) 3/19/94"	*/
-MAKE_RCSID("$NetBSD: targ.c,v 1.178 2022/09/27 17:46:58 rillig Exp $");
+MAKE_RCSID("$NetBSD: targ.c,v 1.179 2022/12/06 00:12:44 rillig Exp $");
 
 /*
  * All target nodes that appeared on the left-hand side of one of the
@@ -159,17 +159,17 @@ Targ_List(void)
 /*
  * Create a new graph node, but don't register it anywhere.
  *
- * Graph nodes that appear on the left-hand side of a dependency line such
+ * Graph nodes that occur on the left-hand side of a dependency line such
  * as "target: source" are called targets.  XXX: In some cases (like the
- * .ALLTARGETS variable), all nodes are called targets as well, even if they
- * never appear on the left-hand side.  This is a mistake.
+ * .ALLTARGETS variable), other nodes are called targets as well, even if
+ * they never occur on the left-hand side of a dependency line.
  *
  * Typical names for graph nodes are:
- *	"src.c" (an ordinary file)
- *	"clean" (a .PHONY target)
- *	".END" (a special hook target)
- *	"-lm" (a library)
- *	"libc.a(isspace.o)" (an archive member)
+ *	"src.c"		an ordinary file
+ *	"clean"		a .PHONY target
+ *	".END"		a special hook target
+ *	"-lm"		a library
+ *	"libm.a(sin.o)"	an archive member
  */
 GNode *
 GNode_New(const char *name)
@@ -242,9 +242,9 @@ GNode_Free(void *gnp)
 	 *
 	 * XXX: The GNodes that are only used as variable scopes (SCOPE_CMD,
 	 * SCOPE_GLOBAL, SCOPE_INTERNAL) are not freed at all (see Var_End,
-	 * where they are not mentioned).  These might be freed at all, if
-	 * their variable values are indeed not used anywhere else (see
-	 * Trace_Init for the only suspicious use).
+	 * where they are not mentioned).  These may be freed if their
+	 * variable values are indeed not used anywhere else (see Trace_Init
+	 * for the only suspicious use).
 	 */
 	HashTable_Done(&gn->vars);
 

Reply via email to