maxjhandsome
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Releases Wiki Activity
llvm-project/llvm/docs/design_and_overview.rst

38 lines
885 B
ReStructuredText
Raw Normal View History

[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
.. _design_and_overview:
LLVM Design & Overview
======================
Sphixify the GEP FAQ. llvm-svn: 158858
2012-06-21 05:54:22 +08:00
.. toctree::
:hidden:
docs: Convert LangRef to reST. NOTE: If you have any patches in the works that modify LangRef, you will need to rewrite the changes to LangRef.html to their equivalents in LangRef.rst. If you need assistance feel free to contact me. Since LangRef is mission-critical for the project and "normative", I have taken extra care to ensure that no content was lost or altered in the conversion. The content was converted with a tool called `pandoc`, so there is no chance for a human error like accidentally forgetting a sentence or whatever. After the initial conversion by `pandoc`, only changes to the markup were done. This is just the most literal conversion of the HTML document as possible. It might be worth exploring some way to chop up this massive document into separate pages, e.g. something like `docs/LangRef/Instructions.rst`, `docs/LangRef/Intrinsics.rst`, etc. with `docs/LangRef.rst` being an "intro/navigation page" of sorts. On the other hand, that loses the ability to {Ctrl,Cmd}-F for a given term right from your browser. IMO, I think our stylesheet needs some work because I find it hard to tell what level of nesting some of the headings are at (e.g. "is this a new section or is it a subsection?"). The issue is present on other pages, but the sheer size and deep section structure of LangRef really brings this issue out. If there are any web designers out there in the community it would be awesome if you tried to come up with something nicer. llvm-svn: 169596
2012-12-07 18:36:55 +08:00
LangRef
Sphixify the GEP FAQ. llvm-svn: 158858
2012-06-21 05:54:22 +08:00
GetElementPtr
docs: Convert LangRef to reST. NOTE: If you have any patches in the works that modify LangRef, you will need to rewrite the changes to LangRef.html to their equivalents in LangRef.rst. If you need assistance feel free to contact me. Since LangRef is mission-critical for the project and "normative", I have taken extra care to ensure that no content was lost or altered in the conversion. The content was converted with a tool called `pandoc`, so there is no chance for a human error like accidentally forgetting a sentence or whatever. After the initial conversion by `pandoc`, only changes to the markup were done. This is just the most literal conversion of the HTML document as possible. It might be worth exploring some way to chop up this massive document into separate pages, e.g. something like `docs/LangRef/Instructions.rst`, `docs/LangRef/Intrinsics.rst`, etc. with `docs/LangRef.rst` being an "intro/navigation page" of sorts. On the other hand, that loses the ability to {Ctrl,Cmd}-F for a given term right from your browser. IMO, I think our stylesheet needs some work because I find it hard to tell what level of nesting some of the headings are at (e.g. "is this a new section or is it a subsection?"). The issue is present on other pages, but the sheer size and deep section structure of LangRef really brings this issue out. If there are any web designers out there in the community it would be awesome if you tried to come up with something nicer. llvm-svn: 169596
2012-12-07 18:36:55 +08:00
* :doc:`LangRef`
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
Defines the LLVM intermediate representation.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
* `Introduction to the LLVM Compiler <http://llvm.org/pubs/2008-10-04-ACAT-LLVM-Intro.html>`_
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
Presentation providing a users introduction to LLVM.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
* `Intro to LLVM <http://www.aosabook.org/en/llvm.html>`_
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
Book chapter providing a compiler hacker's introduction to LLVM.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
* `LLVM: A Compilation Framework forLifelong Program Analysis & Transformation
<http://llvm.org/pubs/2004-01-30-CGO-LLVM.html>`_
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
Design overview.
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
* `LLVM: An Infrastructure for Multi-Stage Optimization
<http://llvm.org/pubs/2002-12-LattnerMSThesis.html>`_
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
More details (quite old now).
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Sphixify the GEP FAQ. llvm-svn: 158858
2012-06-21 05:54:22 +08:00
* :ref:`gep`
[docs] Convert docs index page into Sphinx. - Work in progress, this is mostly important because it lets us incrementally migrate the remaining documentation. - Lots of styling, editing, and integration work yet to come… - PR12589 llvm-svn: 155133
2012-04-20 00:31:37 +08:00
Unindent list. llvm-svn: 158804
2012-06-20 17:49:06 +08:00
Answers to some very frequent questions about LLVM's most frequently
misunderstood instruction.