[Lldb-commits] [lldb] r158321 - in /lldb/branches/lldb-platform-work: ./ docs/lldb.1

[Johnny Chen]

Author: johnny
Date: Mon Jun 11 14:07:13 2012
New Revision: 158321

URL: http://llvm.org/viewvc/llvm-project?rev=158321&view=rev
Log:
Merge changes from ToT trunk.

Modified:
    lldb/branches/lldb-platform-work/   (props changed)
    lldb/branches/lldb-platform-work/docs/lldb.1

Propchange: lldb/branches/lldb-platform-work/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Mon Jun 11 14:07:13 2012
@@ -1 +1 @@
-/lldb/trunk:154223-158240
+/lldb/trunk:154223-158246

Modified: lldb/branches/lldb-platform-work/docs/lldb.1
URL: http://llvm.org/viewvc/llvm-project/lldb/branches/lldb-platform-work/docs/lldb.1?rev=158321&r1=158320&r2=158321&view=diff
==============================================================================
--- lldb/branches/lldb-platform-work/docs/lldb.1 (original)
+++ lldb/branches/lldb-platform-work/docs/lldb.1 Mon Jun 11 14:07:13 2012
@@ -24,7 +24,9 @@
 .It Fl h, -help 
 Prints out the usage information for the 
 .Nm
-debugger.
+debugger.  The \fB\-\-help\fR text may be more up-to-date and
+authoritative than the command line options described in this man
+page.
 .It Fl v, -version 
 Prints out the version number of the 
 .Nm 
@@ -75,6 +77,37 @@
 so 'lldb -- <filename> [<ARG1> [<ARG2>]]' also works.
 Remember to end the options with "--" if any of your arguments have a "-" in them.)
 .El
+.Sh USING LLDB
+In
+.Nm
+there is a \fBhelp\fR command which can be used to find descriptions and examples of
+all 
+.Nm
+commands.  To get help on "\fBbreakpoint set\fR" you would type "\fBhelp breakpoint set\fR".
+.Pp
+There is also an \fBapropos\fR command which will search the help text of all commands
+for a given term -- this is useful for locating a command by topic.  For instance, "\fBapropos breakpoint\fR"
+will list any command that has the word \fBbreakpoint\fR in its help text.
+.Sh FILES
+.Nm
+will read settings/aliases/commands from three files at startup, if they exist.
+.Pp
+First, it will read a \fB~/.lldbinit-\fIdebugger\fR command file.  If you are using the
+.Nm
+command line interface, this is \fB~/.lldbinit-lldb\fR.  If you are using 
+.Nm
+inside a GUI debugger like
+.Nm Xcode
+this will be \fB~/.lldbinit-Xcode\fR.  This is a useful place to put settings that you
+want to apply only when a given 
+.Nm
+command interpreter is used.
+.Pp
+Second, \fB~/.lldbinit\fR is read.
+.Pp
+Third, an \fR.lldbinit\fR file in the current working directory (where 
+.Nm
+is started) will be read.
 .Sh SEE ALSO
 The LLDB project page http://lldb.llvm.org/ has many different resources for
 .Nm