[Docs] Try fixing the tutorial toctree
Unorphan the old tutorial and reference every page in the index
explicitly. This should hopefully make Sphinx generate correct
hyperlinks now.
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl01.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl01.rst
index 8cf01c8..71ba932 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl01.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl01.rst
@@ -1,5 +1,3 @@
-:orphan:
-
=====================================================
Kaleidoscope: Kaleidoscope Introduction and the Lexer
=====================================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl02.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl02.rst
index dec9f36..c07c3ab 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl02.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl02.rst
@@ -1,5 +1,3 @@
-:orphan:
-
===========================================
Kaleidoscope: Implementing a Parser and AST
===========================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.rst
index 5364b17..9b6df01 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.rst
@@ -1,5 +1,3 @@
-:orphan:
-
========================================
Kaleidoscope: Code generation to LLVM IR
========================================
@@ -198,7 +196,7 @@
suffix. Local value names for instructions are purely optional, but it
makes it much easier to read the IR dumps.
-`LLVM instructions <../../LangRef.html#instruction-reference>`_ are constrained by strict
+:doc:`LLVM instructions <LangRef>` are constrained by strict
rules: for example, the Left and Right operators of an `add
instruction <../../LangRef.html#add-instruction>`_ must have the same type, and the
result type of the add must match the operand types. Because all values
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl04.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl04.rst
index b643ae5..24c2b0f 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl04.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl04.rst
@@ -1,5 +1,3 @@
-:orphan:
-
==============================================
Kaleidoscope: Adding JIT and Optimizer Support
==============================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl05.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl05.rst
index 725423f..11ae79d 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl05.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl05.rst
@@ -1,5 +1,3 @@
-:orphan:
-
==================================================
Kaleidoscope: Extending the Language: Control Flow
==================================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl06.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl06.rst
index a05ed0b..dd3a3f1 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl06.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl06.rst
@@ -1,5 +1,3 @@
-:orphan:
-
============================================================
Kaleidoscope: Extending the Language: User-defined Operators
============================================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl07.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl07.rst
index 14501fd..a30be98 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl07.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl07.rst
@@ -1,5 +1,3 @@
-:orphan:
-
=======================================================
Kaleidoscope: Extending the Language: Mutable Variables
=======================================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl08.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl08.rst
index bd730fe..8277600 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl08.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl08.rst
@@ -1,5 +1,3 @@
-:orphan:
-
========================================
Kaleidoscope: Compiling to Object Code
========================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl09.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl09.rst
index 87584cd..4cdecc3 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl09.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl09.rst
@@ -1,5 +1,3 @@
-:orphan:
-
======================================
Kaleidoscope: Adding Debug Information
======================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl10.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl10.rst
index 6d8a131..dd7d547 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl10.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl10.rst
@@ -1,5 +1,3 @@
-:orphan:
-
======================================================
Kaleidoscope: Conclusion and other useful LLVM tidbits
======================================================
diff --git a/llvm/docs/tutorial/MyFirstLanguageFrontend/index.rst b/llvm/docs/tutorial/MyFirstLanguageFrontend/index.rst
index dcf9d58..e1e477d 100644
--- a/llvm/docs/tutorial/MyFirstLanguageFrontend/index.rst
+++ b/llvm/docs/tutorial/MyFirstLanguageFrontend/index.rst
@@ -2,6 +2,20 @@
My First Language Frontend with LLVM Tutorial
=============================================
+.. toctree::
+ :hidden:
+
+ LangImpl01
+ LangImpl02
+ LangImpl03
+ LangImpl04
+ LangImpl05
+ LangImpl06
+ LangImpl07
+ LangImpl08
+ LangImpl09
+ LangImpl10
+
**Requirements:** This tutorial assumes you know C++, but no previous
compiler experience is necessary.
@@ -46,7 +60,8 @@
One great thing about LLVM is its support for JIT compilation, so
we'll dive right into it and show you the 3 lines it takes to add JIT
support. Later chapters show how to generate .o files.
-- `Chapter #5: Extending the Language: Control Flow <LangImpl05.html>`_ - With the basic language up and running, we show how to extend
+- `Chapter #5: Extending the Language: Control Flow <LangImpl05.html>`_ - With
+ the basic language up and running, we show how to extend
it with control flow operations ('if' statement and a 'for' loop). This
gives us a chance to talk about SSA construction and control
flow.
diff --git a/llvm/docs/tutorial/index.rst b/llvm/docs/tutorial/index.rst
index 1a5277d..8aa4518 100644
--- a/llvm/docs/tutorial/index.rst
+++ b/llvm/docs/tutorial/index.rst
@@ -6,14 +6,13 @@
===============================================
.. toctree::
- :titlesonly:
- :glob:
- :numbered:
+ :hidden:
MyFirstLanguageFrontend/index
-This is the "Kaleidoscope" Language tutorial, showing how to implement a simple
-language using LLVM components in C++.
+:doc:`MyFirstLanguageFrontend/index`
+ This is the "Kaleidoscope" Language tutorial, showing how to implement a simple
+ language using LLVM components in C++.
Kaleidoscope: Implementing a Language with LLVM in Objective Caml
=================================================================