docs: use "programmable debugger" description consistently

Replace the old "Scriptable debugger library" and
"Debugger-as-a-library" taglines with the one we're using on GitHub,
"Programmable debugger". Make up for it by emphasizing that drgn can
also be used as a library a tiny bit more in the README.

Signed-off-by: Omar Sandoval <osandov@osandov.com>

README.rst

@@ -38,9 +38,11 @@ scripting in Python. For example, you can debug the Linux kernel:
 Although other debuggers like `GDB <https://www.gnu.org/software/gdb/>`_ have
 scripting support, drgn aims to make scripting as natural as possible so that
 debugging feels like coding. This makes it well-suited for introspecting the
-complex, inter-connected state in large programs. It is also designed as a
+complex, inter-connected state in large programs.
-library that can be used to build debugging and introspection tools; see the
+
-official `tools <https://github.com/osandov/drgn/tree/main/tools>`_.
+Additionally, drgn is designed as a library that can be used to build debugging
+and introspection tools; see the official `tools
+<https://github.com/osandov/drgn/tree/main/tools>`_.
 
 drgn was developed at `Meta <https://opensource.fb.com/>`_ for debugging the
 Linux kernel (as an alternative to the `crash

docs/conf.py

@@ -36,7 +36,7 @@ html_static_path = ["_static"]
 html_theme = "alabaster"
 
 html_theme_options = {
-    "description": "Debugger-as-a-library",
+    "description": "Programmable debugger",
     "logo": "logo.png",
     "logo_name": True,
     "logo_text_align": "center",

drgn/__init__.py

@@ -2,9 +2,9 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """
-Scriptable debugger library
+Programmable debugger
 
-drgn is a scriptable debugger. It is built on top of Python, so if you
+drgn is a programmable debugger. It is built on top of Python, so if you
 don't know at least a little bit of Python, go learn it first.
 
 drgn supports an interactive mode and a script mode. Both are simply a

drgn/internal/cli.py

@@ -75,7 +75,7 @@ def main() -> None:
     python_version = ".".join(str(v) for v in sys.version_info[:3])
     libkdumpfile = f'with{"" if drgn._with_libkdumpfile else "out"} libkdumpfile'
     version = f"drgn {drgn.__version__} (using Python {python_version}, elfutils {drgn._elfutils_version}, {libkdumpfile})"
-    parser = argparse.ArgumentParser(prog="drgn", description="Scriptable debugger")
+    parser = argparse.ArgumentParser(prog="drgn", description="Programmable debugger")
 
     program_group = parser.add_argument_group(
         title="program selection",

libdrgn/drgn.h.in

@@ -25,10 +25,11 @@
 /**
  * @mainpage
  *
- * libdrgn implements the core of <a
+ * libdrgn provides the functionality of the <a
- * href="https://github.com/osandov/drgn">drgn</a>, a debugger-as-a-library. It
+ * href="https://github.com/osandov/drgn">drgn</a> programmable debugger as a
- * implements the main drgn abstractions: @ref Programs, @ref Types, and @ref
+ * library. It implements the main drgn abstractions: @ref Programs, @ref Types,
- * Objects. See <a href="modules.html">Modules</a> for detailed documentation.
+ * and @ref Objects. See <a href="modules.html">Modules</a> for detailed
+ * documentation.
  */
 
 /** Major version of drgn. */

setup.py

@@ -448,7 +448,7 @@ setup(
     python_requires=">=3.6",
     author="Omar Sandoval",
     author_email="osandov@osandov.com",
-    description="Scriptable debugger library",
+    description="Programmable debugger",
     long_description=long_description,
     long_description_content_type="text/x-rst",
     url="https://github.com/osandov/drgn",