From 1c94994c00dbb0099a86d0d397d43cda702cbe3c Mon Sep 17 00:00:00 2001
From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>
Date: Fri, 8 Nov 2024 15:42:41 -0500
Subject: [PATCH] Fix filesystem case sensitivity issue with IQP docs (#13414)

(cherry picked from commit d81abce7690949853135b2a1b507d7e18dcb29ea)
---
 docs/conf.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 69be7f77422..9b28a106b58 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -120,6 +120,14 @@
 napoleon_google_docstring = True
 napoleon_numpy_docstring = False
 
+# Autosummary generates stub filenames based on the import name.
+# Sometimes, two distinct interfaces only differ in capitalization; this
+# creates a problem on case-insensitive OS/filesystems like macOS. So,
+# we manually avoid the clash by renaming one of the files.
+autosummary_filename_map = {
+    "qiskit.circuit.library.iqp": "qiskit.circuit.library.iqp_function",
+}
+
 
 # ----------------------------------------------------------------------------------
 # Doctest