1[/ 2 Copyright 2002,2004,2006 Joel de Guzman, Eric Niebler 3 Copyright 2010-2011 Daniel James 4 5 Distributed under the Boost Software License, Version 1.0. 6 (See accompanying file LICENSE_1_0.txt or copy at 7 http://www.boost.org/LICENSE_1_0.txt) 8] 9 10[chapter Syntax Summary 11 [quickbook 1.6] 12 [compatibility-mode 1.5] 13 [id quickbook.syntax] 14 [source-mode teletype] 15] 16 17A QuickBook document is composed of one or more blocks. An example of 18a block is the paragraph or a C++ code snippet. Some blocks have 19special mark-ups. Blocks, except code snippets which have their own 20grammar (C++ or Python), are composed of one or more phrases. A phrase 21can be a simple contiguous run of characters. Phrases can have special 22mark-ups. Marked up phrases can recursively contain other phrases, but 23cannot contain blocks. A terminal is a self contained block-level or 24phrase-level element that does not nest anything. 25 26Blocks, in general, are delimited by two end-of-lines (the block terminator). 27Phrases in each block cannot contain a block terminator. This way, syntax errors 28such as un-matched closing brackets do not go haywire and corrupt anything past 29a single block. 30 31[#quickbook.ref.comments] 32[section:comments Comments] 33 34Can be placed anywhere. 35 36``` 37[/ comment (no output generated) ] 38``` 39 40[/ for testing only... ] 41 42``` 43[/ comments can be nested [/ some more here] ] 44``` 45 46[/ for testing [/ only ] ] 47 48``` 49[/ Quickbook blocks can nest inside comments. [*Comment this out too!] ] 50``` 51 52[/ for testing [*only ] ] 53 54[endsect:comments] 55