[J3] Suggested editorial change

[Daniel C Chen]

Making it Three columns format is definitely an improvement.
Bill's suggestion to use hyperlinks is an even better improvement.
Two separate entries for the same intrinsic name but different argument
list is clearer.

Of course, it is all depending on how much time Editor can spend on this.

Thanks,

Daniel

XL Fortran Development, Fortran Standard Representative
IBM Toronto Software Lab
Phone: 905-413-3056
Tie: 969-3056
Email: cdchen at ca.ibm.com
http://www.ibm.com/software/awdtools/fortran/xlfortran



From:	Malcolm Cohen via J3 <j3 at mailman.j3-fortran.org>
To:	"'General J3 interest list'" <j3 at mailman.j3-fortran.org>
Cc:	Malcolm Cohen <malcolm at nag-j.co.jp>
Date:	2020-07-19 02:48 AM
Subject:	[EXTERNAL] [J3] Suggested editorial change
Sent by:	"J3" <j3-bounces at mailman.j3-fortran.org>



I was just looking at Table 16.1, as one does, and wincing at the ugly
continuation lines sometimes due to a long intrinsic name and other times
due to a long argument list, and wondering if it would look better than
instead of
      Four columns “Procedure”, “Arguments”, “Class”, “Description”
we had
      Three columns “Procedure (arguments)”, “Class”, “Description”

I tried it out just on the SELECTED_whatever_KIND intrinsics, and indeed it
eliminated the ugly continuations, at the (minor?) cost of no longer having
the argument lists all line up.

I’m sure it would not eliminate all continuations, but...

...what do people think? Does this sound like a good idea?

For most entries this is easy – it just takes deleting the first ampersand
on the line, but entries that would still be continued may need a bit of
extra work to make the continuation indented. So maybe an hour or so of
editing time, depending on how fussy I get about the look of the result.

Of course we could go back to the original format if people decide after
seeing it that they don’t like it after all.

Any and all comments welcome.

Cheers,
--
..............Malcolm Cohen, NAG Oxford/Tokyo.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mailman.j3-fortran.org/pipermail/j3/attachments/20200720/bb34fbbb/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: graycol.gif
Type: image/gif
Size: 105 bytes
Desc: not available
URL: <https://mailman.j3-fortran.org/pipermail/j3/attachments/20200720/bb34fbbb/attachment.gif>