I'm familiar with your pdfroff and I think it's extremely
interesting, so I definitely didn't mean to trivialize that.
Pdfroff is going to become more and more important because of the
need for publishers to produce sophisticated PDFs with lots of
cross references and internal links for on-line reading and
e-book readers. We've got a series of books that I want to
enhance with pdfroff, but I've gotten stymied by the fact that
the author insists on unstructured subheadings. Instead of a
normal hierarchy (e.g., h1 h2 h2 h1 h2 h3 h3 h1, etc.) she
insists on sticking in subheads wherever she feels like giving
more emphasis to a section. It makes the table of contents look
very messy as well. Sometime soon I will look more closely at
pdfroff to try and work around this.
-- Steve