NSH: Improved documentation of the break command

2 files changed, 132 insertions, 99 deletions

diff --git a/apps/nshlib/README.txt b/apps/nshlib/README.txt
index cdf7600bf..3d57b7bd2 100644
--- a/apps/nshlib/README.txt
+++ b/apps/nshlib/README.txt
@@ -117,12 +117,12 @@ Looping
         Execute <cmd-sequence> as long as <test-cmd> has an exit status of
         zero.
 
-     until <test-cmd>; do <cmd-sequence>; done
+    until <test-cmd>; do <cmd-sequence>; done
 
         Execute <cmd-sequence> as long as <test-cmd> has a non-zero exit
         status.
 
-  A break command is also supported.  The break command is only valid
+  A break command is also supported.  The break command is only meaningful
   within the body of the a while or until loop, between the do and done
   tokens. If the break command is executed within the body of a loop, the
   loop will immediately terminate and execution will continue with the
@@ -301,6 +301,14 @@ o base64dec [-w] [-f] <string or filepath>
 
 o base64dec [-w] [-f] <string or filepath>
 
+o break
+
+  The break command is only meaningful within the body of the a while or
+  until loop, between the do and done tokens. Outside of a loop, break
+  command does nothing. If the break command is executed within the body
+  of a loop, the loop will immediately terminate and execution will
+  continue with the next command immediately following the done token. 
+
 o cat <path> [<path> [<path> ...]]
 
   This command copies and concatenates all of the files at <path>
