PDoc = ref TDocumentor

proc commandBuildIndex(conf: ConfigRef; dir: string; outFile = RelativeFile"") {....raises: [
    OSError, IOError, ValueError, Exception, Exception, ValueError, KeyError,
    OSError, IOError, ERecoverableError], tags: [ReadDirEffect, ReadIOEffect,
    RootEffect, ReadEnvEffect, TimeEffect, WriteIOEffect].}

proc commandDoc(cache: IdentCache; conf: ConfigRef) {....raises: [OSError,
    Exception, ValueError, KeyError, IOError, ERecoverableError], tags: [
    RootEffect, ReadDirEffect, WriteIOEffect, ReadIOEffect, ReadEnvEffect,
    WriteDirEffect, ExecIOEffect, TimeEffect].}

proc commandJson(cache: IdentCache; conf: ConfigRef) {....raises: [Exception,
    ValueError, KeyError, OSError, IOError, ERecoverableError, Exception,
    ValueError, KeyError, OSError, IOError, ERecoverableError], tags: [
    RootEffect, ReadDirEffect, WriteIOEffect, ReadIOEffect, ReadEnvEffect,
    WriteDirEffect].}

proc commandRst2Html(cache: IdentCache; conf: ConfigRef) {....raises: [ValueError,
    OSError, IOError, Exception, KeyError, ERecoverableError], tags: [
    WriteDirEffect, ReadDirEffect, RootEffect, WriteIOEffect, ReadIOEffect,
    ReadEnvEffect, ExecIOEffect, TimeEffect].}

proc commandRst2TeX(cache: IdentCache; conf: ConfigRef) {....raises: [ValueError,
    OSError, IOError, Exception, KeyError, ERecoverableError], tags: [
    WriteDirEffect, ReadDirEffect, RootEffect, WriteIOEffect, ReadIOEffect,
    ReadEnvEffect, ExecIOEffect, TimeEffect].}

proc commandTags(cache: IdentCache; conf: ConfigRef) {....raises: [Exception,
    ValueError, KeyError, OSError, IOError, ERecoverableError, Exception,
    ValueError, KeyError, OSError, IOError, ERecoverableError], tags: [
    RootEffect, ReadDirEffect, WriteIOEffect, ReadIOEffect, ReadEnvEffect,
    WriteDirEffect].}

proc documentRaises(cache: IdentCache; n: PNode) {.
    ...raises: [Exception, KeyError, ValueError], tags: [RootEffect].}

proc finishGenerateDoc(d: var PDoc) {....raises: [Exception, ValueError],
                                      tags: [RootEffect, ReadEnvEffect].}

proc generateDoc(d: PDoc; n, orig: PNode; docFlags: DocFlags = kDefault) {....raises: [
    ValueError, KeyError, Exception, OSError, IOError, ERecoverableError], tags: [
    RootEffect, ReadDirEffect, WriteIOEffect, ReadIOEffect, ReadEnvEffect,
    WriteDirEffect].}

proc generateIndex(d: PDoc) {....raises: [OSError, IOError, Exception, KeyError,
                                       ValueError, ERecoverableError], tags: [
    WriteDirEffect, ReadDirEffect, RootEffect, WriteIOEffect, ReadIOEffect,
    ReadEnvEffect].}

proc generateJson(d: PDoc; n: PNode; includeComments: bool = true) {.
    ...raises: [KeyError, Exception, ValueError], tags: [RootEffect].}

proc generateTags(d: PDoc; n: PNode; r: var string) {.
    ...raises: [KeyError, Exception, ValueError], tags: [RootEffect].}

proc handleDocOutputOptions(conf: ConfigRef) {....raises: [OSError], tags: [].}

proc newDocumentor(filename: AbsoluteFile; cache: IdentCache; conf: ConfigRef;
                   outExt: string = HtmlExt; module: PSym = nil;
                   isPureRst = false): PDoc {....raises: [ValueError, OSError,
    IOError, Exception, KeyError, ERecoverableError], tags: [WriteDirEffect,
    ReadDirEffect, RootEffect, WriteIOEffect, ReadIOEffect, ReadEnvEffect].}

proc presentationPath(conf: ConfigRef; file: AbsoluteFile): RelativeFile {....raises: [
    Exception, KeyError, OSError, ValueError, IOError, ERecoverableError], tags: [
    RootEffect, ReadDirEffect, WriteIOEffect, ReadIOEffect, ReadEnvEffect].}

proc writeOutput(d: PDoc; useWarning = false; groupedToc = false) {....raises: [
    OSError, ValueError, IOError, Exception, KeyError, ERecoverableError,
    Exception, ValueError, KeyError, OSError, IOError, ERecoverableError], tags: [
    ReadEnvEffect, ReadIOEffect, WriteIOEffect, ReadDirEffect, ExecIOEffect,
    RootEffect, TimeEffect, WriteDirEffect].}

proc writeOutputJson(d: PDoc; useWarning = false) {....raises: [OSError,
    ValueError, IOError, Exception, KeyError, ERecoverableError], tags: [
    ReadEnvEffect, ReadIOEffect, WriteIOEffect, ReadDirEffect, ExecIOEffect,
    RootEffect].}