RstParseOption = enum
  roSkipPounds,               ## skip ``#`` at line beginning (documentation
               ## embedded in Nim comments)
  roSupportSmilies,           ## make the RST parser support smilies like ``:)``
  roSupportRawDirective,      ## support the ``raw`` directive (don't support
                        ## it for sandboxing)
  roSupportMarkdown           ## support additional features of markdown

RstParseOptions = set[RstParseOption]

MsgClass = enum
  mcHint = "Hint", mcWarning = "Warning", mcError = "Error"

MsgKind = enum
  meCannotOpenFile, meExpected, meGridTableNotImplemented, meNewSectionExpected,
  meGeneralParseError, meInvalidDirective, mwRedefinitionOfLabel,
  mwUnknownSubstitution, mwUnsupportedLanguage, mwUnsupportedField

MsgHandler = proc (filename: string; line, col: int; msgKind: MsgKind; arg: string) {...}{.
    closure, gcsafe.}

FindFileHandler = proc (filename: string): string {...}{.closure, gcsafe.}

EParseError = object of ValueError

proc whichMsgClass(k: MsgKind): MsgClass {...}{.raises: [], tags: [].}

proc defaultMsgHandler(filename: string; line, col: int; msgkind: MsgKind; arg: string) {...}{.
    procvar, raises: [ValueError, EParseError, IOError], tags: [WriteIOEffect].}

proc defaultFindFile(filename: string): string {...}{.procvar, raises: [],
    tags: [ReadDirEffect].}

proc addNodes(n: PRstNode): string {...}{.raises: [], tags: [].}

proc rstnodeToRefname(n: PRstNode): string {...}{.raises: [], tags: [].}

proc getFieldValue(n: PRstNode): string {...}{.raises: [], tags: [].}

proc getFieldValue(n: PRstNode; fieldname: string): string {...}{.raises: [], tags: [].}

proc getArgument(n: PRstNode): string {...}{.raises: [], tags: [].}

proc rstParse(text, filename: string; line, column: int; hasToc: var bool;
             options: RstParseOptions; findFile: FindFileHandler = nil;
             msgHandler: MsgHandler = nil): PRstNode {...}{.raises: [Exception],
    tags: [ReadEnvEffect, RootEffect].}