docs: rename pulse module files to fix doxygen \file name collisions

Prefix all pulse module source files with pulse- to give them unique
basenames, avoiding ambiguous \file suffix matching in doxygen when
identically-named files exist under src/modules/.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Wim Taymans 2026-06-26 12:32:59 +02:00
parent 2a88fb6ae8
commit c4b767cba1
37 changed files with 38 additions and 36 deletions

View file

@ -70,7 +70,8 @@ def main():
res = "\n * ".join(res)
text = text.replace("@pulse_module_options@", res)
if os.path.basename(fn).startswith("module-") and fn.endswith(".c"):
basename = os.path.basename(fn)
if (basename.startswith("module-") or basename.startswith("pulse-module-")) and fn.endswith(".c"):
text = re.sub(r"^ \* ##", r" * #", text, flags=re.M)
print("/** \\privatesection */")

View file

@ -219,7 +219,8 @@ doxygen_env.set('LIBPIPEWIRE_MODULES', '<ul><li>' + '</li><li>'.join(module_manp
pulse_module_manpage_list = []
foreach m : pipewire_module_protocol_pulse_sources
name = fs.stem(fs.name(m))
if m.contains('/modules/') and name.startswith('module-')
if m.contains('/modules/') and (name.startswith('module-') or name.startswith('pulse-module-'))
name = name.replace('pulse-module-', 'module-')
pagepart = name.replace('-', '_')
pulse_module_manpage_list += f'\\ref page_pulse_@pagepart@ "pipewire-pulse-@name@(7)"'
manpages += [[f'pipewire-pulse-@name@.7', f'page_pulse_@pagepart@']]