Index: lldb/docs/index.rst =================================================================== --- lldb/docs/index.rst +++ lldb/docs/index.rst @@ -17,20 +17,22 @@ .. _"Apache 2.0 License with LLVM exceptions": https://llvm.org/docs/DeveloperPolicy.html#new-llvm-project-license-framework -Why a New Debugger? -------------------- +Using LLDB +---------- -In order to achieve our goals we decided to start with a fresh architecture -that would support modern multi-threaded programs, handle debugging symbols in -an efficient manner, use compiler based code knowledge and have plug-in support -for functionality and extensions. Additionally we want the debugger -capabilities to be available to other analysis tools, be they scripts or -compiled programs, without requiring them to be GPL. +For an introduction into the LLDB command language, head over to the +:ref:`LLDB Tutorial `. For users already familiar with +other debuggers there is also a cheat sheet listing common tasks and +their LLDB equivalent in the :ref:`GDB to LLDB command map `. + +There are also multiple resources on how to script LLDB using Pythonl +:ref:`Python Reference ` is a great staring +point for that. Compiler Integration Benefits ----------------------------- -LLDB currently converts debug information into clang types so that it can +LLDB converts debug information into Clang types so that it can leverage the clang compiler infrastructure. This allows LLDB to support the latest C, C++, Objective-C and Objective-C++ language features and runtimes in expressions without having to reimplement any of this functionality. It also @@ -132,13 +134,13 @@ use/python-reference use/remote use/troubleshooting - use/architecture .. toctree:: :hidden: :maxdepth: 1 :caption: Development + resources/architecture resources/contributing resources/build resources/test Index: lldb/docs/status/goals.rst =================================================================== --- lldb/docs/status/goals.rst +++ lldb/docs/status/goals.rst @@ -31,3 +31,14 @@ * Great support for C, Objective-C and C++ * Retargetable to support multiple platforms * Provide a base for debugger research and other innovation + +Why a New Debugger? +------------------- + +In order to achieve our goals we decided to start with a fresh architecture +that would support modern multi-threaded programs, handle debugging symbols in +an efficient manner, use compiler based code knowledge and have plug-in support +for functionality and extensions. Additionally we want the debugger +capabilities to be available to other analysis tools, be they scripts or +compiled programs, without requiring them to be GPL. +