maxima-discuss

[Maxima-discuss] Documentation fails with error

[Raymond T. <toy...@gm...>]

Don't know when this started happening, but I can't get the
documentation for minpack_lsquares.  In both cmucl and ccl when I try

? minpack_lsquares

I get an error.  In both cases it looks like maxima is trying to get
the file-position from a directory.  That doesn't work so well since
you can't read directories directly anymore on most systems.

Other documentation works, but minpack_lsquares doesn't.  ??
minpack does, however produce a nice list of matches.  I just can't
read any of the choices.

--
Ray

Re: [Maxima-discuss] Documentation fails with error

[Robert D. <rob...@gm...>]

On 2015-08-29, Raymond Toy <toy...@gm...> wrote:

> Don't know when this started happening, but I can't get the
> documentation for minpack_lsquares.

Looks like the items in maxima-index.lisp for minpack_lsquares and
minpack_solve are incomplete -- the file name and offset are default
values. The file name and offset are present for the section headings
(Introduction to minpack and Functions and variables for minpack) are
present and I find those do work with ?.

minpack_lsquares and minpack_solve are the only 2 items which have
missing filename and offset -- I wonder what makes them different from
other items. I glanced at doc/info/include-maxima.texi and minpack.texi
but I don't see any problems. The Perl script build_index.pl doesn't
print out any error messages for those items. Probably the problem is
that those items don't match the regexes in the Perl script somehow.

I think those items have been broken for some time now.

best,

Robert Dodier

Re: [Maxima-discuss] Documentation fails with error

[Raymond T. <toy...@gm...>]

>>>>> "Robert" == Robert Dodier <rob...@gm...> writes:

    Robert> On 2015-08-29, Raymond Toy <toy...@gm...> wrote:
    >> Don't know when this started happening, but I can't get the
    >> documentation for minpack_lsquares.

    Robert> Looks like the items in maxima-index.lisp for minpack_lsquares and
    Robert> minpack_solve are incomplete -- the file name and offset are default
    Robert> values. The file name and offset are present for the section headings
    Robert> (Introduction to minpack and Functions and variables for minpack) are
    Robert> present and I find those do work with ?.

Found the problem: the node entries in the minpack.texi file were
incomplete and didn't include appropriate links.  I've fixed those and
will land the fix soon.

However, I think build_index.pl should check that the output doesn't
include the default values for the file name and offset.  That would
seem to be an error to me.  I'd fix this myself, but I can barely read
perl, so it would take me quite some time to fix.  This would at least
have caught the issue.

--
Ray

Re: [Maxima-discuss] Documentation fails with error

[Robert D. <rob...@gm...>]

On 2015-08-30, Raymond Toy <toy...@gm...> wrote:

> However, I think build_index.pl should check that the output doesn't
> include the default values for the file name and offset.  That would
> seem to be an error to me.  I'd fix this myself, but I can barely read
> perl, so it would take me quite some time to fix.  This would at least
> have caught the issue.

I agree it would be good for build_index.pl to verify that all items
have valid values. I guess that would be easy -- at the point where
stuff is emitted, just check the outgoing values. It would also be
possible to check all items when the index is loaded into Maxima.

best,

Robert Dodier

Re: [Maxima-discuss] Documentation fails with error

[Raymond T. <toy...@gm...>]

>>>>> "Robert" == Robert Dodier <rob...@gm...> writes:

    Robert> On 2015-08-30, Raymond Toy <toy...@gm...> wrote:
    >> However, I think build_index.pl should check that the output doesn't
    >> include the default values for the file name and offset.  That would
    >> seem to be an error to me.  I'd fix this myself, but I can barely read
    >> perl, so it would take me quite some time to fix.  This would at least
    >> have caught the issue.

    Robert> I agree it would be good for build_index.pl to verify that all items
    Robert> have valid values. I guess that would be easy -- at the point where
    Robert> stuff is emitted, just check the outgoing values. It would also be
    Robert> possible to check all items when the index is loaded into Maxima.

If you handle the build_index.pl side, I can handle the index loading
checks in Maxima. :-)

--
Ray

Re: [Maxima-discuss] Documentation fails with error

[Robert D. <rob...@gm...>]

On 2015-08-31, Raymond Toy <toy...@gm...> wrote:

> If you handle the build_index.pl side, I can handle the index loading
> checks in Maxima. :-)

OK. Commit 703637 on master. 

best

Robert Dodier

Re: [Maxima-discuss] Documentation fails with error

[Raymond T. <toy...@gm...>]

>>>>> "Robert" == Robert Dodier <rob...@gm...> writes:

    Robert> On 2015-08-31, Raymond Toy <toy...@gm...> wrote:
    >> If you handle the build_index.pl side, I can handle the index loading
    >> checks in Maxima. :-)

    Robert> OK. Commit 703637 on master. 

Lisp side fixed too and committed as 070c69af.

--
Ray