changeset 23937:800ee793bd5a

build: warn on undocumented symbols when building doc-cache * mk-doc-cache.pl: Warn on undocumented symbols, avoid perl warning on use of undefined variable.
author Mike Miller <mtmiller@octave.org>
date Thu, 24 Aug 2017 10:53:58 -0700
parents 2ae8efbafb58
children e54e13ee99ce
files doc/interpreter/mk-doc-cache.pl
diffstat 1 files changed, 6 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/doc/interpreter/mk-doc-cache.pl	Wed Aug 23 16:33:21 2017 -0700
+++ b/doc/interpreter/mk-doc-cache.pl	Thu Aug 24 10:53:58 2017 -0700
@@ -128,6 +128,12 @@
 
       next if (length ($symbol) > 2 && $symbol =~ m/$private_name_pat/);
 
+      if (! defined ($doc))
+      {
+        warn "mk-doc-cache.pl: function '$symbol' may be undocumented";
+        next;
+      }
+
       $doc =~ s/^[\r\n]+//;
       next if (! $doc);