Opened 17 years ago
Closed 13 years ago
#262 closed enhancement (fixed)
doxygen -xml should be created by python bindings build system
| Reported by: | Richard Boulton | Owned by: | Richard Boulton |
|---|---|---|---|
| Priority: | high | Milestone: | 1.3.0 |
| Component: | Xapian-bindings (Python) | Version: | SVN trunk |
| Severity: | normal | Keywords: | |
| Cc: | Blocked By: | ||
| Blocking: | Operating System: | All |
Description
Currently, the doxygen rules for the API documentation in the main build are called with "--xml" to generate xml output as a side effect, and this is later used by the python bindings to generate the documentation comments file.
Instead, it would be much cleaner for the python bindings build system to call doxygen itself, to generate the xml output when it's needed.
Change History (8)
comment:1 by , 16 years ago
comment:2 by , 16 years ago
That sounds like a reasonable approach, if it's going to be merged in the reasonably near future (which it sounds like it might).
comment:3 by , 16 years ago
| Milestone: | → 1.1.1 |
|---|---|
| Type: | task → enhancement |
Sadly I've heard nothing more from the person who wanted to pick up the work on the swig doxygen stuff.
I'm guessing this is probably a fairly easy change, so adding milestone:1.1.1 so we don't fail to remember to consider it. I'm happy to leave it if the effort doesn't seem worthwhile though.
comment:5 by , 15 years ago
| Milestone: | 1.1.7 → 1.2.0 |
|---|
Be nice to clean this up, but it can easily wait.
comment:6 by , 15 years ago
| Priority: | normal → high |
|---|
Richard mentioned wanting to get this done on IRC, and it should be fairly easy, so priority -> high.
comment:7 by , 15 years ago
| Component: | Xapian-bindings → Xapian-bindings (Python) |
|---|
comment:8 by , 13 years ago
| Milestone: | 1.2.x → 1.3.0 |
|---|---|
| Resolution: | → fixed |
| Status: | new → closed |
Or perhaps we just wait for the swig doxygen stuff to get merged and use that?