tools: don't abort on malformed documentation lines.

[ccan] / tools / doc_extract.c

diff --git a/tools/doc_extract.c b/tools/doc_extract.c
index 5a48b79f50d048c706a5145392450fecfc936c99..aa0c5a045c40d74ebd56feeac3b6e16a4df1261e 100644 (file)
--- a/tools/doc_extract.c
+++ b/tools/doc_extract.c
@@ -1,13 +1,30 @@
 /* This merely extracts, doesn't do XML or anything. */
-#include <err.h>
-#include <string.h>
-#include <stdio.h>
 #include <ccan/str/str.h>
 #include <ccan/str_talloc/str_talloc.h>
 #include <ccan/talloc/talloc.h>
 #include <ccan/grab_file/grab_file.h>
+#include <ccan/err/err.h>
+#include <string.h>
+#include <stdio.h>
 #include "doc_extract.h"
 
+/* We regard non-alphanumerics as equiv. */
+static bool typematch(const char *a, const char *b)
+{
+       size_t i;
+
+       for (i = 0; a[i]; i++) {
+               if (cisalnum(a[i])) {
+                       if (a[i] != b[i])
+                               return false;
+               } else {
+                       if (cisalnum(b[i]))
+                               return false;
+               }
+       }
+       return b[i] == '\0';
+}
+
 int main(int argc, char *argv[])
 {
        unsigned int i;
@@ -16,7 +33,7 @@ int main(int argc, char *argv[])
 
        if (argc < 3)
                errx(1, "Usage: doc_extract [--function=<funcname>] TYPE <file>...\n"
-                    "Where TYPE is functions|author|license|maintainer|summary|description|example|all");
+                    "Where TYPE is functions|author|license|maintainer|summary|description|example|see_also|all");
 
        if (strstarts(argv[1], "--function=")) {
                function = argv[1] + strlen("--function=");
@@ -35,7 +52,7 @@ int main(int argc, char *argv[])
                        err(1, "Reading file %s", argv[i]);
                lines = strsplit(file, file, "\n");
 
-               list = extract_doc_sections(lines);
+               list = extract_doc_sections(lines, argv[i]);
                if (list_empty(list))
                        errx(1, "No documentation in file %s", argv[i]);
                talloc_free(file);
@@ -60,7 +77,7 @@ int main(int argc, char *argv[])
                                }
                                if (streq(type, "all"))
                                        printf("%s:\n", d->type);
-                               else if (!streq(d->type, type))
+                               else if (!typematch(d->type, type))
                                        continue;
 
                                for (j = 0; j < d->num_lines; j++)