[src/trunk]: src/usr.bin/make make(1): clean up documentation of DirExpandCur...

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

details:   https://anonhg.NetBSD.org/src/rev/02f580b17e0c
branches:  trunk
changeset: 1015510:02f580b17e0c
user:      rillig <rillig%NetBSD.org@localhost>
date:      Sun Oct 25 08:10:03 2020 +0000

description:
make(1): clean up documentation of DirExpandCurly and Dir_Expand

diffstat:

 usr.bin/make/dir.c |  41 +++++++++--------------------------------
 1 files changed, 9 insertions(+), 32 deletions(-)

diffs (79 lines):

diff -r d79326af62f7 -r 02f580b17e0c usr.bin/make/dir.c
--- a/usr.bin/make/dir.c        Sun Oct 25 07:59:09 2020 +0000
+++ b/usr.bin/make/dir.c        Sun Oct 25 08:10:03 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: dir.c,v 1.179 2020/10/25 07:59:09 rillig Exp $ */
+/*     $NetBSD: dir.c,v 1.180 2020/10/25 08:10:03 rillig Exp $ */
 
 /*
  * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
@@ -135,7 +135,7 @@
 #include "job.h"
 
 /*     "@(#)dir.c      8.2 (Berkeley) 1/2/94"  */
-MAKE_RCSID("$NetBSD: dir.c,v 1.179 2020/10/25 07:59:09 rillig Exp $");
+MAKE_RCSID("$NetBSD: dir.c,v 1.180 2020/10/25 08:10:03 rillig Exp $");
 
 #define DIR_DEBUG0(text) DEBUG0(DIR, text)
 #define DIR_DEBUG1(fmt, arg1) DEBUG1(DIR, fmt, arg1)
@@ -686,27 +686,16 @@
     return s;
 }
 
-/*-
- *-----------------------------------------------------------------------
- * DirExpandCurly --
- *     Expand curly braces like the C shell. Does this recursively.
- *     Note the special case: if after the piece of the curly brace is
- *     done there are no wildcard characters in the result, the result is
- *     placed on the list WITHOUT CHECKING FOR ITS EXISTENCE.
+/* Expand curly braces like the C shell. Does this recursively.
+ * Note the special case: if after the piece of the curly brace is
+ * done, there are no wildcard characters in the result, the result is
+ * placed on the list WITHOUT CHECKING FOR ITS EXISTENCE.
  *
  * Input:
  *     word            Entire word to expand
  *     brace           First curly brace in it
  *     path            Search path to use
  *     expansions      Place to store the expansions
- *
- * Results:
- *     None.
- *
- * Side Effects:
- *     The given list is filled with the expansions...
- *
- *-----------------------------------------------------------------------
  */
 static void
 DirExpandCurly(const char *word, const char *brace, SearchPath *path,
@@ -792,25 +781,13 @@
     debug_printf("\n");
 }
 
-/*-
- *-----------------------------------------------------------------------
- * Dir_Expand  --
- *     Expand the given word into a list of words by globbing it looking
- *     in the directories on the given search path.
+/* Expand the given word into a list of words by globbing it, looking in the
+ * directories on the given search path.
  *
  * Input:
  *     word            the word to expand
- *     path            the list of directories in which to find the
- *                     resulting files
+ *     path            the directories in which to find the files
  *     expansions      the list on which to place the results
- *
- * Results:
- *     A list of words consisting of the files which exist along the search
- *     path matching the given pattern.
- *
- * Side Effects:
- *     Directories may be opened. Who knows?
- *-----------------------------------------------------------------------
  */
 void
 Dir_Expand(const char *word, SearchPath *path, StringList *expansions)