[src/trunk]: src/usr.bin/make make(1): fix punctuation and add paragraphs in ...

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

details:   https://anonhg.NetBSD.org/src/rev/5edec866c43a
branches:  trunk
changeset: 976592:5edec866c43a
user:      rillig <rillig%NetBSD.org@localhost>
date:      Sun Sep 27 17:17:01 2020 +0000

description:
make(1): fix punctuation and add paragraphs in config.h comments

diffstat:

 usr.bin/make/config.h |  21 +++++++++++++--------
 1 files changed, 13 insertions(+), 8 deletions(-)

diffs (55 lines):

diff -r 0c085970ad59 -r 5edec866c43a usr.bin/make/config.h
--- a/usr.bin/make/config.h     Sun Sep 27 16:59:02 2020 +0000
+++ b/usr.bin/make/config.h     Sun Sep 27 17:17:01 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: config.h,v 1.22 2020/09/01 17:40:34 rillig Exp $       */
+/*     $NetBSD: config.h,v 1.23 2020/09/27 17:17:01 rillig Exp $       */
 
 /*
  * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
@@ -76,10 +76,11 @@
  * DEFMAXJOBS
  * DEFMAXLOCAL
  *     These control the default concurrency. On no occasion will more
- *     than DEFMAXJOBS targets be created at once (locally or remotely)
+ *     than DEFMAXJOBS targets be created at once (locally or remotely).
+ *
  *     DEFMAXLOCAL is the highest number of targets which will be
  *     created on the local machine at once. Note that if you set this
- *     to 0, nothing will ever happen...
+ *     to 0, nothing will ever happen.
  */
 #define DEFMAXJOBS     4
 #define DEFMAXLOCAL    1
@@ -88,10 +89,12 @@
  * INCLUDES
  * LIBRARIES
  *     These control the handling of the .INCLUDES and .LIBS variables.
+ *
  *     If INCLUDES is defined, the .INCLUDES variable will be filled
  *     from the search paths of those suffixes which are marked by
- *     .INCLUDES dependency lines. Similarly for LIBRARIES and .LIBS
- *     See suff.c for more details.
+ *     .INCLUDES dependency lines. Similarly for LIBRARIES and .LIBS.
+ *
+ *     See varname-dot-include.mk and varname-dot-libs.mk for more details.
  */
 #define INCLUDES
 #define LIBRARIES
@@ -108,11 +111,13 @@
  *     If defined, Make_Update will check a target for its current
  *     modification time after it has been re-made, setting it to the
  *     starting time of the make only if the target still doesn't exist.
+ *
  *     Unfortunately, under NFS the modification time often doesn't
  *     get updated in time, so a target will appear to not have been
- *     re-made, causing later targets to appear up-to-date. On systems
- *     that don't have this problem, you should define this. Under
- *     NFS you probably should not, unless you aren't exporting jobs.
+ *     re-made, causing later targets to appear up-to-date.
+ *
+ *     On systems that don't have this problem, you should define this.
+ *     Under NFS you probably should not, unless you aren't exporting jobs.
  */
 #define        RECHECK