RPCS3/llvm-mirror
1
0
Fork 0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-23 11:13:28 +01:00
Code Issues Projects Releases Wiki Activity
c48f42e16c
llvm-mirror/docs
History
Sean Silva c48f42e16c docs: Sphinxify docs/tutorial/ 
Sorry for the massive commit, but I just wanted to knock this one down
and it is really straightforward.

There are still a couple trivial (i.e. not related to the content)
things left to fix:

- Use of raw HTML links where :doc:`...` and :ref:`...` could be used
  instead. If you are a newbie and want to help fix this it would make
  for some good bite-sized patches; more experienced developers should
  be focusing on adding new content (to this tutorial or elsewhere, but
  please _do not_ waste your time on formatting when there is such dire
  need for documentation (see docs/SphinxQuickstartTemplate.rst to get
  started writing)).

- Highlighting of the kaleidoscope code blocks (currently left as bare
  `::`).  I will be working on writing a custom Pygments highlighter for
  this, mostly as training for maintaining the `llvm` code-block's lexer
  in-tree. I want to do this because I am extremely unhappy with how it
  just "gives up" on the slightest deviation from the expected syntax
  and leaves the whole code-block un-highlighted.

  More generally I am looking at writing some Sphinx extensions and
  keeping them in-tree as well, to support common use cases that
  currently have no good solution (like "monospace text inside a link").

