[llvm] r209173 - Add documentation for llvm-dwarfdump tool

[Alexey Samsonov]

Author: samsonov
Date: Mon May 19 17:53:29 2014
New Revision: 209173

URL: http://llvm.org/viewvc/llvm-project?rev=209173&view=rev
Log:
Add documentation for llvm-dwarfdump tool

Added:
    llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst
Modified:
    llvm/trunk/docs/CommandGuide/index.rst

Modified: llvm/trunk/docs/CommandGuide/index.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CommandGuide/index.rst?rev=209173&r1=209172&r2=209173&view=diff
==============================================================================
--- llvm/trunk/docs/CommandGuide/index.rst (original)
+++ llvm/trunk/docs/CommandGuide/index.rst Mon May 19 17:53:29 2014
@@ -28,6 +28,7 @@ Basic Commands
    llvm-profdata
    llvm-stress
    llvm-symbolizer
+   llvm-dwarfdump
 
 Debugging Tools
 ~~~~~~~~~~~~~~~

Added: llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst?rev=209173&view=auto
==============================================================================
--- llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst (added)
+++ llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst Mon May 19 17:53:29 2014
@@ -0,0 +1,30 @@
+llvm-dwarfdump - print contents of DWARF sections
+=================================================
+
+SYNOPSIS
+--------
+
+:program:`llvm-dwarfdump` [*options*] [*filenames...*]
+
+DESCRIPTION
+-----------
+
+:program:`llvm-dwarfdump` parses DWARF sections in the object files
+and prints their contents in human-readable form.
+
+OPTIONS
+-------
+
+.. option:: -debug-dump=section
+
+  Specify the DWARF section to dump.
+  For example, use ``abbrev`` to dump the contents of ``.debug_abbrev`` section,
+  ``loc.dwo`` to dump the contents of ``.debug_loc.dwo`` etc.
+  See ``llvm-dwarfdump --help`` for the complete list of supported sections.
+  Use ``all`` to dump all DWARF sections. It is the default.
+
+EXIT STATUS
+-----------
+
+:program:`llvm-dwarfdump` returns 0. Other exit codes imply internal
+program error.