Folks,
On 18 Aug 2007, at 01:34, Tim Jenness wrote:
>>> I've just noticed that all the standalone docs are built as
>>> individual
>>> packages with their own configure.ac and bootstrap files. Is there a
>>> reason for that?
>>
>> I likely asked Norman. There was also the question of the time
>> involved
>> especially dealing with the trickier graphics, and the SGs and SCs
>> were
>> top priority as far as user manuals. I didn't want to do them all at
>> once. In your scheme manuals could readily be added give a
>> Makefile.am
>> and a modification to the package build files.
>
> It all works at the moment and I can continue doing it this way.
> Maybe the complicated ones do need a separate system.
I vaguely remember a discussion on this, but dimly recall that it was
left with different docs packages being largely self-contained, for
the sort of pragmatic resons that Malcolm suggests.
Having said that, I don't recall any particular reasons why the docs
couldn't be handled in the same way as the applications/ or
libraries/ directories.
The only thing which might be worth noting is that the ./bootstrap
files in applications/, libraries/, docs/ and so on are slightly
different from the self-updating bootstrap files in leaf
directories. Not excitingly.
Tim mentioned:
> Yes. I'm assuming a new target, like the postscript one. dvipdfm
> seems to be more robust than dvipdf.
pdflatex would probably be better than either, unless there's some
particular reason why a document has to go via Postscript. The only
reason I can think of is that it uses pstricks. The two problems
with this are that CM fonts can look odd viewed onscreen in a PDF
reader (but they print out OK, and in any case it might be better to
switch the documents to using PS fonts, which look fine), and that
EPS images have to be converted to PDF before being included. I can
probably sort either of these out if it presents any trouble.
See you,
Norman
--
------------------------------------------------------------
Norman Gray : http://nxg.me.uk
eurovotech.org : University of Leicester, UK
|