File names in include directives in the Nim documentation seem to be relative to the current directory, rather than relative to the including document. For example, doc/manual/exceptions.txt includes exception_hierarchy_fragment.txt, but this is found in the doc directory rather than the doc/manual directory. This does not appear to conform to what ReST specifies at http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment -
The directive argument is the path to the file to be included, relative to the document containing the directive.
I'm not sure if this is an oversight or by design. I'm interested in producing a searchable version of the Nim documentation using the .chm format, and was looking at the possibility of alternative processing of the documentation when I came across this.
I would have thought that it might be helpful for the Nim documentation be processed by other ReST tools as well as what's provided by Nim - would the Nim developers/help writers agree? This would of course require conforming to the ReST specification more closely.
Regards,
Vinay Sajip