vovkos / doxyrest

A compiler from Doxygen XML to reStructuredText -- hence, the name. It parses XML databases generated by Doxygen and produces reStructuredText for the Python documentation generator Sphinx.
MIT License
306 stars 23 forks source link

Strange Error with Frame files #35

Closed HaoZeke closed 4 years ago

HaoZeke commented 4 years ago

For the following input file:

-- Specify input and output paths:

OUTPUT_FILE = "out/rst-dir/index.rst"
INPUT_FILE = "../Doxygen/gen_docs/xml/index.xml"
FRAME_FILE = "index.rst.in"
FRAME_DIR_LIST = { "frame/cfamily", "frame/common" }

-- Usually, Doxygen-based documentation has a main page (created with
-- the \mainpage directive). If that's the case, force-include
-- the contents of 'page_index.rst' into 'index.rst':

INTRO_FILE = "page_index.rst"

-- If your documentation uses \verbatim directives for code snippets
-- you can convert those to reStructuredText C++ code-blocks:

VERBATIM_TO_CODE_BLOCK = "cpp"

-- Asterisks, pipes and trailing underscores have special meaning in
-- reStructuredText. If they appear in Doxy-comments anywhere except
-- for code-blocks, they must be escaped:

ESCAPE_ASTERISKS = true
ESCAPE_PIPES = true
ESCAPE_TRAILING_UNDERSCORES = true

I seem to be getting a strange error:

$HOME/Git/Github/Symengine/symengine.github.io/docs/Doxygen/gen_docs/xml/classSymEngine_1_1fmpq__wrapper.xml(154): warning: duplicate member id classSymEngine_1_1fmpq__wrapper_1a38105679da131581df519d2ebb680a6a (function: fmpq_wrapper)
  replacing old member as it has no documentation
$HOME/Git/Github/Symengine/symengine.github.io/docs/Doxygen/gen_docs/xml/classSymEngine_1_1fmpz__wrapper.xml(47): warning: duplicate member id classSymEngine_1_1fmpz__wrapper_1a9cd19b867e2842bb3d60d55d63b2097b (function: fmpz_wrapper)
  replacing old member as it has no documentation
$HOME/Git/Github/Symengine/symengine.github.io/docs/Doxygen/gen_docs/xml/cwrapper_8cpp.xml(713): warning: duplicate member id cwrapper_8cpp_1a87c58cfe167897f7fed2477f8f35a2ea (define: SYMENGINE_INCLUDE_ALL)
  replacing old member as it has no documentation
$HOME/Git/Github/Symengine/symengine.github.io/docs/Doxygen/gen_docs/xml/cwrapper_8cpp.xml(723): warning: duplicate member id cwrapper_8cpp_1a0f1932316136059674ea58fa58109920 (define: SYMENGINE_ENUM)
  replacing old member as it has no documentation
$HOME/Git/Github/Symengine/symengine.github.io/docs/Doxygen/gen_docs/xml/visitor_8h.xml(616): warning: duplicate member id visitor_8h_1a4806471ed102e83b9d860be0f80fdc07 (define: SYMENGINE_ENUM)
  replacing old member as it has no documentation
error: frame file 'index.rst.in' not found

My version is doxyrest v2.1.0 (amd64).

HaoZeke commented 4 years ago

My bad, wrong file-paths.