[src/trunk]: src/usr.bin/xlint/lint1 lint: clean up comments in mem1.c

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

details:   https://anonhg.NetBSD.org/src/rev/3ce06e8b5164
branches:  trunk
changeset: 1018924:3ce06e8b5164
user:      rillig <rillig%NetBSD.org@localhost>
date:      Sun Feb 21 13:27:22 2021 +0000

description:
lint: clean up comments in mem1.c

The comment for tgetblk had been misplaced.

diffstat:

 usr.bin/xlint/lint1/mem1.c |  40 +++++++++++++---------------------------
 1 files changed, 13 insertions(+), 27 deletions(-)

diffs (120 lines):

diff -r 252d1375194f -r 3ce06e8b5164 usr.bin/xlint/lint1/mem1.c
--- a/usr.bin/xlint/lint1/mem1.c        Sun Feb 21 13:13:14 2021 +0000
+++ b/usr.bin/xlint/lint1/mem1.c        Sun Feb 21 13:27:22 2021 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: mem1.c,v 1.25 2021/01/23 22:20:17 rillig Exp $ */
+/*     $NetBSD: mem1.c,v 1.26 2021/02/21 13:27:22 rillig Exp $ */
 
 /*
  * Copyright (c) 1994, 1995 Jochen Pohl
@@ -37,7 +37,7 @@
 
 #include <sys/cdefs.h>
 #if defined(__RCSID) && !defined(lint)
-__RCSID("$NetBSD: mem1.c,v 1.25 2021/01/23 22:20:17 rillig Exp $");
+__RCSID("$NetBSD: mem1.c,v 1.26 2021/02/21 13:27:22 rillig Exp $");
 #endif
 
 #include <sys/types.h>
@@ -62,9 +62,7 @@
 
 static fn_t    *srchfn(const char *, size_t);
 
-/*
- * Look for a Filename of length l.
- */
+/* Find the given filename, or return NULL. */
 static fn_t *
 srchfn(const char *s, size_t len)
 {
@@ -77,9 +75,7 @@
        return fn;
 }
 
-/*
- * Return a shared string for filename s.
- */
+/* Return a copy of the filename s with unlimited lifetime. */
 const char *
 fnalloc(const char *s)
 {
@@ -140,7 +136,7 @@
 
        if ((fn = srchfn(s, len)) == NULL) {
                fn = xmalloc(sizeof (fn_t));
-               /* Do not use strdup() because string is not NUL-terminated.*/
+               /* Do not use strdup() because s is not NUL-terminated.*/
                fn->fn_name = xmalloc(len + 1);
                (void)memcpy(fn->fn_name, s, len);
                fn->fn_name[len] = '\0';
@@ -157,9 +153,7 @@
        return fn->fn_name;
 }
 
-/*
- * Get id of a filename.
- */
+/* Get the ID of a filename. */
 int
 getfnid(const char *s)
 {
@@ -295,9 +289,7 @@
 }
 
 
-/*
- * Allocate memory associated with level l.
- */
+/* Allocate memory associated with level l. */
 void *
 getlblk(size_t l, size_t s)
 {
@@ -317,9 +309,7 @@
        return getlblk(mblklev, s);
 }
 
-/*
- * Free all memory associated with level l.
- */
+/* Free all memory associated with level l. */
 void
 freelblk(int l)
 {
@@ -334,12 +324,12 @@
        freelblk(mblklev);
 }
 
+static mbl_t   *tmblk;
+
 /*
- * tgetblk() returns memory which is associated with the current
+ * Return zero-initialized memory that is freed at the end of the current
  * expression.
  */
-static mbl_t   *tmblk;
-
 void *
 tgetblk(size_t s)
 {
@@ -347,9 +337,7 @@
        return xgetblk(&tmblk, s);
 }
 
-/*
- * Return a freshly allocated tree node.
- */
+/* Return a freshly allocated tree node. */
 tnode_t *
 getnode(void)
 {
@@ -358,9 +346,7 @@
        return tn;
 }
 
-/*
- * Free all memory which is allocated by the current expression.
- */
+/* Free all memory which is allocated by the current expression. */
 void
 tfreeblk(void)
 {