logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

rstcheck - check syntax of reStructuredText files and nested code blocks

Author

rstcheck was written by Steven Myint. This manual page was written by Timo Röhling for Debian and may  be
       reused without restriction.

6.2.4+~1.2.1                                                                                         RSTCHECK(1)

Description

rstcheck  validates  the  syntax of reStructuredText files and can also verify the syntax for a number of
       languages in nested code blocks:

       •      Bash

       •      Doctest

       •      C (C99)

       •      C++ (C++11)

       •      JSON

       •      XML

       •      Python

       •      restructuredTest

Integration With Vim

       You can instruct Syntastic to check .rst files with rstcheck like this:

       let g:syntastic_rst_checkers = ['rstcheck']

       ALE will detect the presence of rstcheck automatically, no additional configuration is required.

Name

       rstcheck - check syntax of reStructuredText files and nested code blocks

Options

--configFILE
              load configuration from FILE.  The configuration is expected in INI file  format  with  a  section
              [rstcheck] and key-value pairs which correspond with command line options.

       -r, --recursive
              Treat input file names as directories and recursively check all .rst files within.

       --reportLEVEL
              restrict  reported  severities  to  LEVEL or higher.  Valid levels in increasing order of severity
              are: info, warning, error, severe.  You can also specify none to suppress all output.

       --ignore-languageLANG, --ignoreLANG
              Ignore code blocks with one of the languages LANG, where LANG is a comma-separated  list  of  code
              block language identifiers. You can also disable language checking with a block comment such as

              .. rstcheck: ignore-language=cpp,python,rst

              near the beginning of the input file.

       --ignore-messages(MSG)
              Ignore  all  messages  that match the regular expression MSG.  Note that you will probably need to
              quote the regex to prevent spurious shell expansion:

              "(Title underline too short.*|Duplicate implicit target.*)"

       --ignore-directivesDIR
              Ignore any rST directives from the comma-separated list DIR.

       --ignore-substitutionsSUB
              Ignore any rST substitutions from the comma-separated list SUB.

       --ignore-rolesROLES
              Ignore any rST roles from the comma-separated list ROLES.

Synopsis

rstcheck [--configFILE] [-r] [--reportLEVEL] [--ignore-languageLANG] [--ignore-messagesMSG]
                [--ignore-directivesDIR] [--ignore-substitutionsSUB] [--ignore-rolesROLES] FILE.rst [FILE.rst...]

See Also