Fix sphinx warnings

Author: akheron

CHANGES

@@ -10,10 +10,10 @@ Released 2025-03-23
     Bruno Haible for the report and help with fixing.)
 
   - Use David M. Gay's `dtoa()` algorithm to avoid misprinting issues of real
-    numbers that are not exactly representable as a `double` (#680).
+    numbers that are not exactly representable as a ``double`` (#680).
 
-    If this is not desirable, use `./configure --disable-dtoa` or `cmake
-    -DUSE_DTOA=OFF .`
+    If this is not desirable, use ``./configure --disable-dtoa`` or ``cmake
+    -DUSE_DTOA=OFF``.
 
 * Build:
 

doc/apiref.rst

@@ -1088,7 +1088,7 @@ in which case no error information is returned to the caller.
 
    .. versionadded:: 2.11
 
-.. function:: enum json_error_code json_error_code(const json_error_t *error)
+.. c:function:: enum json_error_code json_error_code(const json_error_t *error)
 
    Returns the error code embedded in ``error->text``.
 

doc/conf.py

@@ -70,6 +70,9 @@
 default_role = 'c:func'
 primary_domain = 'c'
 
+# Suppress warnings about enum and function having the same name (valid in C)
+suppress_warnings = ['duplicate_declaration.c']
+
 # If true, '()' will be appended to :func: etc. cross-reference text.
 #add_function_parentheses = True