I was just searching through the tracker and seeing how many bug reports we had in various categories...

@Andrew: I'll let you know when I'm a bit further. Shouldn't be more than just one or a few weeks.

Status -> Postponed

I'll wait until you have your refactoring done, and then submit patches. Sounds like it would be a lot to keep track of if we do it all now.

Is it the "doctest" package you're referring to about helptext as test cases? https://octave.sourceforge.io/doctest/index.html

In the io package, in the function helptext, examples are formatted like this:

     Examples:

            A = xls2oct (xls1, '2nd_sheet', 'C3:AB40');
            (which returns the numeric contents in range C3:AB40 in worksheet
            '2nd_sheet' from a spreadsheet file pointed to in pointer struct xls1,
            into numeric array A)

            [An, xls2, status] = xls2oct (xls2, 'Third_sheet');

Plain prose is mixed in with code. What do you think about reformatting them as comments inside the examples? Like this:

     Examples:

            # returns the numeric contents in range C3:AB40 in worksheet
            # '2nd_sheet' from a spreadsheet file pointed to in pointer struct xls1,
            # into numeric array A
            A = xls2oct (xls1, '2nd_sheet', 'C3:AB40');

            [An, xls2, status] = xls2oct (xls2, 'Third_sheet');

Might help with readability, and then you can highlight multiple lines worth of example code and "Run selection", and it'll wok.