patchGNU Octave - Patches: patch #8267, Documentation and 'debug-tool'...

 
 

patch #8267: Documentation and 'debug-tool' patch.

Submitted by:  Lasse Schuirmann <sils1297>
Submitted on:  Wed 01 Jan 2014 05:06:46 PM UTC  
 
Category: NonePriority: 5 - Normal
Status: NonePrivacy: Public
Assigned to: NoneOpen/Closed: Open

Add a New Comment (Rich MarkupRich Markup):
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Wed 01 Jan 2014 05:06:46 PM UTC, original submission:

This patch introduces
a) a few doxygen comments, so that the doxygen overview is not that empty anymore.
b) the debug_message_settings.h which contains a 'Macro-composition' for managing debug outputs so you can toggle different debug-output-types. I preconfigured some of them in order to get to know the parse and eval system of octave. - I think this may help other persons too.

This may be helpful for
b.1) Debugging.
b.2) Getting to know the octave code.

You can now go into ./liboctave/util/debug_message_settings.h , take a look at the comments and change the value of VERBOSE in line 52 to one of the specified values below (or above in the comments.)

  • Currently supported types are:
  • - NONE
  • - PARSE_TRACE (Partially implemented)
  • - PARSE_DBG (Not implemented)
  • - EVAL_TRACE
  • - PARSE_MEASURE
  • - EVAL_MEASURE

You can easily concat several options via the | operator.

#define VERBOSE (PARSE_TRACE|EVAL_TRACE)

The parse trace will e.g. look as follows:

>> x = 1
[DBG][PTR] Found identifier.
[DBG][PTR] Found simple expression.
[DBG][PTR] Found numeric constant.
[DBG][PTR] Found simple expression.
[DBG][PTR] Found assign expression.
[DBG][PTR] Found expression.
x = 1
>>

If you define VERBOSE as NONE this patch will have no effect on the runtime-performance.

I hope this is helpful and I'd appreciate any feedback.

Greetings,

Lasse Schuirmann

Lasse Schuirmann <sils1297>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach File(s):
   
   
Comment:
   

Attached Files
file #30143:  dbgdoc.patch added by sils1297 (44kB - text/x-patch - The debug_message_settings.h is at the end of the patch; before that there are te implementations for the traces and measurements.)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by sils1297 (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follows 1 latest change.

    Date Changed By Updated Field Previous Value => Replaced By
    Wed 01 Jan 2014 05:06:46 PM UTCsils1297Attached File-=>Added dbgdoc.patch, #30143

    Back to the top


    Powered by Savane 3.1-cleanup