diff --git a/nuttx/Documentation/NuttShell.html b/nuttx/Documentation/NuttShell.html
index 0be5cf5a0..9e7b1a77c 100644
--- a/nuttx/Documentation/NuttShell.html
+++ b/nuttx/Documentation/NuttShell.html
@@ -113,277 +113,283 @@
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdcat">2.5 Concatenate Files (cat)</a>
+    <a href="#cmdbreak">2.5 Terminate a Loop (break)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdcd">2.6 Change Current Working Directory (cd)</a>
+    <a href="#cmdcat">2.6 Concatenate Files (cat)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdcmp">2.7 Compare Files (cmp)</a>
+    <a href="#cmdcd">2.7 Change Current Working Directory (cd)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdcp">2.8 Copy Files (cp)</a>
+    <a href="#cmdcmp">2.8 Compare Files (cmp)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmddate">2.9 Show or set the date and time (date)</a>
+    <a href="#cmdcp">2.9 Copy Files (cp)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmddd">2.10 Copy and Convert Files (dd)</a>
+    <a href="#cmddate">2.10 Show or set the date and time (date)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmddelroute">2.11 Delete a Routing Table Entry (delroute)</a>
+    <a href="#cmddd">2.11 Copy and Convert Files (dd)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmddf">2.12 Show volume status (df)</a>
+    <a href="#cmddelroute">2.12 Delete a Routing Table Entry (delroute)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdecho">2.13 Echo Strings and Variables (echo)</a>
+    <a href="#cmddf">2.13 Show volume status (df)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdexec">2.14 Execute User Code (exec)</a>
+    <a href="#cmdecho">2.14 Echo Strings and Variables (echo)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdexit">2.15 Exit NSH (exit)</a>
+    <a href="#cmdexec">2.15 Execute User Code (exec)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdfree">2.16 Show Memory Manager Status (free)</a>
+    <a href="#cmdexit">2.16 Exit NSH (exit)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdget">2.17 Get File Via TFTP (get)</a>
+    <a href="#cmdfree">2.17 Show Memory Manager Status (free)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdhelp">2.18 Show Usage Command Usage (help)</a>
+    <a href="#cmdget">2.18 Get File Via TFTP (get)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdhexdump">2.19 Hexadecimal Dump of File or Device (hexdump)</a>
+    <a href="#cmdhelp">2.19 Show Usage Command Usage (help)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdifconfig">2.20 Manage Network Configuration (ifconfig)</a>
+    <a href="#cmdhexdump">2.20 Hexadecimal Dump of File or Device (hexdump)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdifdown">2.21 Take a network down (ifdown)</a>
+    <a href="#cmdifconfig">2.21 Manage Network Configuration (ifconfig)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdifup">2.22 Bring a network up (ifup)</a>
+    <a href="#cmdifdown">2.22 Take a network down (ifdown)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdkill">2.23 Send a signal to a task (kill)</a>
+    <a href="#cmdifup">2.23 Bring a network up (ifup)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdlosetup">2.24 Setup/teardown the Loop Device (losetup)</a>
+    <a href="#cmdkill">2.24 Send a signal to a task (kill)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdls">2.25 List Directory Contents (ls)</a>
+    <a href="#cmdlosetup">2.25 Setup/teardown the Loop Device (losetup)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmd5">2.26 Calculate MD5 (md5)</a>
+    <a href="#cmdls">2.26 List Directory Contents (ls)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmbhw">2.27 Access Memory (mb, mh, and mw)</a>
+    <a href="#cmdmd5">2.27 Calculate MD5 (md5)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdps">2.28 Show Current Tasks and Threads (ps)</a>
+    <a href="#cmdmbhw">2.28 Access Memory (mb, mh, and mw)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkdir">2.29 Create a Directory (mkdir)</a>
+    <a href="#cmdps">2.29 Show Current Tasks and Threads (ps)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkfatfs">2.30 Create a FAT Filesystem (mkfatfs)</a>
+    <a href="#cmdmkdir">2.30 Create a Directory (mkdir)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkfifo">2.31 Create a FIFO (mkfifo)</a>
+    <a href="#cmdmkfatfs">2.31 Create a FAT Filesystem (mkfatfs)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkrd">2.32 Create a RAMDISK (mkrd)</a>
+    <a href="#cmdmkfifo">2.32 Create a FIFO (mkfifo)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmount">2.33 Mount a File System (mount)</a>
+    <a href="#cmdmkrd">2.33 Create a RAMDISK (mkrd)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmv">2.34 Rename a File (mv)</a>
+    <a href="#cmdmount">2.34 Mount a File System (mount)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdnfsmount">2.35 Mount an NFS file system (nfsmount)</a>
+    <a href="#cmdmv">2.35 Rename a File (mv)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdping">2.36 Check Network Peer (ping)</a>
+    <a href="#cmdnfsmount">2.36 Mount an NFS file system (nfsmount)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdput">2.37 Send File Via TFTP (put)</a>
+    <a href="#cmdping">2.37 Check Network Peer (ping)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdpwd">2.38 Show Current Working Directory (pwd)</a>
+    <a href="#cmdput">2.38 Send File Via TFTP (put)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdrm">2.39 Remove a File (rm)</a>
+    <a href="#cmdpwd">2.39 Show Current Working Directory (pwd)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdrmdir">2.40 Remove a Directory (rmdir)</a>
+    <a href="#cmdrm">2.40 Remove a File (rm)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdset">2.41 Set an Environment Variable (set)</a>
+    <a href="#cmdrmdir">2.41 Remove a Directory (rmdir)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdsh">2.42 Execute an NSH Script (sh)</a>
+    <a href="#cmdset">2.42 Set an Environment Variable (set)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdsleep">2.43 Wait for Seconds (sleep)</a>
+    <a href="#cmdsh">2.43 Execute an NSH Script (sh)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdunmount">2.44 Unmount a File System (umount)</a>
+    <a href="#cmdsleep">2.44 Wait for Seconds (sleep)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdunset">2.45 Unset an Environment Variable (unset)</a>
+    <a href="#cmdunmount">2.45 Unmount a File System (umount)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdurldec">2.46 URL Decode (urldecode)</a>
+    <a href="#cmdunset">2.46 Unset an Environment Variable (unset)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdurlencode">2.47 URL Encode (urlencode)</a>
+    <a href="#cmdurldec">2.47 URL Decode (urldecode)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdusleep">2.48 Wait for Microseconds (usleep)</a>
+    <a href="#cmdurlencode">2.48 URL Encode (urlencode)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdwget">2.49 Get File Via HTTP (wget)</a>
+    <a href="#cmdusleep">2.49 Wait for Microseconds (usleep)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdxd">2.50 Hexadecimal Dump of Memory (xd)</a>
+    <a href="#cmdwget">2.50 Get File Via HTTP (wget)</a>
+  </td>
+</tr>
+<tr>
+  <td><br></td>
+  <td>
+    <a href="#cmdxd">2.51 Hexadecimal Dump of Memory (xd)</a>
   </td>
 </tr>
 <tr>
