search

apjanke / octave-tablicious

Table (relational, tabular data) implementation for GNU Octave
https://apjanke.github.io/octave-tablicious/
GNU General Public License v3.0
29 stars 11 forks source link

"unusable helptext" warnings in package installation #85

Closed apjanke closed 8 months ago

apjanke commented 3 years ago

Like this:

>> pkg install https://github.com/apjanke/octave-tablicious/releases/download/v0.3.6/tablicious-0.3.6.tar.gz
warning: doc_cache_create: unusable help text found in file 'categorical'
warning: called from
    doc_cache_create>handle_function at line 98 column 5
    doc_cache_create>create_cache at line 118 column 36
    gen_doc_cache_in_dir>@<anonymous> at line 150 column 16
    doc_cache_create>gen_doc_cache_in_dir at line 151 column 9
    doc_cache_create at line 62 column 12
    install>generate_lookfor_cache at line 823 column 5
    install at line 235 column 7
    pkg at line 568 column 9

warning: doc_cache_create: unusable help text found in file 'datetime'
warning: called from
    doc_cache_create>handle_function at line 98 column 5
    doc_cache_create>create_cache at line 118 column 36
    gen_doc_cache_in_dir>@<anonymous> at line 150 column 16
    doc_cache_create>gen_doc_cache_in_dir at line 151 column 9
    doc_cache_create at line 62 column 12
    install>generate_lookfor_cache at line 823 column 5
    install at line 235 column 7
    pkg at line 568 column 9

In Octave 6.2.0; dunno about earlier versions.

apjanke commented 3 years ago

Possible dupe of #46?

lostbard commented 9 months ago

The issue here I think is that the help texinfo is outside of the classdef - move it to after the classdef XXXX lines and it works for me.

apjanke commented 8 months ago

Hey, I think that worked! Did that in https://github.com/apjanke/octave-tablicious/commit/4370895258ed230781bef8639971145c2ea26275, and the "unusable helptext' warnings for classes all went away.

Merged to main. Closing as Fixed. Will go out in release 0.4.0 soon, hopefully.