v0.2.8é

Author: Nelson-numerical-software

en/README.md

@@ -1,6 +1,6 @@
 ![banner](banner_homepage.png)
 
-### Nelson 0.2.7.0
+### Nelson 0.2.8.0
 
 This is an pre-release of Nelson.
 

en/SUMMARY.md

@@ -15,6 +15,7 @@
     * [abort](./interpreter/abort.md)
     * [break](./interpreter/break.md)
     * [continue](./interpreter/continue.md)
+    * [dbstack](./interpreter/dbstack.md)
     * [for](./interpreter/for.md)
     * [function](./interpreter/function.md)
     * [if](./interpreter/if.md)
@@ -71,6 +72,7 @@
 * [error_manager](./error_manager/README.md)
     * [error](./error_manager/error.md)
     * [lasterror](./error_manager/lasterror.md)
+    * [lastwarn](./error_manager/lastwarn.md)
     * [warning](./error_manager/warning.md)
 
 

en/error_manager/README.md

@@ -10,6 +10,7 @@ error handling functions
 
 * [error](error.md) - Raise an error message.
 * [lasterror](lasterror.md) - Returns last recorded error message.
+* [lastwarn](lastwarn.md) - Returns last recorded warning message.
 * [warning](warning.md) - Display a warning message.
 
 

en/error_manager/SUMMARY.md

@@ -1,5 +1,6 @@
 * [error_manager](README.md)
     * [error](error.md)
     * [lasterror](lasterror.md)
+    * [lastwarn](lastwarn.md)
     * [warning](warning.md)
 

en/error_manager/lastwarn.md

@@ -0,0 +1,55 @@
+
+
+# lastwarn
+
+Returns last recorded warning message.
+
+## Syntax
+
+- last_message = lastwarn()
+- [last_message, last_identifier] = lastwarn()
+- lastwarn('')
+- lastwarn(new_message)
+- lastwarn(new_message, new_identifier)
+- [last_message, last_identifier] = lastwarn('')
+- [last_message, last_identifier] = lastwarn(new_message)
+- [last_message, last_identifier] = lastwarn(new_message, new_identifier)
+
+## Output argument
+
+ - last_message - string: last warning message.
+ - last_identifier - string: identifier.
+
+## Description
+
+
+  <p><b>last_message = lastwarn()</b> returns a string containing the last warning message.</p>
+  <p><b>lastwarn('')</b> clears last warning.</p>
+
+
+## Example
+
+```matlab
+[1:3]:3
+    lastwarn
+    [msg, id] = lastwarn()
+    lastwarn('')
+    [msg, id] = lastwarn()
+```
+
+## See also
+
+[error](error.md), [warning](warning.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+

en/error_manager/warning.md

@@ -6,27 +6,49 @@ Display a warning message.
 
 ## Syntax
 
+- warning()
 - warning(msg)
+- warning(id, msg)
+- warning(state)
+- warning(state, id)
+- st = warning()
+- warning(st)
+
+## Input argument
+
+ - id - a string: identifier for the warning.
+ - msg - a string: message to warn.
+ - state - a string: 'on', 'off', 'aserror', 'all' or 'query'.
+ - st - a struct: set warning settings.
 
 ## Output argument
 
- - msg - a string.
+ - st - a struct, warning settings.
 
 ## Description
 
 
   <p><b>warning</b> displays a warning message.</p>
+  <p><b>warning('')</b> resets lastwarn state.</p>
 
 
-## Example
+## Examples
 
 ```matlab
 warning('your warning message.')
 ```
+```matlab
+warning('on', 'myModule:identifier');
+warning('myModule:identifier', 'my message 1 on');
+warning('off', 'myModule:identifier');
+warning('myModule:identifier', 'my message 2 off');
+warning('aserror', 'myModule:identifier');
+warning('myModule:identifier', 'my message 3 as error');
+```
 
 ## See also
 
-[lasterror](lasterror.md), [warning](error.md).
+[lasterror](lasterror.md), [error](error.md), [lastwarn](lastwarn.md).
 ## History
 
 |Version|Description|

en/interpreter/README.md

@@ -11,6 +11,7 @@ interpreter functions
 * [abort](abort.md) - stop evaluation.
 * [break](break.md) - exit evaluation loop.
 * [continue](continue.md) - continue evaluation in loop.
+* [dbstack](dbstack.md) - call stack.
 * [for](for.md) - for loop.
 * [function](function.md) - function declaration.
 * [if](if.md) - conditional statement.

en/interpreter/SUMMARY.md

@@ -2,6 +2,7 @@
     * [abort](abort.md)
     * [break](break.md)
     * [continue](continue.md)
+    * [dbstack](dbstack.md)
     * [for](for.md)
     * [function](function.md)
     * [if](if.md)

en/interpreter/dbstack.md

@@ -0,0 +1,55 @@
+
+
+# dbstack
+
+call stack.
+
+## Syntax
+
+- dbstack
+- st = dbstack()
+- dbstack('-completenames')
+- st = dbstack('-completenames')
+- dbstack('-completenames', omit)
+- st = dbstack('-completenames', omit)
+
+## Input argument
+
+ - omit - an integer value: Number of frames to omit (must be positive).
+
+## Output argument
+
+ - st - a struct
+
+## Description
+
+
+  <p><b>dbstack</b> displays the file names and line numbers of the function calls.</p>
+  <p><b>dbstack('-completenames')</b> displays the full file names.</p>
+
+
+## Example
+
+Creates a myfun.nlf and calls it.
+```matlab
+function myfun(x)
+dbstack();
+end
+```
+
+## See also
+
+[which](../functions_manager/which.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+

fr/README.md

@@ -1,6 +1,6 @@
 ![banner](banner_homepage.png)
 
-### Nelson 0.2.7.0
+### Nelson 0.2.8.0
 
 Ceci est une version alpha de Nelson.