Re: [Xmlunit-general] Documentation

[Stefan B. <bo...@ap...>]

On Fri, 2 Feb 2007, James Abley <jam...@gm...> wrote:

> I guess we need to be explicit about what is required.

My minimal requirements:

* diff-friendly source format - XML or plain text (like TeX) works

* create PDF and HTML from one source

* should be able to format source code properly (or keep the
  formating)

* PDF output should look acceptable

> My belief, although I may be wrong, is that using DocBook would give
> more otions about the target output format. LaTeX lets you target PS
> and thus PDF,

actually LaTeX targets DVI (which means device independent) and there
are several tools for converting DVI to other formats including PS 8-)

> I've also heard that it tends to be quite tightly coupled to the
> presentation layer

That's not my experience, but usually I don't want to tweak the output
it generates anymore.

In the past I've had some unpleasant problems with Docbook (maybe it
was FOP's fault, not Docbook's) and I've nothing but praise for
LaTeX.  So I'm biased, but I could live with Docbook if nobody shares
my preferences 8-)

Maybe we should add

* format should encourage user contributions

Our users are probably more familiar with Docbook and XSLT than TeX.

I'd still need to see what the current state of PDF generated by
Docbook + XSLT + Apache FOP looks like.

Stefan