I guess it depends on the target audience. The Latex Companion is a good
resource because it is written by experienced users, rather than maintainers of
the packages. So I suppose we come to the point of "User Manual" and "Reference
Manual". With all the tools available nowadays (doxygen, docstrip, ...) it is
made easier than ever to make nice manuals.
Regards,
Wilfred
--- On Tue, 31/8/10, Michiel Kamermans <po...@nihongoresources.com> wrote:
From: Michiel Kamermans <po...@nihongoresources.com>
Subject: Re: [XeTeX] XeTeX documentation? (from "Checking if a font exists")
To: "Unicode-based TeX for Mac OS X and other platforms" <xetex@tug.org>
Date: Tuesday, 31 August, 2010, 4:11 PM
Hi Wilfred,
I know the missing-manual problem all too well (I work at a research
lab)...
I agree that it would be better if a developer (or
developing team) releases a proper manual. But indeed the open source
model is such that __anybody__ can write a manual if you really want to.
And I fully appreciate that. But the question was *are* there such
manuals that anyone knows of. Responses in the sympathy of "good luck
finding one" or "write your own!" is equally frustratingly often
encountered, and it's just not useful. After hearing it a million
times, it just makes you want to stab someone in the face for not just
adding a courtesy "I don't know of one, although someone else on the
list/in the group/at the conference might" =)
The problem with "writing your own" is that typically the reason you
need a manual is because you don't know what the thing can do, and
unless someone intimately familiar with it can help you write that
manual, it's not going to be a manual at all. It's going to be a "my
experience with this program, and most of it was just bumbling around
so what I'm telling you cannot even be interpreted as the correct way
to do things". Not a fan of those =D
- Mike
-----Inline Attachment Follows-----
--------------------------------------------------
Subscriptions, Archive, and List information, etc.:
http://tug.org/mailman/listinfo/xetex
--------------------------------------------------
Subscriptions, Archive, and List information, etc.:
http://tug.org/mailman/listinfo/xetex
