From a73a67d252678fafc7cfbb8cb0333434b01af01c Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <m@mitchellh.com>
Date: Sun, 5 Oct 2025 19:59:58 -0700
Subject: [PATCH] doxygen improvements

---
 Doxyfile                 |  45 ++++++++++++++++++
 DoxygenLayout.xml        |  28 ++---------
 dist/doxygen/favicon.png | Bin 0 -> 1562 bytes
 dist/doxygen/ghostty.css |  99 +++++++++++++++++++++++++++++++++++++++
 4 files changed, 147 insertions(+), 25 deletions(-)
 create mode 100644 dist/doxygen/favicon.png
 create mode 100644 dist/doxygen/ghostty.css

diff --git a/Doxyfile b/Doxyfile
index fccd4a493..d0c0414dc 100644
--- a/Doxyfile
+++ b/Doxyfile
@@ -2,9 +2,38 @@
 
 DOXYFILE_ENCODING      = UTF-8
 PROJECT_NAME           = "libghostty"
+PROJECT_LOGO           = images/gnome/64.png
 INPUT                  = include/ghostty/vt.h
 INPUT_ENCODING         = UTF-8
 RECURSIVE              = NO
+FULL_PATH_NAMES        = NO
+STRIP_FROM_INC_PATH    = include
+SOURCE_BROWSER         = YES
+INLINE_SOURCES         = NO
+REFERENCES_RELATION    = YES
+REFERENCED_BY_RELATION = YES
+
+#---------------------------------------------------------------------------
+# C API Optimization
+#---------------------------------------------------------------------------
+
+# Optimize output for C API documentation
+OPTIMIZE_OUTPUT_FOR_C  = YES
+TYPEDEF_HIDES_STRUCT   = YES
+HIDE_SCOPE_NAMES       = YES
+
+# Clean path names
+FULL_PATH_NAMES        = NO
+STRIP_FROM_PATH        = .
+STRIP_FROM_INC_PATH    = include
+
+# Hide undocumented and internal APIs
+HIDE_UNDOC_MEMBERS     = YES
+HIDE_UNDOC_CLASSES     = YES
+EXTRACT_ALL            = NO
+INTERNAL_DOCS          = NO
+EXTRACT_PRIVATE        = NO
+EXTRACT_LOCAL_CLASSES  = NO
 
 #---------------------------------------------------------------------------
 # HTML Output
@@ -12,6 +41,21 @@ RECURSIVE              = NO
 
 GENERATE_HTML          = YES
 HTML_OUTPUT            = zig-out/share/ghostty/doc/libghostty
+HTML_EXTRA_STYLESHEET  = dist/doxygen/ghostty.css
+HTML_EXTRA_FILES       = dist/doxygen/favicon.png
+HTML_COLORSTYLE        = DARK
+LAYOUT_FILE            = DoxygenLayout.xml
+GENERATE_TREEVIEW      = YES
+HTML_DYNAMIC_SECTIONS  = YES
+SEARCHENGINE           = YES
+ALPHABETICAL_INDEX     = YES
+HTML_TIMESTAMP         = NO
+
+#---------------------------------------------------------------------------
+# Graphs and Diagrams
+#---------------------------------------------------------------------------
+
+HAVE_DOT               = NO
 
 #---------------------------------------------------------------------------
 # Man Output
@@ -20,6 +64,7 @@ HTML_OUTPUT            = zig-out/share/ghostty/doc/libghostty
 GENERATE_MAN           = YES
 MAN_OUTPUT             = zig-out/share/man
 MAN_EXTENSION          = .3
+MAN_LINKS              = YES
 
 #---------------------------------------------------------------------------
 # Other Output
diff --git a/DoxygenLayout.xml b/DoxygenLayout.xml
index 67497e83f..ae9c52684 100644
--- a/DoxygenLayout.xml
+++ b/DoxygenLayout.xml
@@ -6,37 +6,15 @@
     <tab type="mainpage" visible="yes" title=""/>
     <tab type="pages" visible="yes" title="" intro=""/>
     <tab type="topics" visible="yes" title="" intro=""/>
-    <tab type="modules" visible="yes" title="" intro="">
+    <tab type="modules" visible="yes" title="API Groups" intro="">
       <tab type="modulelist" visible="yes" title="" intro=""/>
       <tab type="modulemembers" visible="yes" title="" intro=""/>
     </tab>