@@ -639,7 +645,7 @@ done
     Execute <code>[sequence of &lt;cmd&gt;]</code> as long as <code>&lt;cmd&gt;</code> has a non-zero exit status.
     The syntax is as follows:
     <ul><pre>
-while &lt;cmd&gt;
+until &lt;cmd&gt;
 do
   [sequence of &lt;cmd&gt;]
 done
@@ -648,9 +654,9 @@ done
   </li>
 </ul>
 
-<p><b>The <code>break</code> Command</b>.
-  A <code>break</code> command is also supported.
-  The <code>break</code> command is only valid within the body of the a while or until loop, between the <code>do</code> and <code>done</code> tokens.
+<p><b>The <a href="#cmdbreak"><code>break</code></a> Command</b>.
+  A <a href="#cmdbreak"><code>break</code></a> command is also supported.
+  The <code>break</code> command is only meaningful within the body of the a while or until loop, between the <code>do</code> and <code>done</code> tokens.
   If the <code>break</code> command is executed within the body of a loop, the loop will immediately terminate and execution will continue with the next command immediately following the <code>done</code> token.
 <p>
 
@@ -962,7 +968,26 @@ base64enc [-w] [-f] &lt;string or filepath&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdcat"><h2>2.5 Concatenate Files (cat)</h2></a>
+    <a name="cmdbreak"><h2>2.5 Terminate a Loop (break)</h2></a>
+  </td>
+  </tr>
+</table>
+
+<p><b>Command Syntax:</b></p>
+<ul><pre>
+break
+</pre></ul>
+<p>
+  <b>Synopsis</b>.
+  The <code>break</code> command is only meaningful within the body of the a <a href="#looping">while</a> or <a href="#looping">until</a> loop, between the <code>do</code> and <code>done</code> tokens.
+  Outside of a loop, <code>break</code> command does nothing.
+  If the <code>break</code> command is executed within the body of a loop, the loop will immediately terminate and execution will continue with the next command immediately following the <code>done</code> token.
+<p>
+
+<table width ="100%">
+  <tr bgcolor="#e4e4e4">
+  <td>
+    <a name="cmdcat"><h2>2.6 Concatenate Files (cat)</h2></a>
   </td>
   </tr>
 </table>
