Mercurial > octave
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);