Changes between Version 3 and Version 4 of CleanupMakeHtml

Show
Ignore:
Timestamp:
07/18/10 20:52:53 (12 years ago)
Author:
coke
Comment:

don't bother with the very noisy errata section for now.

Legend:

Unmodified
Added
Removed
Modified
  • CleanupMakeHtml

    v3 v4  
    2020--- 
    2121>                     <a href="../../../../html/index.html">Home</a> &raquo; Getting Started 
    22 151,169d150 
    23 <        
    24 < <h1><a name="POD_ERRORS" 
    25 < >POD ERRORS</a></h1> 
    26 <  
    27 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    28 <  
    29 < <dl> 
    30 < <dt><a name="Around_line_9:" 
    31 < >Around line 9:</a></dt> 
    32 < Deleting unknown formatting code U&#60;&#62;Deleting unknown formatting code U&#60;&#62; 
    33 < <dt><a name="Around_line_16:" 
    34 < >Around line 16:</a></dt> 
    35 < Deleting unknown formatting code U&#60;&#62; 
    36 < <dt><a name="Around_line_120:" 
    37 < >Around line 120:</a></dt> 
    38 < =end for without matching =begin.  (Stack: =over) 
    39 < <dt><a name="Around_line_131:" 
    40 < >Around line 131:</a></dt> 
    41 < =end for without matching =begin.  (Stack: =over)</dl> 
    42 173c154 
     22154c154 
    4323<               Copyright &copy; 2002-2010, Parrot Foundation. 
    4424--- 
     
    5333--- 
    5434>                     <a href="../../../../html/index.html">Home</a> &raquo; Parrot Compiler Tools 
    55 339,357d338 
    56 <  
    57 < <h1><a name="POD_ERRORS" 
    58 < >POD ERRORS</a></h1> 
    59 <  
    60 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    61 <  
    62 < <dl> 
    63 < <dt><a name="Around_line_5:" 
    64 < >Around line 5:</a></dt> 
    65 < A non&#45;empty Z&#60;&#62; 
    66 < <dt><a name="Around_line_44:" 
    67 < >Around line 44:</a></dt> 
    68 < Deleting unknown formatting code N&#60;&#62; 
    69 < <dt><a name="Around_line_70:" 
    70 < >Around line 70:</a></dt> 
    71 < Deleting unknown formatting code N&#60;&#62; 
    72 < <dt><a name="Around_line_177:" 
    73 < >Around line 177:</a></dt> 
    74 < Deleting unknown formatting code N&#60;&#62;</dl> 
    75 361c342 
     35342c342 
    7636<               Copyright &copy; 2002-2010, Parrot Foundation. 
    7737--- 
     
    8646--- 
    8747>                     <a href="../../../../html/index.html">Home</a> &raquo; Grammar Engine 
    88 628,724d627 
    89 <  
    90 < <h1><a name="POD_ERRORS" 
    91 < >POD ERRORS</a></h1> 
    92 <  
    93 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    94 <  
    95 < <dl> 
    96 < <dt><a name="Around_line_32:" 
    97 < >Around line 32:</a></dt> 
    98 < Deleting unknown formatting code N&#60;&#62; 
    99 < <dt><a name="Around_line_117:" 
    100 < >Around line 117:</a></dt> 
    101 < =end for without matching =begin.  (Stack: [empty]) 
    102 < <dt><a name="Around_line_318:" 
    103 < >Around line 318:</a></dt> 
    104 < A non&#45;empty Z&#60;&#62; 
    105 < <dt><a name="Around_line_339:" 
    106 < >Around line 339:</a></dt> 
    107 < Deleting unknown formatting code A&#60;&#62; 
    108 < <dt><a name="Around_line_541:" 
    109 < >Around line 541:</a></dt> 
    110 < A non&#45;empty Z&#60;&#62; 
    111 < <dt><a name="Around_line_546:" 
    112 < >Around line 546:</a></dt> 
    113 < Deleting unknown formatting code R&#60;&#62; 
    114 < <dt><a name="Around_line_560:" 
    115 < >Around line 560:</a></dt> 
    116 < Deleting unknown formatting code A&#60;&#62; 
    117 < <dt><a name="Around_line_631:" 
    118 < >Around line 631:</a></dt> 
    119 < A non&#45;empty Z&#60;&#62; 
    120 < <dt><a name="Around_line_653:" 
    121 < >Around line 653:</a></dt> 
    122 < Deleting unknown formatting code N&#60;&#62; 
    123 < <dt><a name="Around_line_675:" 
    124 < >Around line 675:</a></dt> 
    125 < Deleting unknown formatting code A&#60;&#62; 
    126 < <dt><a name="Around_line_780:" 
    127 < >Around line 780:</a></dt> 
    128 < A non&#45;empty Z&#60;&#62; 
    129 < <dt><a name="Around_line_805:" 
    130 < >Around line 805:</a></dt> 
    131 < Deleting unknown formatting code R&#60;&#62;Deleting unknown formatting code R&#60;&#62; 
    132 < <dt><a name="Around_line_809:" 
    133 < >Around line 809:</a></dt> 
    134 < Deleting unknown formatting code R&#60;&#62;Deleting unknown formatting code R&#60;&#62; 
    135 < <dt><a name="Around_line_820:" 
    136 < >Around line 820:</a></dt> 
    137 < Deleting unknown formatting code R&#60;&#62;Deleting unknown formatting code R&#60;&#62;Deleting unknown formatting code R&#60;&#62;Deleting unknown formatting code R&#60;&#62;Deleting unknown formatting code R&#60;&#62; 
    138 < <dt><a name="Around_line_836:" 
    139 < >Around line 836:</a></dt> 
    140 < Deleting unknown formatting code A&#60;&#62; 
    141 < <dt><a name="Around_line_981:" 
    142 < >Around line 981:</a></dt> 
    143 < A non&#45;empty Z&#60;&#62; 
    144 < <dt><a name="Around_line_983:" 
    145 < >Around line 983:</a></dt> 
    146 < Deleting unknown formatting code A&#60;&#62; 
    147 < <dt><a name="Around_line_1076:" 
    148 < >Around line 1076:</a></dt> 
    149 < A non&#45;empty Z&#60;&#62; 
    150 < <dt><a name="Around_line_1078:" 
    151 < >Around line 1078:</a></dt> 
    152 < Deleting unknown formatting code A&#60;&#62; 
    153 < <dt><a name="Around_line_1090:" 
    154 < >Around line 1090:</a></dt> 
    155 < =end for without matching =begin.  (Stack: [empty]) 
    156 < <dt><a name="Around_line_1150:" 
    157 < >Around line 1150:</a></dt> 
    158 < Deleting unknown formatting code N&#60;&#62; 
    159 < <dt><a name="Around_line_1159:" 
    160 < >Around line 1159:</a></dt> 
    161 < =end for without matching =begin.  (Stack: [empty]) 
    162 < <dt><a name="Around_line_1194:" 
    163 < >Around line 1194:</a></dt> 
    164 < Deleting unknown formatting code N&#60;&#62; 
    165 < <dt><a name="Around_line_1303:" 
    166 < >Around line 1303:</a></dt> 
    167 < =end for without matching =begin.  (Stack: [empty]) 
    168 < <dt><a name="Around_line_1372:" 
    169 < >Around line 1372:</a></dt> 
    170 < =end for without matching =begin.  (Stack: [empty]) 
    171 < <dt><a name="Around_line_1428:" 
    172 < >Around line 1428:</a></dt> 
    173 < A non&#45;empty Z&#60;&#62; 
    174 < <dt><a name="Around_line_1477:" 
    175 < >Around line 1477:</a></dt> 
    176 < =end for without matching =begin.  (Stack: [empty]) 
    177 < <dt><a name="Around_line_1496:" 
    178 < >Around line 1496:</a></dt> 
    179 < Deleting unknown formatting code N&#60;&#62; 
    180 < <dt><a name="Around_line_1502:" 
    181 < >Around line 1502:</a></dt> 
    182 < Deleting unknown formatting code N&#60;&#62; 
    183 < <dt><a name="Around_line_1513:" 
    184 < >Around line 1513:</a></dt> 
    185 < =end for without matching =begin.  (Stack: [empty])</dl> 
    186 728c631 
     48631c631 
    18749<               Copyright &copy; 2002-2010, Parrot Foundation. 
    18850--- 
     
    19759--- 
    19860>                     <a href="../../../../html/index.html">Home</a> &raquo; Grammar Actions 
    199 223,238d222 
    200 <  
    201 < <h1><a name="POD_ERRORS" 
    202 < >POD ERRORS</a></h1> 
    203 <  
    204 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    205 <  
    206 < <dl> 
    207 < <dt><a name="Around_line_29:" 
    208 < >Around line 29:</a></dt> 
    209 < Deleting unknown formatting code N&#60;&#62; 
    210 < <dt><a name="Around_line_106:" 
    211 < >Around line 106:</a></dt> 
    212 < =end for without matching =begin.  (Stack: [empty]) 
    213 < <dt><a name="Around_line_190:" 
    214 < >Around line 190:</a></dt> 
    215 < =end for without matching =begin.  (Stack: [empty])</dl> 
    216 242c226 
     61226c226 
    21762<               Copyright &copy; 2002-2010, Parrot Foundation. 
    21863--- 
     
    22772--- 
    22873>                     <a href="../../../../html/index.html">Home</a> &raquo; Introduction 
    229 159,188d158 
    230 <  
    231 < <h1><a name="POD_ERRORS" 
    232 < >POD ERRORS</a></h1> 
    233 <  
    234 < <p>Hey! 
    235 < <b>The above document had some coding errors, 
    236 < which are explained below:</b></p> 
    237 <  
    238 < <dl> 
    239 < <dt><a name="Around_line_12:" 
    240 < >Around line 12:</a></dt> 
    241 < Deleting unknown formatting code U&#60;&#62; 
    242 < <dt><a name="Around_line_29:" 
    243 < >Around line 29:</a></dt> 
    244 < Deleting unknown formatting code U&#60;&#62; 
    245 < <dt><a name="Around_line_39:" 
    246 < >Around line 39:</a></dt> 
    247 < Deleting unknown formatting code U&#60;&#62; 
    248 < <dt><a name="Around_line_50:" 
    249 < >Around line 50:</a></dt> 
    250 < Deleting unknown formatting code N&#60;&#62;Deleting unknown formatting code U&#60;&#62; 
    251 < <dt><a name="Around_line_57:" 
    252 < >Around line 57:</a></dt> 
    253 < Deleting unknown formatting code U&#60;&#62;Deleting unknown formatting code U&#60;&#62; 
    254 < <dt><a name="Around_line_66:" 
    255 < >Around line 66:</a></dt> 
    256 < Deleting unknown formatting code U&#60;&#62; 
    257 < <dt><a name="Around_line_75:" 
    258 < >Around line 75:</a></dt> 
    259 < Deleting unknown formatting code U&#60;&#62;</dl> 
    260 192c162 
     74162c162 
    26175<               Copyright &copy; 2002-2010, Parrot Foundation. 
    26276--- 
     
    27589--- 
    27690> <p>To install Parrot in a different location, use the <code>&#45;&#45;prefix</code> option to <em><a href="../../../Configure.pl.html">Configure.pl</a></em>:</p> 
    277 84,96d83 
    278 <  
    279 < <h1><a name="POD_ERRORS" 
    280 < >POD ERRORS</a></h1> 
    281 <  
    282 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    283 <  
    284 < <dl> 
    285 < <dt><a name="Around_line_5:" 
    286 < >Around line 5:</a></dt> 
    287 < Deleting unknown formatting code N&#60;&#62;Deleting unknown formatting code U&#60;&#62;Deleting unknown formatting code N&#60;&#62;Deleting unknown formatting code U&#60;&#62;Deleting unknown formatting code U&#60;&#62; 
    288 < <dt><a name="Around_line_48:" 
    289 < >Around line 48:</a></dt> 
    290 < Deleting unknown formatting code N&#60;&#62;</dl> 
    291 100c87 
     9187c87 
    29292<               Copyright &copy; 2002-2010, Parrot Foundation. 
    29393--- 
     
    302102--- 
    303103>                     <a href="../../../../html/index.html">Home</a> &raquo; Basic Syntax 
    304 213,231d212 
    305 <  
    306 < <h1><a name="POD_ERRORS" 
    307 < >POD ERRORS</a></h1> 
    308 <  
    309 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    310 <  
    311 < <dl> 
    312 < <dt><a name="Around_line_5:" 
    313 < >Around line 5:</a></dt> 
    314 < A non&#45;empty Z&#60;&#62; 
    315 < <dt><a name="Around_line_62:" 
    316 < >Around line 62:</a></dt> 
    317 < A non&#45;empty Z&#60;&#62; 
    318 < <dt><a name="Around_line_143:" 
    319 < >Around line 143:</a></dt> 
    320 < Deleting unknown formatting code N&#60;&#62; 
    321 < <dt><a name="Around_line_243:" 
    322 < >Around line 243:</a></dt> 
    323 < Deleting unknown formatting code N&#60;&#62;Deleting unknown formatting code N&#60;&#62;</dl> 
    324 235c216 
     104216c216 
    325105<               Copyright &copy; 2002-2010, Parrot Foundation. 
    326106--- 
     
    13031083>  
    13041084> <p>The name of every variable stored in a particular namespace must be unique. You can&#39;t have store both an <code>Integer</code> PMC and an array PMC both named &#34;bee&#34;, stored in the same namespace.You may wonder why anyone would want to do this. We wonder the same thing, but Perl 5 does it all the time. The Perl 6 implementation on Parrot includes type sigils in the names of the variables it stores in namespaces so each name is unique, e.g. <code>$bee</code>, <code>@bee</code>....</p> 
    1305 1149,1150c1023,1029 
     10851149,1150c1023,1027 
    13061086< X<hierarchical namespaces> 
    13071087< X<namespaces; hierarchy> 
     
    13121092>       INDEX: namespaces; hierarchy 
    13131093> --></p> 
    1314 >  
    1315 > <p>A single global namespace would be far too limiting for most languages or applications. The risk of accidental collisions &#45;&#45; where two libraries try to use the same name for some variable &#45;&#45; would be quite high for larger code bases. Parrot maintains a collection of namespaces arranged as a tree, with the <code>parrot</code> namespace as the root. Every namespace you declare is a child of the <code>parrot</code> namespace (or a child of a child....).</p> 
    1316 1152,1162c1031 
     10941152,1162c1029,1031 
    13171095< A single global namespace would be far too limiting for most languages or 
    13181096< applications. The risk of accidental collisions -- where two libraries try to 
     
    13271105< it again: 
    13281106--- 
     1107> <p>A single global namespace would be far too limiting for most languages or applications. The risk of accidental collisions &#45;&#45; where two libraries try to use the same name for some variable &#45;&#45; would be quite high for larger code bases. Parrot maintains a collection of namespaces arranged as a tree, with the <code>parrot</code> namespace as the root. Every namespace you declare is a child of the <code>parrot</code> namespace (or a child of a child....).</p> 
     1108>  
    13291109> <p>The <code>set_global</code> and <code>get_global</code> opcodes both have alternate forms that take a key name to access a variable in a particular namespace within the tree. This code example stores a variable as <code>bill</code> in the Duck namespace and retrieves it again:</p> 
    133011101166,1168c1035 
     
    13591139--- 
    13601140> <pre>  .namespace [&#34;General&#34;;&#34;Electric&#34;] 
    1361 1185,1186c1051,1052 
     11411185,1191c1051,1052 
    13621142<   set_global "bill", $P0 
    13631143<   $P1 = get_global "bill" 
    1364 --- 
    1365 >   set_global &#34;bill&#34;, $P0 
    1366 >   $P1 = get_global &#34;bill&#34;</pre> 
    1367 1187a1054 
    1368 > <p>Passing an empty key to the <code>.namespace</code> directive resets the selected namespace to the root namespace. The brackets are required even when the key is empty.</p> 
    1369 1189,1191c1056 
     1144<  
     1145<  
    13701146< Passing an empty key to the C<.namespace> directive resets the selected 
    13711147< namespace to the root namespace. The brackets are required even when the 
    13721148< key is empty. 
    13731149--- 
     1150>   set_global &#34;bill&#34;, $P0 
     1151>   $P1 = get_global &#34;bill&#34;</pre> 
     11521193c1054 
     1153<   .namespace [ ] 
     1154--- 
     1155> <p>Passing an empty key to the <code>.namespace</code> directive resets the selected namespace to the root namespace. The brackets are required even when the key is empty.</p> 
     11561194a1056 
    13741157> <pre>  .namespace [ ]</pre> 
    1375 1193,1202c1058,1062 
    1376 <   .namespace [ ] 
    1377 <  
    1378 <  
     11581196,1202c1058,1062 
    13791159< When you need to be absolutely sure you're working with the root namespace 
    13801160< regardless of what namespace is currently active, use the 
     
    15981378--- 
    15991379> <p>Leaving the global variable as an alias for a local variable has its advantages. If you retrieve a stored global into a register and modify it:</p> 
    1600 1329,1346c1174 
     13801329,1330c1174 
    16011381< ... you modify the value of the stored global, so you don't need to call 
    16021382< C<set_global> again. 
    1603 <  
    1604 < <h1><a name="POD_ERRORS" 
    1605 < >POD ERRORS</a></h1> 
    1606 <  
    1607 < <p>Hey! 
    1608 < <b>The above document had some coding errors, 
    1609 < which are explained below:</b></p> 
    1610 <  
    1611 < <dl> 
    1612 < <dt><a name="Around_line_123:" 
    1613 < >Around line 123:</a></dt> 
    1614 < Deleting unknown formatting code G&#60;&#62; 
    1615 < <dt><a name="Around_line_185:" 
    1616 < >Around line 185:</a></dt> 
    1617 < =end PIR_FRAGMENT_INVALID[ doesn&#39;t match =begin PIR_FRAGMENT_INVALID. 
    1618 <  (Stack: =begin PIR_FRAGMENT_INVALID)</dl> 
    16191383--- 
    16201384> <p>... you modify the value of the stored global, so you don&#39;t need to call <code>set_global</code> again.</p> 
    1621 1350c1178 
     13851334c1178 
    16221386<               Copyright &copy; 2002-2010, Parrot Foundation. 
    16231387--- 
     
    16321396--- 
    16331397>                     <a href="../../../../html/index.html">Home</a> &raquo; Control Structures 
    1634 299,308d298 
    1635 <  
    1636 < <h1><a name="POD_ERRORS" 
    1637 < >POD ERRORS</a></h1> 
    1638 <  
    1639 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    1640 <  
    1641 < <dl> 
    1642 < <dt><a name="Around_line_5:" 
    1643 < >Around line 5:</a></dt> 
    1644 < Deleting unknown formatting code N&#60;&#62;</dl> 
    1645 312c302 
     1398302c302 
    16461399<               Copyright &copy; 2002-2010, Parrot Foundation. 
    16471400--- 
     
    16601413--- 
    16611414> --> Native Call Interface (NCI) is a special version of the Parrot calling conventions for calling functions in shared C libraries with a known signature. This is a simplified version of the first test in <em><a href="../../../t/pmc/nci.t.html">t/pmc/nci.t</a></em>:</p> 
    1662 786,807d785 
    1663 <  
    1664 < <h1><a name="POD_ERRORS" 
    1665 < >POD ERRORS</a></h1> 
    1666 <  
    1667 < <p>Hey! <b>The above document had some coding errors, which are explained below:</b></p> 
    1668 <  
    1669 < <dl> 
    1670 < <dt><a name="Around_line_39:" 
    1671 < >Around line 39:</a></dt> 
    1672 < Deleting unknown formatting code N&#60;&#62; 
    1673 < <dt><a name="Around_line_393:" 
    1674 < >Around line 393:</a></dt> 
    1675 < Deleting unknown formatting code N&#60;&#62; 
    1676 < <dt><a name="Around_line_615:" 
    1677 < >Around line 615:</a></dt> 
    1678 < Deleting unknown formatting code N&#60;&#62; 
    1679 < <dt><a name="Around_line_625:" 
    1680 < >Around line 625:</a></dt> 
    1681 < Deleting unknown formatting code N&#60;&#62; 
    1682 < <dt><a name="Around_line_1083:" 
    1683 < >Around line 1083:</a></dt> 
    1684 < Deleting unknown formatting code N&#60;&#62;</dl> 
    1685 811c789 
     1415789c789 
    16861416<               Copyright &copy; 2002-2010, Parrot Foundation. 
    16871417--- 
     
    16961426--- 
    16971427>                     <a href="../../../../html/index.html">Home</a> &raquo; Classes and Objects 
    1698 338,349d337 
    1699 <  
    1700 < <h1><a name="POD_ERRORS" 
    1701 < >POD ERRORS</a></h1> 
    1702 <  
    1703 < <p>Hey! 
    1704 < <b>The above document had some coding errors, 
    1705 < which are explained below:</b></p> 
    1706 <  
    1707 < <dl> 
    1708 < <dt><a name="Around_line_64:" 
    1709 < >Around line 64:</a></dt> 
    1710 < Deleting unknown formatting code N&#60;&#62;</dl> 
    1711 353c341 
     1428341c341 
    17121429<               Copyright &copy; 2002-2010, Parrot Foundation. 
    17131430--- 
     
    17221439--- 
    17231440>                     <a href="../../../../html/index.html">Home</a> &raquo; I/O 
    1724 365,380c365 
    1725 < </pre> 
    1726 < <h1><a name="POD_ERRORS" 
    1727 < >POD ERRORS</a></h1> 
    1728 <  
    1729 < <p>Hey! 
    1730 < <b>The above document had some coding errors, 
    1731 < which are explained below:</b></p> 
    1732 <  
    1733 < <dl> 
    1734 < <dt><a name="Around_line_25:" 
    1735 < >Around line 25:</a></dt> 
    1736 < Deleting unknown formatting code N&#60;&#62; 
    1737 < <dt><a name="Around_line_46:" 
    1738 < >Around line 46:</a></dt> 
    1739 < Deleting unknown formatting code N&#60;&#62;</dl> 
    1740 <             </div> <!-- "mainbody" --> 
    1741 --- 
    1742 > </pre>            </div> <!-- "mainbody" --> 
    1743 383c368 
     1441368c368 
    17441442<               Copyright &copy; 2002-2010, Parrot Foundation. 
    17451443--- 
     
    50094707}}} 
    50104708 
    5011 5003 lines 
     47094701 lines