@@ -980,7 +1005,7 @@ cat <code>&lt;path&gt;</code> [<code>&lt;path&gt;</code> [<code>&lt;path&gt;</co
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdcd"><h2>2.6 Change Current Working Directory (cd)</h2></a>
+    <a name="cmdcd"><h2>2.7 Change Current Working Directory (cd)</h2></a>
   </td>
   </tr>
 </table>
@@ -1022,7 +1047,7 @@ cd [&lt;dir-path&gt;|-|~|..]
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdcmp"><h2>2.7 Compare Files (cmp)</h2></a>
+    <a name="cmdcmp"><h2>2.8 Compare Files (cmp)</h2></a>
   </td>
   </tr>
 </table>
@@ -1039,7 +1064,7 @@ cmp &lt;path1&gt; &lt;path2&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdcp"><h2>2.8 Copy Files (cp)</h2></a>
+    <a name="cmdcp"><h2>2.9 Copy Files (cp)</h2></a>
   </td>
   </tr>
 </table>
@@ -1057,7 +1082,7 @@ cp &lt;source-path&gt; &lt;dest-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmddate"><h2>2.9 Show or set the date and time (date)</h2></a>
+    <a name="cmddate"><h2>2.10 Show or set the date and time (date)</h2></a>
   </td>
   </tr>
 </table>
@@ -1084,7 +1109,7 @@ data -s &quot;Sep 1 11:30:00 2011&quot;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmddd"><h2>2.10 Copy and Convert Files (dd)</h2></a>
+    <a name="cmddd"><h2>2.11 Copy and Convert Files (dd)</h2></a>
   </td>
   </tr>
 </table>
@@ -1142,7 +1167,7 @@ nsh&gt; dd if=/dev/ram0 of=/dev/null
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmddelroute"><h2>2.11 Delete a Routing Table Entry (delroute)</h2></a>
+    <a name="cmddelroute"><h2>2.12 Delete a Routing Table Entry (delroute)</h2></a>
   </td>
   </tr>
 </table>
@@ -1165,7 +1190,7 @@ nsh&gt; delroute 1.1.1.1 2.2.2.2
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmddf"><h2>2.12 Show Volument Status (df)</h2></a>
+    <a name="cmddf"><h2>2.13 Show Volument Status (df)</h2></a>
   </td>
   </tr>
 </table>
@@ -1197,7 +1222,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdecho"><h2>2.13 Echo Strings and Variables (echo)</h2></a>
+    <a name="cmdecho"><h2>2.14 Echo Strings and Variables (echo)</h2></a>
   </td>
   </tr>
 </table>
@@ -1215,7 +1240,7 @@ echo [&lt;string|$name&gt; [&lt;string|$name&gt;...]]
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdexec"><h2>2.14 Execute User Code (exec)</h2></a>
+    <a name="cmdexec"><h2>2.15 Execute User Code (exec)</h2></a>
   </td>
   </tr>
 </table>
@@ -1234,7 +1259,7 @@ exec &lt;hex-address&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdexit"><h2>2.15 Exit NSH (exit)</h2></a>
+    <a name="cmdexit"><h2>2.16 Exit NSH (exit)</h2></a>
   </td>
   </tr>
 </table>
@@ -1253,7 +1278,7 @@ exit
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdfree"><h2>2.16 Show Memory Manager Status (free)</h2></a>
+    <a name="cmdfree"><h2>2.17 Show Memory Manager Status (free)</h2></a>
   </td>
   </tr>
 </table>
@@ -1295,7 +1320,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdget"><h2>2.17 Get File Via TFTP (get)</h2></a>
+    <a name="cmdget"><h2>2.18 Get File Via TFTP (get)</h2></a>
   </td>
   </tr>
 </table>
@@ -1330,7 +1355,7 @@ get [-b|-n] [-f &lt;local-path&gt;] -h &lt;ip-address&gt; &lt;remote-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdhelp"><h2>2.18 Show Usage Command Usage (help)</h2></a>
+    <a name="cmdhelp"><h2>2.19 Show Usage Command Usage (help)</h2></a>
   </td>
   </tr>
 </table>
@@ -1362,7 +1387,7 @@ help [-v] [&lt;cmd&gt;]
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdhexdump"><h2>2.19 Hexadecimal Dump of File or Device (hexdump)</h2></a>
+    <a name="cmdhexdump"><h2>2.20 Hexadecimal Dump of File or Device (hexdump)</h2></a>
   </td>
   </tr>
 </table>
@@ -1386,7 +1411,7 @@ hexdump &lt;file or device&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdifconfig"><h2>2.20 Manage Network Configuration (ifconfig)</h2></a>
+    <a name="cmdifconfig"><h2>2.21 Manage Network Configuration (ifconfig)</h2></a>
   </td>
   </tr>
 </table>
@@ -1440,7 +1465,7 @@ ifconfig nic_name ip_address
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdifdown"><h2>2.21 Take a network down (ifdown)</h2></a>
+    <a name="cmdifdown"><h2>2.22 Take a network down (ifdown)</h2></a>
   </td>
   </tr>
 </table>
@@ -1463,7 +1488,7 @@ ifdown eth0
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdifup"><h2>2.22 Bring a network up (ifup)</h2></a>
+    <a name="cmdifup"><h2>2.23 Bring a network up (ifup)</h2></a>
   </td>
   </tr>
 </table>
@@ -1486,7 +1511,7 @@ ifup eth0
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdkill"><h2>2.23 Send a signal to a task (kill)</h2></a>
+    <a name="cmdkill"><h2>2.24 Send a signal to a task (kill)</h2></a>
   </td>
   </tr>
 </table>
@@ -1527,7 +1552,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdlosetup"><h2>2.24 Setup/teardown the Loop Device (losetup)</h2></a>
+    <a name="cmdlosetup"><h2>2.25 Setup/teardown the Loop Device (losetup)</h2></a>
   </td>
   </tr>
 </table>
@@ -1580,7 +1605,7 @@ losetup d &lt;dev-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdls"><h2>2.25 List Directory Contents (ls)</h2></a>
+    <a name="cmdls"><h2>2.26 List Directory Contents (ls)</h2></a>
   </td>
   </tr>
 </table>
@@ -1617,7 +1642,7 @@ ls [-lRs] &lt;dir-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmd5"><h2>2.26 Calculate MD5 (md5)</h2></a>
+    <a name="cmdmd5"><h2>2.27 Calculate MD5 (md5)</h2></a>
   </td>
   </tr>
 </table>
@@ -1634,7 +1659,7 @@ md5 [-f] &lt;string or filepath&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmbhw"><h2>2.27 Access Memory (mb, mh, and mw)</h2></a>
+    <a name="cmdmbhw"><h2>2.28 Access Memory (mb, mh, and mw)</h2></a>
   </td>
   </tr>
 </table>
@@ -1688,7 +1713,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdps"><h2>2.28 Show Current Tasks and Threads (ps)</h2></a>
+    <a name="cmdps"><h2>2.29 Show Current Tasks and Threads (ps)</h2></a>
   </td>
   </tr>
 </table>
@@ -1714,7 +1739,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkdir"><h2>2.29 Create a Directory (mkdir)</h2></a>
+    <a name="cmdmkdir"><h2>2.30 Create a Directory (mkdir)</h2></a>
   </td>
 </tr>
 </table>
@@ -1749,7 +1774,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkfatfs"><h2>2.30 Create a FAT Filesystem (mkfatfs)</h2></a>
+    <a name="cmdmkfatfs"><h2>2.31 Create a FAT Filesystem (mkfatfs)</h2></a>
   </td>
 </tr>
 </table>
@@ -1774,7 +1799,7 @@ mkfatfs [-F &lt;fatsize&gt;] &lt;block-driver&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkfifo"><h2>2.31 Create a FIFO (mkfifo)</h2></a>
+    <a name="cmdmkfifo"><h2>2.32 Create a FIFO (mkfifo)</h2></a>
   </td>
 </tr>
 </table>
@@ -1812,7 +1837,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkrd"><h2>2.32 Create a RAMDISK (mkrd)</h2></a>
+    <a name="cmdmkrd"><h2>2.33 Create a RAMDISK (mkrd)</h2></a>
   </td>
 </tr>
 </table>
@@ -1863,7 +1888,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmount"><h2>2.33 Mount a File System (mount)</h2></a>
+    <a name="cmdmount"><h2>2.34 Mount a File System (mount)</h2></a>
   </td>
 </tr>
 </table>
@@ -1942,7 +1967,7 @@ nsh> mount
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmv"><h2>2.34 Rename a File (mv)</h2></a>
+    <a name="cmdmv"><h2>2.35 Rename a File (mv)</h2></a>
   </td>
   </tr>
 </table>
@@ -1960,7 +1985,7 @@ mv &lt;old-path&gt; &lt;new-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdnfsmount"><h2>2.35 Mount an NFS file system (nfsmount)</h2></a>
+    <a name="cmdnfsmount"><h2>2.36 Mount an NFS file system (nfsmount)</h2></a>
   </td>
   </tr>
 </table>
@@ -1979,7 +2004,7 @@ nfsmount &lt;server-address&gt; &lt;mount-point&gt; &lt;remote-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdping"><h2>2.36 Check Network Peer (ping)</h2></a>
+    <a name="cmdping"><h2>2.37 Check Network Peer (ping)</h2></a>
   </td>
   </tr>
 </table>
@@ -2012,7 +2037,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdput"><h2>2.37 Send File Via TFTP (put)</h2></a>
+    <a name="cmdput"><h2>2.38 Send File Via TFTP (put)</h2></a>
   </td>
   </tr>
 </table>
@@ -2047,7 +2072,7 @@ put [-b|-n] [-f &lt;remote-path&gt;] -h &lt;ip-address&gt; &lt;local-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdpwd"><h2>2.38 Show Current Working Directory (pwd)</h2></a>
+    <a name="cmdpwd"><h2>2.39 Show Current Working Directory (pwd)</h2></a>
   </td>
   </tr>
 </table>
@@ -2077,7 +2102,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdrm"><h2>2.39 Remove a File (rm)</h2></a>
+    <a name="cmdrm"><h2>2.40 Remove a File (rm)</h2></a>
   </td>
 </tr>
 </table>
@@ -2111,7 +2136,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdrmdir"><h2>2.40 Remove a Directory (rmdir)</h2></a>
+    <a name="cmdrmdir"><h2>2.41 Remove a Directory (rmdir)</h2></a>
   </td>
 </tr>
 </table>
@@ -2146,7 +2171,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdset"><h2>2.41 Set an Environment Variable (set)</h2></a>
+    <a name="cmdset"><h2>2.42 Set an Environment Variable (set)</h2></a>
   </td>
   </tr>
 </table>
@@ -2172,7 +2197,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdsh"><h2>2.42 Execute an NSH Script (sh)</h2></a>
+    <a name="cmdsh"><h2>2.43 Execute an NSH Script (sh)</h2></a>
   </td>
   </tr>
 </table>
@@ -2190,7 +2215,7 @@ sh &lt;script-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdsleep"><h2>2.43 Wait for Seconds (sleep)</h2></a>
+    <a name="cmdsleep"><h2>2.44 Wait for Seconds (sleep)</h2></a>
   </td>
   </tr>
 </table>
@@ -2207,7 +2232,7 @@ sleep &lt;sec&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdunmount"><h2>2.44 Unmount a File System (umount)</h2></a>
+    <a name="cmdunmount"><h2>2.45 Unmount a File System (umount)</h2></a>
   </td>
 </tr>
 </table>
@@ -2237,7 +2262,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdunset"><h2>2.45 Unset an Environment Variable (unset)</h2></a>
+    <a name="cmdunset"><h2>2.46 Unset an Environment Variable (unset)</h2></a>
   </td>
   </tr>
 </table>
@@ -2263,7 +2288,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdurldec"><h2>2.46 URL Decode (urldecode)</h2></a>
+    <a name="cmdurldec"><h2>2.47 URL Decode (urldecode)</h2></a>
   </td>
   </tr>
 </table>
@@ -2280,7 +2305,7 @@ urldecode [-f] &lt;string or filepath&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdurlencode"><h2>2.47 URL Encode (urlencode)</h2></a>
+    <a name="cmdurlencode"><h2>2.48 URL Encode (urlencode)</h2></a>
   </td>
   </tr>
 </table>
@@ -2297,7 +2322,7 @@ urlencode [-f] &lt;string or filepath&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdusleep"><h2>2.48 Wait for Microseconds (usleep)</h2></a>
+    <a name="cmdusleep"><h2>2.49 Wait for Microseconds (usleep)</h2></a>
   </td>
   </tr>
 </table>
@@ -2314,7 +2339,7 @@ usleep &lt;usec&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdwget">2.49 Get File Via HTTP (wget)</a>
+    <a name="cmdwget">2.50 Get File Via HTTP (wget)</a>
   </td>
   </tr>
 </table>
@@ -2341,7 +2366,7 @@ wget [-o &lt;local-path&gt;] &lt;url&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdxd"><h2>2.50 Hexadecimal Dump of Memory (xd)</h2></a>
+    <a name="cmdxd"><h2>2.51 Hexadecimal Dump of Memory (xd)</h2></a>
   </td>
   </tr>
 </table>
@@ -4011,7 +4036,7 @@ mount -t vfat /dev/ram1 /tmp
   <li><a href="#cmdoverview">Background commands</a></li>
   <li><a href="#cmdoverview">Background command priority</a></li>
   <li><a href="#custapps"><code>binfs</code></a></li>
-  <li><a href="#looping"><code>break</code></a></li>
+  <li><a href="#cmdbreak"><code>break</code></a></li>
   <li><a href="#custapps">Built-In applications</a></li>
   <li><a href="#custapps">Built-In application start-up <code>main()</code></a></li>
   <li><a href="#builtinvars">Built-in variables</a></li>