[llvm-commits] CVS: llvm/docs/BytecodeFormat.html

[Reid Spencer]

Changes in directory llvm/docs:

BytecodeFormat.html updated: 1.24 -> 1.25
---
Log message:

Correct the documentation for the module block header which uses the long
format instead of the short format used in other blocks. 

Discrepancy noted by Robert Mykland. Thanks Robert!


---
Diffs of the changes:  (+23 -5)

Index: llvm/docs/BytecodeFormat.html
diff -u llvm/docs/BytecodeFormat.html:1.24 llvm/docs/BytecodeFormat.html:1.25
--- llvm/docs/BytecodeFormat.html:1.24	Tue Aug  3 15:57:56 2004
+++ llvm/docs/BytecodeFormat.html	Mon Aug 16 14:24:36 2004
@@ -614,10 +614,13 @@
       <th class="td_left"><b>Field Description</b></th>
     </tr>
     <tr>
-      <td><a href="#block">block</a><br>
-      </td>
-      <td class="td_left">Module Block Identifier (0x01) and Size<br>
-      </td>
+      <td><a href="#unsigned">unsigned</a><br></td>
+      <td class="td_left"><a href="#mod_header">Module Block Identifier
+          (0x01)</a></td>
+    </tr>
+    <tr>
+      <td><a href="#unsigned">unsigned</a></td>
+      <td class="td_left"><a href="#mod_header">Module Block Size</a></td>
     </tr>
     <tr>
       <td><a href="#uint32_vbr">uint32_vbr</a></td>
@@ -646,6 +649,21 @@
   </tbody>
 </table>
 </div>
+
+<!-- _______________________________________________________________________ -->
+<div class="doc_subsubsection"><a name="mod_header">Module Block Header</a></div>
+<div class="doc_text">
+  <p>The block header for the module block uses a longer format than the other
+  blocks in a bytecode file. Specifically, instead of encoding the type and size
+  of the block into a 32-bit integer with 5-bits for type and 27-bits for size,
+  the module block header uses two 32-bit unsigned values, one for type, and one
+  for size. While the 2<sup>27</sup> byte limit on block size is sufficient for the blocks
+  contained in the module, it isn't sufficient for the module block itself
+  because we want to ensure that bytecode files as large as 2<sup>32</sup> bytes
+  are possible. For this reason, the module block (and only the module block)
+  uses a long format header.</p>
+</div>
+
 <!-- _______________________________________________________________________ -->
 <div class="doc_subsubsection"><a name="format">Format Information</a></div>
 <div class="doc_text">
@@ -1630,7 +1648,7 @@
 <a href="mailto:rspencer at x10sys.com">Reid Spencer</a> and <a
  href="mailto:sabre at nondot.org">Chris Lattner</a><br>
 <a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a><br>
-Last modified: $Date: 2004/08/03 20:57:56 $
+Last modified: $Date: 2004/08/16 19:24:36 $
 </address>
 <!-- vim: sw=2
 -->