llvm-svn: 169343
2012-12-05 00:26:32 +00:00
..
_static [docs] Update HTML pages to refer to CSS in a way that works locally and with Sphinx. 2012-04-19 20:20:34 +00:00
_templates [docs] Convert docs index page into Sphinx. 2012-04-19 16:31:37 +00:00
_themes/llvm-theme Sphinx CSS: remove negative letter-spacing, it makes some fonts look really 2012-09-30 20:43:24 +00:00
CommandGuide Update FileCheck's documentation to mention recently added feature of 2012-12-01 22:03:57 +00:00
HistoricalNotes Fix a ton of comment typos found by codespell. Patch by 2011-04-15 05:18:47 +00:00
tutorial docs: Sphinxify docs/tutorial/ 2012-12-05 00:26:32 +00:00
AliasAnalysis.rst RST docs: convert HTML escapes to plain text in code examples. 2012-09-30 20:51:02 +00:00
Atomics.rst Fix a typo (the the => the) 2012-07-23 08:51:15 +00:00
BitCodeFormat.rst Better 80cols... *sigh* 2012-11-20 18:14:15 +00:00
BranchWeightMetadata.rst Sphinxify BranchWeightMetadata document. 2012-06-20 10:17:46 +00:00
Bugpoint.rst Sphyinxify the Bugpoint document. 2012-06-26 11:37:00 +00:00
CMake.rst Removing dependency on third party library for Intel JIT event support. 2012-09-28 17:35:20 +00:00
CodeGenerator.rst Documentation: convert WritingAnLLVMBackend.html to reST 2012-12-01 12:13:48 +00:00
CodingStandards.rst Simplify the coding standards for #include ordering. The ordering is now 2012-12-02 11:53:27 +00:00
CommandLine.rst Sphinxify the CommandLine document. 2012-08-08 08:21:24 +00:00
CompilerWriterInfo.rst Update link to external document 2012-11-12 23:43:34 +00:00
conf.py Bump sphinx config to 3.3. 2012-11-17 22:12:59 +00:00
DebuggingJITedCode.rst Fix Sphinx warnings. 2012-09-20 03:20:53 +00:00
design_and_overview.rst Sphixify the GEP FAQ. 2012-06-20 21:54:22 +00:00
DeveloperPolicy.rst docs: Sphinxify TestingGuide 2012-11-14 21:09:30 +00:00
development_process.rst docs: Sphinxify LLVMBuild documentation. 2012-11-20 03:13:53 +00:00
doxygen.cfg.in Reapply r141657. 2011-10-31 23:46:50 +00:00
doxygen.css [docs] Update Makefile for images removal. 2012-04-20 17:27:12 +00:00
doxygen.footer Happy new year 2012! 2012-01-01 08:16:56 +00:00
doxygen.header Tidy up. s/Low Level Virtual Machine/LLVM/. 2012-01-25 22:00:23 +00:00
doxygen.intro Tidy up. s/Low Level Virtual Machine/LLVM/. 2012-01-25 22:00:23 +00:00
ExceptionHandling.rst Sphinxify the exception handling doc. 2012-06-27 07:20:57 +00:00
ExtendedIntegerResults.txt Revert r103213. It broke several sections of live website. 2010-05-07 00:28:04 +00:00
ExtendingLLVM.rst docs: Propagate fix from r165632 to other docs. 2012-10-10 17:21:39 +00:00
FAQ.rst [docs] Port FAQ over to Sphinx. 2012-06-18 20:21:38 +00:00
GarbageCollection.html Move TargetData to DataLayout. 2012-10-08 16:39:34 +00:00
GetElementPtr.rst Sphixify the GEP FAQ. 2012-06-20 21:54:22 +00:00
GettingStarted.rst docs: [CMake] Add Xcode to the list of project formats CMake can generate. 2012-11-27 23:34:28 +00:00
GettingStartedVS.rst Fix a typo (the the => the) 2012-07-23 08:51:15 +00:00
GoldPlugin.rst GoldPlugin.rst: minor typesetting fixes. 2012-10-05 20:50:05 +00:00
HowToAddABuilder.rst Patch by Sean Silva! 2012-09-13 23:51:08 +00:00
HowToBuildOnARM.rst Minor enhancement to build process notes for ARM platforms. 2012-10-26 12:09:47 +00:00
HowToReleaseLLVM.html Fix some minor typos 2012-07-31 07:05:57 +00:00
HowToSetUpLLVMStyleRTTI.rst docs: Update example to conform to coding standards. 2012-10-12 01:55:51 +00:00
HowToSubmitABug.rst docs: Sphinxify HowToSubmitABug 2012-09-25 20:52:04 +00:00
HowToUseInstrMappings.rst Fix typo. 2012-11-15 21:21:01 +00:00
index.rst docs: Fix typo on front page 2012-10-04 04:41:27 +00:00
LangRef.html Removed redundancy in wording 2012-11-30 23:14:52 +00:00
Lexicon.rst Documentation: Lexicon.rst: add "BB Vectorization" and "TBAA". 2012-10-13 17:34:49 +00:00
LinkTimeOptimization.rst docs: Sphinxify GoldPlugin document. 2012-10-04 03:56:23 +00:00
LLVMBuild.rst docs: Sphinxify LLVMBuild documentation. 2012-11-20 03:13:53 +00:00
LLVMBuild.txt LLVMBuild: Remove trailing newline, which irked me. 2011-12-12 19:48:00 +00:00
mailing_lists.rst [docs] Convert docs index page into Sphinx. 2012-04-19 16:31:37 +00:00
make.bat [docs] Stub out structure for Sphinx-based docs. 2012-04-19 16:31:19 +00:00
Makefile [docs] Remove POD based man page docs (and build system support). 2012-05-08 17:48:21 +00:00
Makefile.sphinx docs: Sphinxify docs/tutorial/ 2012-12-05 00:26:32 +00:00
MakefileGuide.rst docs: Sphinxify TestingGuide 2012-11-14 21:09:30 +00:00
MarkedUpDisassembly.rst Add a bit of documentation on the annotated disassembly output. 2012-10-24 23:30:22 +00:00
Packaging.rst Sphinxify the outdated Packaging documentation. 2012-06-21 06:09:37 +00:00
Passes.html Remove 'sretpromotion' pass from the documentation. This pass is long 2012-11-22 11:17:08 +00:00
Phabricator.rst docs: use code font for console commands in phabricator manual 2012-11-06 15:04:37 +00:00
ProgrammersManual.rst docs: Fix broken link. 2012-12-04 03:45:27 +00:00
programming.rst docs: Convert ProgrammersManual to reST. 2012-12-04 03:20:08 +00:00
Projects.rst docs: Sphinxify TestingGuide 2012-11-14 21:09:30 +00:00
re_format.7 Revert r103213. It broke several sections of live website. 2010-05-07 00:28:04 +00:00
README.txt test commit: verifying access from new address 2012-10-18 18:12:05 +00:00
ReleaseNotes.html Update release notes for NVPTX 2012-12-04 16:11:51 +00:00
SegmentedStacks.rst Sphinxify the SegmentedStack document. 2012-06-20 12:05:05 +00:00
SourceLevelDebugging.rst Some grammar fixes 2012-11-28 00:27:25 +00:00
SphinxQuickstartTemplate.rst docs: Add SphinxQuickstartTemplate.rst. 2012-10-12 00:53:48 +00:00
subsystems.rst Documentation: convert WritingAnLLVMBackend.html to reST 2012-12-01 12:13:48 +00:00
SystemLibrary.rst Documentation: improve formatting and remove unneeded empty lines. 2012-11-28 21:40:54 +00:00
TableGenFundamentals.rst Some sphinx-ing and consistency fixes 2012-11-20 19:37:58 +00:00
TestingGuide.rst Get rid of references to Tcl, DejagGNU, old test structure, discourage the use 2012-12-04 14:34:00 +00:00
TestSuiteMakefileGuide.rst docs: Sphinxify TestSuiteMakefileGuide 2012-11-14 23:11:10 +00:00
userguides.rst docs: Begin Sphinxification of docs/tutorial/ 2012-12-04 21:16:41 +00:00
WritingAnLLVMBackend.rst Documentation: convert WritingAnLLVMBackend.html to reST 2012-12-01 12:13:48 +00:00
WritingAnLLVMPass.html [docs] Update HTML pages to refer to CSS in a way that works locally and with Sphinx. 2012-04-19 20:20:34 +00:00
yaml2obj.rst docs: Fix long-standing typo in yaml2obj.rst. 2012-09-21 19:48:16 +00:00

README.txt 

LLVM Documentation
==================

The LLVM documentation is currently written in two formats:

  * Plain HTML documentation.

  * reStructured Text documentation using the Sphinx documentation generator. It
    is currently tested with Sphinx 1.1.3. 

    For more information, see the "Sphinx Introduction for LLVM Developers"
    document.