I noticed that in robodoc 4.99.26 commas are no longer accepted in headers, or at least they serve a different purpose now. I have been using commas to separate overloaded C++ functions, and my documentation is no longer valid. For example, I have C++ functions insert(id,atom), insert(id,bond) and insert(id,rotor) in a class and I cannot generate documentation anymore with these headers:
For the latter two cases robodoc 4.99.26 complains that: ``A header with the name "molecule/molecule::insert(id" already exists''.
I have been using robodoc a few years now and commas were allowed in previous versions. For me, having commas in headers is a useful feature as I can document overloaded C++ functions with their true names. Is there any change of getting the old behaviour back?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Will add an option to specify the string to seperate the functions in V4.99.30.
Then with:
--function-list-seperator=","
you will have the old behaviour back.
Have fun,
Frans.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I noticed that in robodoc 4.99.26 commas are no longer accepted in headers, or at least they serve a different purpose now. I have been using commas to separate overloaded C++ functions, and my documentation is no longer valid. For example, I have C++ functions insert(id,atom), insert(id,bond) and insert(id,rotor) in a class and I cannot generate documentation anymore with these headers:
/****f* molecule/molecule::insert(id,atom)
/****f* molecule/molecule::insert(id,bond)
/****f* molecule/molecule::insert(id,rotor)
For the latter two cases robodoc 4.99.26 complains that: ``A header with the name "molecule/molecule::insert(id" already exists''.
I have been using robodoc a few years now and commas were allowed in previous versions. For me, having commas in headers is a useful feature as I can document overloaded C++ functions with their true names. Is there any change of getting the old behaviour back?
Hi,
That's a clever use of the comma and ROBODoc.
Will add an option to specify the string to seperate the functions in V4.99.30.
Then with:
--function-list-seperator=","
you will have the old behaviour back.
Have fun,
Frans.
Hi
See feature request:
http://sourceforge.net/tracker/index.php?func=detail&aid=1548463&group_id=7245&atid=357245