Ticket #263 (new defect)
Opened 7 months ago
python doccomments only show information for one overloaded form
| Reported by: | richard | Owned by: | richard |
|---|---|---|---|
| Priority: | normal | Milestone: | 1.1.0 |
| Component: | Other | Version: | SVN trunk |
| Severity: | minor | Keywords: | |
| Cc: | Blocked By: | ||
| Operating System: | All | Blocking: |
Description
If a function or method in the C++ headers has documentation comments for multiple overloaded forms, the documentation comments extracted by doxygen and doxy2swig.py only contain the text from the final one of these forms.
Either: doxy2swig.py should combine the comments for all the possible overloaded forms, or we should provide manually written overrides for all cases where these forms exist.
If the latter option is chose, doxy2swig.py should complain if any overloaded forms exist for which there are multiple comments but no manual override.
This can lead to users getting confused (the comment for open_remote is particular confusing, since it only mentions the progsrv backend), and it would be nice to tidy this up for 1.1.0, so marking for that milestone for now. I'm not desperately worried if it slips, though.
