From c5351a0a63f8146a7aa3dc2b5cb6e7d40fe46244 Mon Sep 17 00:00:00 2001 From: Sean Silva Date: Thu, 13 Dec 2012 20:14:25 +0000 Subject: [PATCH] docs: Improve discussion of syntax highlighting. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@170145 91177308-0d34-0410-b5e6-96231b3b80d8 --- docs/SphinxQuickstartTemplate.rst | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/docs/SphinxQuickstartTemplate.rst b/docs/SphinxQuickstartTemplate.rst index 1c03c979f09..b0002bacb96 100644 --- a/docs/SphinxQuickstartTemplate.rst +++ b/docs/SphinxQuickstartTemplate.rst @@ -107,17 +107,32 @@ You can make blocks of code like this: return 0 } -For a shell session, use a ``console`` code block: +For a shell session, use a ``console`` code block (some existing docs use +``bash``): .. code-block:: console $ echo "Goodbye cruel world!" $ rm -rf / -If you need to show LLVM IR use the ``llvm`` code block. Code blocks of ``c``, -``c++``, ``objc``, ``bash``, ``makefile`` kinds are supported. +If you need to show LLVM IR use the ``llvm`` code block. -You can show preformatted text without any syntax highlighting like this: +.. code-block:: llvm + + define i32 @test1() { + entry: + ret i32 0 + } + +Some other common code blocks you might need are ``c``, ``objc``, ``make``, +and ``cmake``. If you need something beyond that, you can look at the `full +list`_ of supported code blocks. + +.. _`full list`: http://pygments.org/docs/lexers/ + +However, don't waste time fiddling with syntax highlighting when you could +be adding meaningful content. When in doubt, show preformatted text +without any syntax highlighting like this: :: @@ -137,8 +152,6 @@ You can show preformatted text without any syntax highlighting like this: .++:.. ... -One can also use a ``none`` code block to turn off highlighting. - Hopefully you won't need to be this deep """""""""""""""""""""""""""""""""""""""" -- 2.34.1