Merge: Use tagged-fences to discriminate docunits
authorJean Privat <jean@pryen.org>
Fri, 28 Nov 2014 19:51:34 +0000 (14:51 -0500)
committerJean Privat <jean@pryen.org>
Fri, 28 Nov 2014 19:51:34 +0000 (14:51 -0500)
commit5074f0b83d10f85a84e5db4e36d0180c004db48f
treebb12ba0547acef76e5f81b906015669ffbf2e943
parentcabc6962363509c16ca1e0ecb316078b5b7f5d9d
parent3963d712408aecc26d1b609458bed7b124125385
Merge: Use tagged-fences to discriminate docunits

Using heuristics to know what is a docunit and what is a raw block of code is not nice because syntax-errors in docunits happen and we do not want to silence them.

This PR introduces (and documents) the usage of tagged fences to force the programmer to explicit the role of the blocks of code.

By default (with indented block or untagged fences) code blocks are considered docunits to be checked by nitunit.
The tag `nit` does the same.
Any other tag cause docunit to ignore the whole block.

The special tag `nitish` makes docunit ignore the block but allows nitdoc to highlight it.

~~~~
~~~~

Pull-Request: #941
Reviewed-by: Alexandre Terrasa <alexandre@moz-code.org>
lib/poset.nit