Initial draft of PNaCl bitcode files.

native_client_sdk/src/doc/devguide/devcycle/building.rst

Index: native_client_sdk/src/doc/devguide/devcycle/building.rst
diff --git a/native_client_sdk/src/doc/devguide/devcycle/building.rst b/native_client_sdk/src/doc/devguide/devcycle/building.rst
index 3d94758ec89ec4044c9fec793e766a3cef341f4a..a9af546a52f9ac0b9450a759d0f0b536f159106d 100644
--- a/native_client_sdk/src/doc/devguide/devcycle/building.rst
+++ b/native_client_sdk/src/doc/devguide/devcycle/building.rst
@@ -142,6 +142,8 @@ pnacl-abicheck
   Checks that the **pexe** follows the PNaCl ABI rules.
 pnacl-ar
   Creates archives (i.e., static libraries)
+pnacl-bcdis
+  Objdumper for PNaCl bitcode files.

[Jim Stichnoth, 2014/11/19 21:12:00]

Change to Object dumper?

[Karl, 2014/11/20 17:05:33]

Done.

 pnacl-clang
   C compiler and compiler driver
 pnacl-clang++
@@ -366,6 +368,24 @@ want to configure your web server to gzip **pexe** files: the gzipped version of
 a compressed **pexe** file is smaller than the corresponding uncompressed
 **pexe** file by 7.5% to 10%.
 
+.. _pnacl-bcdis:
+
+Objumping PNaCl Bitcode files

[Jim Stichnoth, 2014/11/19 21:12:00]

Same comment about "objdump".

Also, I think bitcode shouldn't be capitalized, for consistency with the rest of
the section names in this document.  (But note that the bitcode manual document
does consistently capitalize most words in the section names.)

[Karl, 2014/11/20 17:05:33]

Done.

+=============================
+
+Sometimes you may be interesting in the contents of a PNaCl bitcode

[Jim Stichnoth, 2014/11/19 21:12:00]

interested

Reformat with fill-column-80

[Karl, 2014/11/20 17:05:33]

Done.

+file.  The tool ``pnacl-bcdis`` objdumps the contents of a PNaCl

[Karl, 2014/11/20 17:05:33]

Also replaced "objdumps" with "object dumps".

+bitcode file.  For a description of the output produced by this tool,
+see :doc:`/reference/pnacl-bitcode-manual`.
+
+.. naclcode::
+ :prettyprint: 0
+
+  nacl_sdk/pepper_<version>/toolchain/win_pnacl/bin/pnacl-bcdis \
+    hello_world.final.pexe
+
+The output is the corresponding contents of the given **pexe**.
+
 The GNU-based toolchains
 ========================