Subject: bug#72464: [PATCH 1/2] Document how set path to C source code for SUSE based systems

From: Björn Bidar <[email-masked]>
Date: Sun, 4 Aug 2024 16:09:36 +0300

* etc/PROBLEMS(Problems when reading or debugging Emacs C code):
Document how to install Emacs C source and how to set path it for SUSE
based distributions such as openSUSE and SUSE Linux Enterprise.
---
 etc/PROBLEMS | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index c1ad8321fa6..ef205da2c17 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -456,6 +456,25 @@ However, the exact directory name will depend on the system, and you
 will need to both upgrade source and debug info when your system
 upgrades or patches Emacs, and change your startup file accordingly.
 
+** SUSE based distributions (openSUSE, SUSE Linux Enterprise)
+
+On systems with distributions, you can install source and debug info
+via superuser commands like the following:
+
+    # Install Emacs source and debuginfo by using --plus-content
+    zypper --plus-content debug,source install emacs-debuginfo emacs-debugsource
+
+To get describe-function and similar commands to work, you can then
+add something like the following to your startup file:
+
+    (setq find-function-C-source-directory
+          (car (file-expand-wildcards "/usr/src/debug/emacs-*/src")))
+
+The line above should work for all systems using zypper besides SUSE
+based ones, however it could be that you have to adjust the path to
+the sources slightly depending on the version of the distribution you
+have installed.
+
 ** Source and debuginfo for other systems
 
 If your system follows neither the Debian nor the Red Hat patterns,
-- 
2.45.2