ISO editorial issue with T10 Style Guide editorial conventions

Paul Suhler Paul.Suhler at Quantum.Com
Sat Jul 5 02:26:18 PDT 2008


* From the T10 Reflector (t10 at t10.org), posted by:
* "Paul Suhler" <Paul.Suhler at Quantum.Com>
*
Ralph,
Rather than using colors for the contents of the list items, you might
want to adopt the standard LISP meaningless words:
a) foo;
b) bar; or
c) baz.
Cheers,
Paul
___________________________________
Paul A. Suhler | Firmware Engineer | Quantum Corporation | Office:
949.856.7748 | paul.suhler at quantum.com
___________________________________
Disregard the Quantum Corporation confidentiality notice below.  The
information contained in this transmission is not confidential.
Permission is hereby explicitly granted to disclose, copy, and further
distribute to any individual(s) or organization(s), without restriction.
-----Original Message-----
From: owner-t10 at t10.org [mailto:owner-t10 at t10.org] On Behalf Of Ralph
Weber
Sent: Friday, July 04, 2008 3:09 PM
To: 't10 at t10.org'
Subject: ISO editorial issue with T10 Style Guide editorial conventions
* From the T10 Reflector (t10 at t10.org), posted by:
* Ralph Weber <roweber at ieee.org>
*
The ISO editor complained about the following text in SAS-1.1 subclause
3.5 (Editorial conventions):
"Lists sequenced by letters (e.g., a) red, b) blue, c) green) show no
ordering relationship between the listed items. Lists sequenced by
numbers (e.g., 1) red, 2) blue, 3) green) show an ordering relationship
between the listed items."
The complaint was phrased as follows:
"Please add the meaning of A), B), C) etc. at the end of the paragraph
"Lists sequenced by letters..." (it is sufficient to Add capital A) in
the examples in 3.4. But what to do the colours mean this is not
explained.)"
The text at issue is a direct quotation from the T10 Style Guide.
In response, I have edited 3.4 as follows:
<begin>
Lists sequenced by lowercase or uppercase letters show no ordering
relationship between the listed items.
EXAMPLE 1 - The following list shows no relationship between the colors
named:
a) red, specifically one of the following colors:
 A) crimson; or
 B) amber;
b) blue; or
c) green.
Lists sequenced by numbers show an ordering relationship between the
listed items.
EXAMPLE 2 - The following list shows the order in which a page is meant
to be read:
1) top;
2) middle; and
3) bottom.
<end>
Based on the new degree of pickiness at ISO, I recommend the T10 Style
Guide be updated to replace the old text with the new.
All the best,
.Ralph
-----------------------------------------------------------
The information contained in this transmission may be 
confidential. Any disclosure, copying, or further 
distribution of confidential information is not permitted 
unless such privilege is explicitly granted in writing by 
Quantum Corporation. Furthermore, Quantum Corporation is not 
responsible for the proper and complete transmission of the 
substance of this communication or for any delay in its 
receipt.
------------------------------------------------------------
*
* For T10 Reflector information, send a message with
* 'info t10' (no quotes) in the message body to majordomo at t10.org



More information about the T10 mailing list