From bcaee5fea3859630774b77952c5a250c59afe29d Mon Sep 17 00:00:00 2001
From: Ricardo Lafuente <r@manufacturaindependente.org>
Date: Feb 19 2024 15:06:29 +0000
Subject: [PATCH 1/4] Exclude file that was crashing Doxygen


---

diff --git a/doxyfile b/doxyfile
index 76f32d3..147d29c 100644
--- a/doxyfile
+++ b/doxyfile
@@ -917,7 +917,7 @@ RECURSIVE              = YES
 # Note that relative paths are relative to the directory from which doxygen is
 # run.
 
-EXCLUDE                =
+EXCLUDE                = ./tests/benchmark/files/math.js
 
 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
 # directories that are symbolic links (a Unix file system feature) are excluded

From d922279e8ef65559b16c804030fccebb459519f6 Mon Sep 17 00:00:00 2001
From: Ricardo Lafuente <r@manufacturaindependente.org>
Date: Feb 19 2024 15:29:54 +0000
Subject: [PATCH 2/4] Add Doxygen link to wrapper templates, add "make doxygen"


---

diff --git a/website/Makefile b/website/Makefile
index cd54ae4..93dfae9 100644
--- a/website/Makefile
+++ b/website/Makefile
@@ -66,6 +66,10 @@ html: extract
 	# fix translated indexes to address a Pelican bug
 	# cd content/pages; for lang in */; do mv ../../output/$$lang/$$lang/index.html ../../output/$$lang; rm -f ../../output/$$lang/$$lang/index.html; done
 
+doxygen:
+	cd ..; make docs
+	cp -r ../doxygen/html output/doxygen
+
 build: html
 
 clean:
diff --git a/website/theme/templates/page.html b/website/theme/templates/page.html
index df69ee1..1389bce 100644
--- a/website/theme/templates/page.html
+++ b/website/theme/templates/page.html
@@ -32,7 +32,7 @@
   {# source link #}
   {% if page.category == "wrappers" %}
   <div class="source-link">
-  <p><a href="https://pagure.io/JShelter/webextension/blob/main/f/common/wrappingS-{{ page.slug|upper }}.js">See this wrapper's source code for more</a></p>
+    <p>See this wrapper's <a href="/doxygen/wrappingS-{{ page.slug|upper }}_8js.html" target="_blank">technical docs</a> and <a href="https://pagure.io/JShelter/webextension/blob/main/f/common/wrappingS-{{ page.slug|upper }}.js">source code</a> for more.</p>
   </div>
   {% endif %}
 </article>

From 0a9452d5af7c142152a3ed1cb8eeb3a718db2a3e Mon Sep 17 00:00:00 2001
From: Ricardo Lafuente <r@manufacturaindependente.org>
Date: Mar 26 2024 17:31:39 +0000
Subject: [PATCH 3/4] Add doxygen generation to build step


---

diff --git a/website/Makefile b/website/Makefile
index 93dfae9..0c850f2 100644
--- a/website/Makefile
+++ b/website/Makefile
@@ -70,7 +70,7 @@ doxygen:
 	cd ..; make docs
 	cp -r ../doxygen/html output/doxygen
 
-build: html
+build: doxygen html
 
 clean:
 	[ ! -d "$(OUTPUTDIR)" ] || rm -rf "$(OUTPUTDIR)"

From 2a93049be2ea2adf522b5d945691211575875bef Mon Sep 17 00:00:00 2001
From: Ricardo Lafuente <r@manufacturaindependente.org>
Date: Apr 02 2024 14:43:26 +0000
Subject: [PATCH 4/4] Correct mistake in note/see rendering


---

diff --git a/website/extract_comments.py b/website/extract_comments.py
index 55b8a54..c733eb7 100644
--- a/website/extract_comments.py
+++ b/website/extract_comments.py
@@ -68,7 +68,7 @@ def comment_to_md(text):
         if line.startswith("\\note"):
             line = line.replace("\\note", "**Note**: ")
         if line.startswith("\\see"):
-            line = line.replace("\\note", "**See also**: ")
+            line = line.replace("\\see", "**See also**: ")
         if line.startswith("\\bug"):
             line = line.replace("\\bug", "**Known bug**: ")
         newtext += line + "\n"