Duplicated output upon rebuild

[hidmic]

Rebuilding a package's documentation with rosdoc2 build using the same build and cross-reference directories induces duplication warnings. These warnings go away after nuking said directories.

Should rosdoc2 do some housekeeping before generating output?

[clalancette]

Should rosdoc2 do some housekeeping before generating output?

Yeah, I'd be on board with that. Though we have to be careful to only do that housekeeping on very specific directories; we want users to invoke rosdoc2 several times on different packages to build up a whole database of API documentation.

[aprotyas]

Housekeeping in the sense that if rosdoc2 build --package-path P --build-directory B --cross-reference-directory C were invoked, we'd want to prune B/P and C/P given they exist, right? If so, that sounds reasonable.

[hidmic]

@aprotyas right, that'd be an option. I haven't dug enough to know how much can be reused.

[aprotyas]

Yes, it would be nice to re-use some things. IIRC, the doxygen artifacts (XML tags, etc.) don't get duplicated.