Comment 5 for bug 1056103

I must agree w/ Tv that keeping the docs build separate helps source users who don't need to deal with all that. Many other projects actually do that ('cd doc; make html') due to substantial additional build deps., and I think I can take some cues from that.

The top Makefile could just include an optional target to descend into doc and build that package, and the separate 'debian' there can be largely or entirely generated from the top level (e.g. symlinked as much as possible).

I'll put something together in a github clone you can look at (later this week).