🚀 go-pugleaf

In article <1992Sep12.200507.27984@athena.mit.edu>, lasmith@athena.mit.edu (Lones A Smith) writes:
> 
>      I'm sure many novices must share these frustrations:

We'll remind this sentence...

> 1. You have a style file which turns out not to include sufficient or any
>    documentation in it (current example: enumerate.sty ===> how does this
>    work anyway? My guess: \begin{enumerate}[I]  failed).
>    Where do the archives hide the documentation?  (eg. where is
>     enumerate.doc??? ---I don't see it inthe TEX INDEX)

What does this mean: It does not have sufficient or any documentation
in it? enumerate.sty is documented with the doc-option, and it tells
at the very top:

% If you have Mittelbach's doc.sty, this file may be formatted with a
% command like:    latex enumerate.sty
% (You do not need doc.sty to {\em use} this style.)

If you do not have the style, read the comments. 198 comment lines
vs. 55 code lines isn't a ratio too bad, is it? The LaTeX input
should not be too hard to read. The abstract is IMO enough to
understand how to use this style.

> 2. You have style.doc that needs doc.sty.  Where is it? Supposedly
>    at stuttgart.  But WHERE at stuttgart. The file system there resembles
>    a messy desk, and all the obvious heaps don't contain it.

C'mon, get real:
 -- If you connect to Stuttgart and cd to soft/tex, there are two
    directories with LaTeX styles: latex-style-supported and
    latex-style-unsupported. Guess, where it is?
	Right: in latex-style-supported.
 -- And now guess where the doc style is?
	Right: in a subdirectory doc.
 -- And now guess how you do avoid fetching all these files one by one?
	Right: You fetch doc.tar.Z a level above.

And you say that this is too complicated? I can not imagine a more
sensible place than latex-style-supported/doc/.

Let's look at the top again:

>      I'm sure many novices must share these frustrations:

I have frustrations from these kind of questions. Please don't ask
me what I think of folks who are not capable to find a style within
a directory named latex-style-supported; and who are either not able
to read the comments within a style file just because it's LaTeX
input or who think that 2/3rd of a style file isn't documentation
enough...

--
Joachim

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Joachim Schrod			Email: schrod@iti.informatik.th-darmstadt.de
Computer Science Department
Technical University of Darmstadt, Germany

	``How do we persuade new users that spreading fonts across the page
	like peanut butter across hot toast is not necessarily the route to
	typographic excellence?				-- Peter Flynn