-    <tab type="namespaces" visible="yes" title="">
-      <tab type="namespacelist" visible="yes" title="" intro=""/>
-      <tab type="namespacemembers" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="concepts" visible="yes" title="">
-    </tab>
-    <tab type="interfaces" visible="yes" title="">
-      <tab type="interfacelist" visible="yes" title="" intro=""/>
-      <tab type="interfaceindex" visible="$ALPHABETICAL_INDEX" title=""/>
-      <tab type="interfacehierarchy" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="classes" visible="yes" title="">
-      <tab type="classlist" visible="yes" title="" intro=""/>
-      <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
-      <tab type="hierarchy" visible="yes" title="" intro=""/>
-      <tab type="classmembers" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="structs" visible="yes" title="">
+    <tab type="structs" visible="yes" title="Data Types" intro="">
       <tab type="structlist" visible="yes" title="" intro=""/>
       <tab type="structindex" visible="$ALPHABETICAL_INDEX" title=""/>
     </tab>
-    <tab type="exceptions" visible="yes" title="">
-      <tab type="exceptionlist" visible="yes" title="" intro=""/>
-      <tab type="exceptionindex" visible="$ALPHABETICAL_INDEX" title=""/>
-      <tab type="exceptionhierarchy" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="files" visible="yes" title="">
+    <tab type="files" visible="yes" title="C Headers" intro="">
       <tab type="filelist" visible="yes" title="" intro=""/>
       <tab type="globals" visible="yes" title="" intro=""/>
     </tab>
diff --git a/dist/doxygen/favicon.png b/dist/doxygen/favicon.png
new file mode 100644
index 0000000000000000000000000000000000000000..b647bcf358546e6f9b54c9c423579db9205f2bcc
GIT binary patch
literal 1562
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
M07*qoM6N<$f><fvm;e9(

literal 0
HcmV?d00001

diff --git a/dist/doxygen/ghostty.css b/dist/doxygen/ghostty.css
new file mode 100644
index 000000000..cac21e689
--- /dev/null
+++ b/dist/doxygen/ghostty.css
@@ -0,0 +1,99 @@
+/**
+ * Ghostty Doxygen Custom Stylesheet
+ * Minimal branding customizations for Ghostty colors
+ */
+
+/* Ghostty brand color for links and accents - high contrast for dark bg */
+a, a:link {
+    color: #99B3FF;
+}
+
+a:visited {
+    color: #99B3FF;
+}
+
+a:hover {
+    color: #C2D4FF;
+}
+
+/* High contrast text colors */
+body, div.contents, div.header, .title, .summary, td, th, p, li {
+    color: #E8E8E8 !important;
+}
+
+h1, h2, h3, h4, h5, h6, .groupheader {
+    color: #FFFFFF !important;
+}
+
+.memtitle, .memname {
+    color: #FFFFFF !important;
+}
+
+.memdoc {
+    color: #E8E8E8 !important;
+}
+
+/* Selection color */
+::selection {
+    background: rgba(53, 81, 243, 0.6);
+}
+
+/* Tree view selected item */
+#nav-tree .selected {
+    background-color: #3551F3 !important;
+}
+
+/* Custom syntax highlighting optimized for dark backgrounds with high contrast */
+.fragment, div.line {
+    color: #F0F0F0 !important;
+}
+
+/* Keywords (int, void, const, static, etc.) */
+.keyword, .keywordtype {
+    color: #FF8BE6 !important;
+    font-weight: 500;
+}
+
+/* Control flow (if, else, return, for, while, etc.) */
+.keywordflow {
+    color: #FF8BE6 !important;
+    font-weight: 500;
+}
+
+/* Comments */
+.comment {
+    color: #8BC34A !important;
+    font-style: italic;
+}
+
+/* Preprocessor directives (#include, #define, etc.) */
+.preprocessor {
+    color: #FFCC66 !important;
+}
+
+/* String and character literals */
+.stringliteral, .charliteral {
+    color: #B8E986 !important;
+}
+
+/* Numbers */
+span.charliteral {
+    color: #D4A5FF !important;
+}
+
+/* Function names */
+.functionname {
+    color: #6FE87C !important;
+    font-weight: 500;
+}
+
+/* Line numbers */
+span.lineno {
+    color: #8A8A8A !important;
+    background-color: transparent !important;
+}
+
+span.lineno a {
+    color: #8A8A8A !important;
+    background-color: transparent !important;
+}