[flang-commits] [flang] adc8619 - [flang][NFC] Remove unused files from flang documentation (#173369)
via flang-commits
flang-commits at lists.llvm.org
Mon Jan 5 10:06:14 PST 2026
Author: Tarun Prabhu
Date: 2026-01-05T11:06:10-07:00
New Revision: adc8619aafafa097de7c0540dabff19aded199bc
URL: https://github.com/llvm/llvm-project/commit/adc8619aafafa097de7c0540dabff19aded199bc
DIFF: https://github.com/llvm/llvm-project/commit/adc8619aafafa097de7c0540dabff19aded199bc.diff
LOG: [flang][NFC] Remove unused files from flang documentation (#173369)
Remove the _static/, _templates/, and _themes/ directories from
flang/docs.
_static/ contains llvm.css that was never referenced.
_templates/ contains a custom HTML layout that is not used. Flang uses
the
layout provided by the builtin haiku theme from sphinx.
_themes/ contains a custom LLVM theme for sphinx. Flang does not use
this;
it uses the builtin haiku theme from sphinx.
Added:
Modified:
Removed:
flang/docs/_static/llvm.css
flang/docs/_templates/indexsidebar.html
flang/docs/_templates/layout.html
flang/docs/_themes/llvm-theme/layout.html
flang/docs/_themes/llvm-theme/static/contents.png
flang/docs/_themes/llvm-theme/static/llvm-theme.css
flang/docs/_themes/llvm-theme/static/logo.png
flang/docs/_themes/llvm-theme/static/navigation.png
flang/docs/_themes/llvm-theme/theme.conf
################################################################################
diff --git a/flang/docs/_static/llvm.css b/flang/docs/_static/llvm.css
deleted file mode 100644
index 53eeed95c6c0a..0000000000000
--- a/flang/docs/_static/llvm.css
+++ /dev/null
@@ -1,112 +0,0 @@
-/*
- * LLVM documentation style sheet
- */
-
-/* Common styles */
-.body { color: black; background: white; margin: 0 0 0 0 }
-
-/* No borders on image links */
-a:link img, a:visited img { border-style: none }
-
-address img { float: right; width: 88px; height: 31px; }
-address { clear: right; }
-
-table { text-align: center; border: 2px solid black;
- border-collapse: collapse; margin-top: 1em; margin-left: 1em;
- margin-right: 1em; margin-bottom: 1em; }
-tr, td { border: 2px solid gray; padding: 4pt 4pt 2pt 2pt; }
-th { border: 2px solid gray; font-weight: bold; font-size: 105%;
- background: url("lines.gif");
- font-family: "Georgia,Palatino,Times,Roman,SanSerif";
- text-align: center; vertical-align: middle; }
-/*
- * Documentation
- */
-/* Common for title and header */
-.doc_title, .doc_section, .doc_subsection, h1, h2, h3 {
- color: black; background: url("lines.gif");
- font-family: "Georgia,Palatino,Times,Roman,SanSerif"; font-weight: bold;
- border-width: 1px;
- border-style: solid none solid none;
- text-align: center;
- vertical-align: middle;
- padding-left: 8pt;
- padding-top: 1px;
- padding-bottom: 2px
-}
-
-h1, .doc_title, .title { text-align: left; font-size: 25pt }
-
-h2, .doc_section { text-align: center; font-size: 22pt;
- margin: 20pt 0pt 5pt 0pt; }
-
-h3, .doc_subsection { width: 75%;
- text-align: left; font-size: 12pt;
- padding: 4pt 4pt 4pt 4pt;
- margin: 1.5em 0.5em 0.5em 0.5em }
-
-h4, .doc_subsubsection { margin: 2.0em 0.5em 0.5em 0.5em;
- font-weight: bold; font-style: oblique;
- border-bottom: 1px solid #999999; font-size: 12pt;
- width: 75%; }
-
-.doc_author { text-align: left; font-weight: bold; padding-left: 20pt }
-.doc_text { text-align: left; padding-left: 20pt; padding-right: 10pt }
-
-.doc_footer { text-align: left; padding: 0 0 0 0 }
-
-.doc_hilite { color: blue; font-weight: bold; }
-
-.doc_table { text-align: center; width: 90%;
- padding: 1px 1px 1px 1px; border: 1px; }
-
-.doc_warning { color: red; font-weight: bold }
-
-/* <div class="doc_code"> would use this class, and <div> adds more padding */
-.doc_code, .literal-block
- { border: solid 1px gray; background: #eeeeee;
- margin: 0 1em 0 1em;
- padding: 0 1em 0 1em;
- display: table;
- }
-
-blockquote pre {
- padding: 1em 2em 1em 1em;
- border: solid 1px gray;
- background: #eeeeee;
- margin: 0 1em 0 1em;
- display: table;
-}
-
-h2+div, h2+p {text-align: left; padding-left: 20pt; padding-right: 10pt;}
-h3+div, h3+p {text-align: left; padding-left: 20pt; padding-right: 10pt;}
-h4+div, h4+p {text-align: left; padding-left: 20pt; padding-right: 10pt;}
-
-/* It is preferable to use <pre class="doc_code"> everywhere instead of the
- * <div class="doc_code"><pre>...</ptr></div> construct.
- *
- * Once all docs use <pre> for code regions, this style can be merged with the
- * one above, and we can drop the [pre] qualifier.
- */
-pre.doc_code, .literal-block { padding: 1em 2em 1em 1em }
-
-.doc_notes { background: #fafafa; border: 1px solid #cecece;
- display: table; padding: 0 1em 0 .1em }
-
-table.layout { text-align: left; border: none; border-collapse: collapse;
- padding: 4px 4px 4px 4px; }
-tr.layout, td.layout, td.left, td.right
- { border: none; padding: 4pt 4pt 2pt 2pt; vertical-align: top; }
-td.left { text-align: left }
-td.right { text-align: right }
-th.layout { border: none; font-weight: bold; font-size: 105%;
- text-align: center; vertical-align: middle; }
-
-/* Left align table cell */
-.td_left { border: 2px solid gray; text-align: left; }
-
-/* ReST-specific */
-.title { margin-top: 0 }
-.topic-title{ display: none }
-div.contents ul { list-style-type: decimal }
-.toc-backref { color: black; text-decoration: none; }
diff --git a/flang/docs/_templates/indexsidebar.html b/flang/docs/_templates/indexsidebar.html
deleted file mode 100644
index 06b919b8679a6..0000000000000
--- a/flang/docs/_templates/indexsidebar.html
+++ /dev/null
@@ -1,25 +0,0 @@
-{# This template defines sidebar which can be used to provide common links on
- all documentation pages. #}
-
-<h3>Documentation</h3>
-
-<ul class="want-points">
- <li><a href="https://github.com/llvm/llvm-project/blob/main/flang/README.md#getting-started">Getting Started</a></li>
-</ul>
-
-<h3>Getting Involved</h3>
-<! TODO: Point links to website(flang.llvm.org) and not github once webpage comes up.>
-<ul class="want-points">
- <li><a href="https://github.com/llvm/llvm-project/blob/main/flang/docs/GettingInvolved.md#mailing-lists">Mailing Lists</a></li>
- <li><a href="https://github.com/llvm/llvm-project/blob/main/flang/docs/GettingInvolved.md#chat">Slack</a></li>
- <li><a href="https://github.com/llvm/llvm-project/blob/main/flang/docs/GettingInvolved.md#calls">Calls</a></li>
-</ul>
-
-<h3>Additional Links</h3>
-
-<ul class="want-points">
- <li><a href="https://github.com/llvm/llvm-project/tree/main/flang/">Github Repository</a></li>
- <li><a href="https://github.com/llvm/llvm-project/issues">Bug Reports</a></li>
- <li><a href="https://reviews.llvm.org/">Code Review</a></li>
- <li><a href="https://flang.llvm.org/doxygen/">Doxygen API</a></li>
-</ul>
diff --git a/flang/docs/_templates/layout.html b/flang/docs/_templates/layout.html
deleted file mode 100644
index 12b7731ccca7d..0000000000000
--- a/flang/docs/_templates/layout.html
+++ /dev/null
@@ -1,14 +0,0 @@
-{% extends "!layout.html" %}
-
-{% block extrahead %}
-<style type="text/css">
- table.right { float: right; margin-left: 20px; }
- table.right td { border: 1px solid #ccc; }
-</style>
-{% endblock %}
-
-{% block rootrellink %}
-<! TODO: Change the webpage >
- <li><a href="https://flang.llvm.org">Flang Home</a> | </li>
- <li><a href="{{ pathto('index') }}">Documentation</a>»</li>
-{% endblock %}
diff --git a/flang/docs/_themes/llvm-theme/layout.html b/flang/docs/_themes/llvm-theme/layout.html
deleted file mode 100644
index 746c2f56c82ae..0000000000000
--- a/flang/docs/_themes/llvm-theme/layout.html
+++ /dev/null
@@ -1,23 +0,0 @@
-{#
- sphinxdoc/layout.html
- ~~~~~~~~~~~~~~~~~~~~~
-
- Sphinx layout template for the sphinxdoc theme.
-
- :copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS.
- :license: BSD, see LICENSE for details.
-#}
-{% extends "basic/layout.html" %}
-
-{% block relbar1 %}
-<div class="logo">
- <a href="{{ pathto('index') }}">
- <img src="{{pathto("_static/logo.png", 1) }}"
- alt="LLVM Logo" width="250" height="88"/></a>
-</div>
-{{ super() }}
-{% endblock %}
-
-{# put the sidebar before the body #}
-{% block sidebar1 %}{{ sidebar() }}{% endblock %}
-{% block sidebar2 %}{% endblock %}
diff --git a/flang/docs/_themes/llvm-theme/static/contents.png b/flang/docs/_themes/llvm-theme/static/contents.png
deleted file mode 100644
index 7fb82154a1748..0000000000000
Binary files a/flang/docs/_themes/llvm-theme/static/contents.png and /dev/null
diff er
diff --git a/flang/docs/_themes/llvm-theme/static/llvm-theme.css b/flang/docs/_themes/llvm-theme/static/llvm-theme.css
deleted file mode 100644
index 4b04e0cbaccfd..0000000000000
--- a/flang/docs/_themes/llvm-theme/static/llvm-theme.css
+++ /dev/null
@@ -1,371 +0,0 @@
-/*
- * sphinxdoc.css_t
- * ~~~~~~~~~~~~~~~
- *
- * Sphinx stylesheet -- sphinxdoc theme. Originally created by
- * Armin Ronacher for Werkzeug.
- *
- * :copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
- at import url("basic.css");
-
-/* -- page layout ----------------------------------------------------------- */
-
-body {
- font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
- 'Verdana', sans-serif;
- font-size: 14px;
- line-height: 150%;
- text-align: center;
- background-color: #BFD1D4;
- color: black;
- padding: 0;
- border: 1px solid #aaa;
- margin: 0px 80px 0px 80px;
- min-width: 740px;
-}
-
-div.logo {
- background-color: white;
- text-align: left;
- padding: 10px 10px 15px 15px;
-}
-
-div.document {
- background-color: white;
- text-align: left;
- background-image: url(contents.png);
- background-repeat: repeat-x;
-}
-
-div.bodywrapper {
- margin: 0 240px 0 0;
- border-right: 1px solid #ccc;
-}
-
-div.body {
- margin: 0;
- padding: 0.5em 20px 20px 20px;
- max-width: 1000px;
-}
-
-div.related {
- font-size: 1em;
-}
-
-div.related ul {
- background-image: url(navigation.png);
- height: 2em;
- border-top: 1px solid #ddd;
- border-bottom: 1px solid #ddd;
-}
-
-div.related ul li {
- margin: 0;
- padding: 0;
- height: 2em;
- float: left;
-}
-
-div.related ul li.right {
- float: right;
- margin-right: 5px;
-}
-
-div.related ul li a {
- margin: 0;
- padding: 0 5px 0 5px;
- line-height: 1.75em;
- color: #EE9816;
-}
-
-div.related ul li a:hover {
- color: #3CA8E7;
-}
-
-div.sphinxsidebarwrapper {
- padding: 0;
-}
-
-div.sphinxsidebar {
- margin: 0;
- padding: 0.5em 15px 15px 0;
- width: 210px;
- float: right;
- font-size: 1em;
- text-align: left;
-}
-
-div.sphinxsidebar h3, div.sphinxsidebar h4 {
- margin: 1em 0 0.5em 0;
- font-size: 1em;
- padding: 0.1em 0 0.1em 0.5em;
- color: white;
- border: 1px solid #86989B;
- background-color: #AFC1C4;
-}
-
-div.sphinxsidebar h3 a {
- color: white;
-}
-
-div.sphinxsidebar ul {
- padding-left: 1.5em;
- margin-top: 7px;
- padding: 0;
- line-height: 130%;
-}
-
-div.sphinxsidebar ul ul {
- margin-left: 20px;
-}
-
-div.footer {
- background-color: #E3EFF1;
- color: #86989B;
- padding: 3px 8px 3px 0;
- clear: both;
- font-size: 0.8em;
- text-align: right;
-}
-
-div.footer a {
- color: #86989B;
- text-decoration: underline;
-}
-
-/* -- body styles ----------------------------------------------------------- */
-
-p {
- margin: 0.8em 0 0.5em 0;
-}
-
-a {
- color: #CA7900;
- text-decoration: none;
-}
-
-a:hover {
- color: #2491CF;
-}
-
-div.body p a{
- text-decoration: underline;
-}
-
-h1 {
- margin: 0;
- padding: 0.7em 0 0.3em 0;
- font-size: 1.5em;
- color: #11557C;
-}
-
-h2 {
- margin: 1.3em 0 0.2em 0;
- font-size: 1.35em;
- padding: 0;
-}
-
-h3 {
- margin: 1em 0 -0.3em 0;
- font-size: 1.2em;
-}
-
-h3 a:hover {
- text-decoration: underline;
-}
-
-div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.body h6 a {
- color: black!important;
-}
-
-div.body h1,
-div.body h2,
-div.body h3,
-div.body h4,
-div.body h5,
-div.body h6 {
- background-color: #f2f2f2;
- font-weight: normal;
- color: #20435c;
- border-bottom: 1px solid #ccc;
- margin: 20px -20px 10px -20px;
- padding: 3px 0 3px 10px;
-}
-
-div.body h1 { margin-top: 0; font-size: 200%; }
-div.body h2 { font-size: 160%; }
-div.body h3 { font-size: 140%; }
-div.body h4 { font-size: 120%; }
-div.body h5 { font-size: 110%; }
-div.body h6 { font-size: 100%; }
-
-h1 a.anchor, h2 a.anchor, h3 a.anchor, h4 a.anchor, h5 a.anchor, h6 a.anchor {
- display: none;
- margin: 0 0 0 0.3em;
- padding: 0 0.2em 0 0.2em;
- color: #aaa!important;
-}
-
-h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor,
-h5:hover a.anchor, h6:hover a.anchor {
- display: inline;
-}
-
-h1 a.anchor:hover, h2 a.anchor:hover, h3 a.anchor:hover, h4 a.anchor:hover,
-h5 a.anchor:hover, h6 a.anchor:hover {
- color: #777;
- background-color: #eee;
-}
-
-a.headerlink {
- color: #c60f0f!important;
- font-size: 1em;
- margin-left: 6px;
- padding: 0 4px 0 4px;
- text-decoration: none!important;
-}
-
-a.headerlink:hover {
- background-color: #ccc;
- color: white!important;
-}
-
-cite, code, tt {
- font-family: 'Consolas', 'Deja Vu Sans Mono',
- 'Bitstream Vera Sans Mono', monospace;
- font-size: 0.95em;
-}
-
-:not(a.reference) > tt {
- background-color: #f2f2f2;
- border-bottom: 1px solid #ddd;
- color: #333;
-}
-
-tt.descname, tt.descclassname, tt.xref {
- border: 0;
-}
-
-hr {
- border: 1px solid #abc;
- margin: 2em;
-}
-
-p a tt {
- border: 0;
- color: #CA7900;
-}
-
-p a tt:hover {
- color: #2491CF;
-}
-
-a tt {
- border: none;
-}
-
-pre {
- font-family: 'Consolas', 'Deja Vu Sans Mono',
- 'Bitstream Vera Sans Mono', monospace;
- font-size: 0.95em;
- line-height: 120%;
- padding: 0.5em;
- border: 1px solid #ccc;
- background-color: #f8f8f8;
-}
-
-pre a {
- color: inherit;
- text-decoration: underline;
-}
-
-td.linenos pre {
- padding: 0.5em 0;
-}
-
-div.quotebar {
- background-color: #f8f8f8;
- max-width: 250px;
- float: right;
- padding: 2px 7px;
- border: 1px solid #ccc;
-}
-
-div.topic {
- background-color: #f8f8f8;
-}
-
-table {
- border-collapse: collapse;
- margin: 0 -0.5em 0 -0.5em;
-}
-
-table td, table th {
- padding: 0.2em 0.5em 0.2em 0.5em;
-}
-
-div.admonition, div.warning {
- font-size: 0.9em;
- margin: 1em 0 1em 0;
- border: 1px solid #86989B;
- background-color: #f7f7f7;
- padding: 0;
-}
-
-div.admonition p, div.warning p {
- margin: 0.5em 1em 0.5em 1em;
- padding: 0;
-}
-
-div.admonition pre, div.warning pre {
- margin: 0.4em 1em 0.4em 1em;
-}
-
-div.admonition p.admonition-title,
-div.warning p.admonition-title {
- margin: 0;
- padding: 0.1em 0 0.1em 0.5em;
- color: white;
- border-bottom: 1px solid #86989B;
- font-weight: bold;
- background-color: #AFC1C4;
-}
-
-div.warning {
- border: 1px solid #940000;
-}
-
-div.warning p.admonition-title {
- background-color: #CF0000;
- border-bottom-color: #940000;
-}
-
-div.admonition ul, div.admonition ol,
-div.warning ul, div.warning ol {
- margin: 0.1em 0.5em 0.5em 3em;
- padding: 0;
-}
-
-div.versioninfo {
- margin: 1em 0 0 0;
- border: 1px solid #ccc;
- background-color: #DDEAF0;
- padding: 8px;
- line-height: 1.3em;
- font-size: 0.9em;
-}
-
-.viewcode-back {
- font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
- 'Verdana', sans-serif;
-}
-
-div.viewcode-block:target {
- background-color: #f4debf;
- border-top: 1px solid #ac9;
- border-bottom: 1px solid #ac9;
-}
diff --git a/flang/docs/_themes/llvm-theme/static/logo.png b/flang/docs/_themes/llvm-theme/static/logo.png
deleted file mode 100644
index 18d424c53c09a..0000000000000
Binary files a/flang/docs/_themes/llvm-theme/static/logo.png and /dev/null
diff er
diff --git a/flang/docs/_themes/llvm-theme/static/navigation.png b/flang/docs/_themes/llvm-theme/static/navigation.png
deleted file mode 100644
index 1081dc1439fb9..0000000000000
Binary files a/flang/docs/_themes/llvm-theme/static/navigation.png and /dev/null
diff er
diff --git a/flang/docs/_themes/llvm-theme/theme.conf b/flang/docs/_themes/llvm-theme/theme.conf
deleted file mode 100644
index 573fd78aba990..0000000000000
--- a/flang/docs/_themes/llvm-theme/theme.conf
+++ /dev/null
@@ -1,4 +0,0 @@
-[theme]
-inherit = basic
-stylesheet = llvm-theme.css
-pygments_style = friendly
More information about the flang-commits
mailing list