git: 477e130608 - main - developers-handbook: tweak introduction to lldb

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Mon, 23 Oct 2023 20:11:28 UTC
The branch main has been updated by mhorne:

URL: https://cgit.FreeBSD.org/doc/commit/?id=477e130608b6cb79c689a0bbe4da4afb73401299

commit 477e130608b6cb79c689a0bbe4da4afb73401299
Author:     Mitchell Horne <mhorne@FreeBSD.org>
AuthorDate: 2023-10-23 20:10:46 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2023-10-23 20:11:15 +0000

    developers-handbook: tweak introduction to lldb
    
    All supported versions of FreeBSD ship with lldb, so we no longer need
    to mention FreeBSD version specifics.
    
    While here, make some small tweaks to this text.
    
    Reviewed by:    carlavilla, emaste
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D42333
---
 .../content/en/books/developers-handbook/tools/_index.adoc  | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/documentation/content/en/books/developers-handbook/tools/_index.adoc b/documentation/content/en/books/developers-handbook/tools/_index.adoc
index 038ee19d39..0aa087ceb0 100644
--- a/documentation/content/en/books/developers-handbook/tools/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/tools/_index.adoc
@@ -679,28 +679,25 @@ to the file. Once you have done this, you can type `info` and then select [.guim
 Using a debugger allows running the program under more controlled circumstances.
 Typically, it is possible to step through the program a line at a time, inspect the value of variables, change them, tell the debugger to run up to a certain point and then stop, and so on.
 It is also possible to attach to a program that is already running, or load a core file to investigate why the program crashed.
-It is even possible to debug the kernel, though that is a little trickier than the user applications we will be discussing in this section.
 
 This section is intended to be a quick introduction to using debuggers and does not cover specialized topics such as debugging the kernel.
 For more information about that, refer to crossref:kerneldebug[kerneldebug,Kernel Debugging].
 
-The standard debugger supplied with FreeBSD {rel121-current} is called `lldb` (LLVM debugger).
+The standard debugger supplied with FreeBSD is called `lldb` (LLVM debugger).
 As it is part of the standard installation for that release, there is no need to do anything special to use it.
 It has good command help, accessible via the `help` command, as well as https://lldb.llvm.org/[a web tutorial and documentation].
 
 [NOTE]
 ====
-The `lldb` command is available for FreeBSD {rel113-current} extref:{handbook}ports/[from ports or packages, ports-using] as package:devel/llvm[].
-This will install the default version of lldb (currently 9.0).
+The `lldb` command is also available extref:{handbook}ports/[from ports or packages, ports-using] as package:devel/llvm[].
 ====
 
 The other debugger available with FreeBSD is called `gdb` (GNU debugger).
-Unlike lldb, it is not installed by default on FreeBSD {rel121-current};
+Unlike lldb, it is not installed by default on FreeBSD;
 to use it, extref:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages.
-The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well.
-It has quite good on-line help, as well as a set of info pages.
+It has excellent on-line help, as well as a set of info pages.
 
-Which one to use is largely a matter of taste.
+The two debuggers have a similar feature set, so which one to use is largely a matter of taste.
 If familiar with one only, use that one.
 People familiar with neither or both but wanting to use one from inside Emacs will need to use `gdb` as `lldb` is unsupported by Emacs.
 Otherwise, try both and see which one you prefer.