(j3.2006) Choices for typesetting intrinsic function argumens
Thu Feb 22 12:25:36 EST 2007
Dick Hendrickson wrote:
>I'll go for either 3 or 1, probably in that order. 3 looks a little
>better if there is only a one-line argument description.
I'd also vote for 3 as best.
>In a way, it doesn't matter much. IIRC, the final public product
>has no line numbers. So, it's best to choose the version that
>will look best after ISO/NCITS/whomever finishes their merely
>editorial improvements. The 10 or so of use can figure out
>what to do with an occasional missing line number.
Probably more like 100 than 10. As far as I can tell, no one outside
Switzerland ever looks at the actual ISO document. Our final draft gets
read by the folks who actually write the compiler code. Having better
line number coverage aids communication.
>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
>>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.
>> 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.
>>12 ARGUMENT First line of description
>>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.
>>12 ARGUMENT (optional) First line of description
>>13 Second line of description
>>Which do you prefer?
>>J3 mailing list
>>J3 at j3.scs.gmu.edu
>J3 mailing list
>J3 at j3.scs.gmu.edu
Bill Long longb at cray.com
Fortran Technical Support & voice: 651-605-9024
Bioinformatics Software Development fax: 651-605-9142
Cray Inc., 1340 Mendota Heights Rd., Mendota Heights, MN, 55120
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the J3