Fix warnings when generating the cpp programmer's reference

Registered by Kristian B. Ølgaard

When building the cpp part of the programmer's reference we currently get 50 warnings. The warnings are related to the signatures:

overloading 'operator'
operator>>
operator<<
operator--
operator++
operator->

ellipsis in arguments
/home/oelgaard/software/fenics/fenics-doc/source/programmers-reference/cpp/log/log.rst:52: WARNING: Invalid definition: expected name [error at 28]
  void begin(std::string msg, ...)

and passing arrays as arguments
/home/oelgaard/software/fenics/fenics-doc/source/programmers-reference/cpp/ode/ComplexODE.rst:55: WARNING: Invalid definition: expected comma between arguments [error at 22]
  void M(const complex x[], complex y[], const complex z[], real t)

Blueprint information

Status:
Complete
Approver:
None
Priority:
Medium
Drafter:
None
Direction:
Needs approval
Assignee:
None
Definition:
Obsolete
Series goal:
None
Implementation:
Unknown
Milestone target:
None
Completed by
Garth Wells

Related branches

Sprints

Whiteboard

The current warnings are all due to shortcomings in Sphinx and they might disappear in the future.

MER:
The ellipsis issue has been resolved in developmental Sphinx:

Issue 679: cpp:function doesn't parse "..."
https://bitbucket.org/birkenfeld/sphinx/issue/679/cpp-function-doesnt-parse

Georg Brandl / birkenfeld on Sun, 15 May 2011 11:16:41 +0200:

Comment:
  Fixed in <<changeset 00ecba23e7c7>>.

Changes:
  status: new -> resolved

GNW: Confirm that ellipses issue is fixed in Sphinx 1.08.

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.

Subscribers

No subscribers.