Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#477 clarification of docs/messages related to debugging

open
nobody
5
2012-11-18
2003-12-19
Robert Dodier
No

I've identified a number of issues related to the
documentation for using the Maxima debugger and also
the messages generated by that code and messages
related to debugging in a few other places.

I've attached the notes (strangeness-debug.txt) from
which I was working. Each "+" in the notes indicates
something which was changed in the Texinfo or Lisp
files, although not necessarily in just the way
described in the notes. The abbreviation "atwaa" means
"appears to work as advertised".

I've also attached a diff for the affected Texinfo
files (Command.texi, Program.texi, Runtime.texi,
Debugging.texi) and the affected Lisp files
(merror.lisp, mdebug.lisp, macsys.lisp).

The Texinfo changes are mostly to better explain the
current behavior of functions, put in documentation for
thus-far undocumente functions, and erase documentation
for obsolete functions.

The Lisp changes are mostly to make messages agree with
the documentation or to make messages easier to
understand. The one functional change is to replace
MBREAK-LOOP with BREAK-DBM-LOOP in $BREAK (macsys.lisp).

All of these changes have been made in an attempt to
make Maxima easier to comprehend and use. I am hoping
to get the attention of someone who can commit some or
all of these changes. Any comments or discussion would
be extremely helpful.

Discussion

  • Robert Dodier
    Robert Dodier
    2003-12-19

    Working notes for changes to debugging docs/code

     
    Attachments
  • Robert Dodier
    Robert Dodier
    2003-12-19

    diff for texinfo files related to debugging

     
  • Robert Dodier
    Robert Dodier
    2003-12-19

    diff for lisp files related to debugging

     
    Attachments