(j3.2006) Choices for typesetting intrinsic function argumens
Whitlock, Stan
stan.whitlock
Thu Feb 22 09:26:08 EST 2007
Van,
I agree with John - option 3 best, option 1 ok, option 2 no.
Thanks /Stan
-----Original Message-----
From: j3-bounces at j3.scs.gmu.edu [mailto:j3-bounces at j3.scs.gmu.edu] On
Behalf Of John Reid
Sent: Thursday, February 22, 2007 4:28 AM
To: j3 at j3-fortran.org
Subject: Re: (j3.2006) Choices for typesetting intrinsic function
argumens
Van,
I prefer 3. Option 1 is OK (we've had that for a long time). I dislike
option 2.
John.
W. Van Snyder wrote:
> I have developed three ways of typesetting intrinsic function
arguments
> that have long names and "(optional)" (see EXECUTE_COMMAND_LINE, for
> example).
>
> 1. Set the argument name and "(optional)" as a paragraph and the
> argument description as what LaTeX calls a "minipage". This results
in
> having only one line number, even if the description is several lines.
>
> You get
> ARGUMENT First line of description
> 12 (optional) Second line of description
>
> 2. Set the argument name and "(optional)" as a paragraph that is a
list
> item label, and the argument description as the list item text. If
the
> argument name is long enough that "(optional)" comes on the second
line
> of the paragaph that is the list item label, and the argument
> description takes more than one line, there is a blank line between
the
> first and second line of the description text (adjacent to the
> "(optional)"). But... line numbers work correctly.
>
> You get
> 12 ARGUMENT First line of description
> 13 (optional)
> 14 Second line of description
>
> 3. Set the argument name and "(optional)" as a list item label without
> making it a paragraph, and the argument description as the list item
> text. If the argument name and "(optional)" are wider than the space
> allocated for the list item label, it extends into the description's
> space; the first line of the description is indented so the label and
> description don't clobber each other; subsequent lines begin where
they
> would begin if the argument name were short. Line numbers work
correctly.
>
> You get
> 12 ARGUMENT (optional) First line of description
> 13 Second line of description
>
> Which do you prefer?
>
> Van
>
> _______________________________________________
> J3 mailing list
> J3 at j3.scs.gmu.edu
> http://j3.scs.gmu.edu/mailman/listinfo/j3
_______________________________________________
J3 mailing list
J3 at j3.scs.gmu.edu
http://j3.scs.gmu.edu/mailman/listinfo/j3
More information about the J3
mailing list