SAS-2 letter ballot procedure

Elliott, Robert (Server Storage) Elliott at hp.com
Mon Jan 28 17:18:44 PST 2008


* From the T10 Reflector (t10 at t10.org), posted by:
* "Elliott, Robert (Server Storage)" <Elliott at hp.com>
*
Serial Attached SCSI - 2 (SAS-2) revision 14 (sas2r14) is now
undergoing T10 letter ballot, closing Friday 28 March 2008.
The preferred format for letter ballot comments is an Adobe
Acrobat .fdf file.  When you place your vote, email the .fdf
file to lohmeyer at t10.org and elliott at hp.com.
Not a T10 member?
=================
Although joining T10 is encouraged, comments are accepted
|from anyone.  Send them to me and I'll include them in my
own comment set.
Creating an .fdf file
=====================
Historically, only the full version of Adobe Acrobat could
create comments, not Acrobat Reader.  Acrobat 7.0 can create
a .pdf that lets Acrobat Reader 7.0 be used to create comments
as well.  Unfortunately, that format is not readable by earlier
versions of Reader, so it is not the standard released format.
If you want an Acrobat 7.x-formatted version to create
comments with Reader 7.0, send me an email.
Converting .fdf to .txt
=======================
A perl program to generate text versions of Acrobat comments
|from an .fdf file is available on http://www.t10.org/tools.htm.
John Lohmeyer or I will run this for you if needed (the
official letter ballot results file is in .txt format).
Viewing Acrobat comments
========================
The Comments tab on the left leads to a listing of all the
comments (its location differs in different versions of Acrobat).
Comments can be sorted by page, date, author, etc., and filtered,
but those controls tend to cause Acrobat to crash.
Setup
=====
In Edit...Preferences:
- disable "Create new pop-ups aligned to the edge of the document"
- enable "Copy selected text into Highlight, Cross-Out,
    and Underline comment pop-ups"
Comment content
===============
Please don't including the section number and section name in
the comment. That was helpful when the .txt version mattered,
but just adds clutter when working with the .fdf file.
Please don't include page numbers in the comments.
If a comment applies to multiple sections, you can just place
one comment on the first occurrence and include all the other
section numbers in the description.  If it occurs many times
in the document, place it on any (preferably the first)
occurrence and add "Global" to the description rather than
highlight each one.
You don't need to label comments as editorial/technical -
they'll all be addressed.
You don't need to number your comments.
Creating Acrobat comments
=========================
There are several tools with which you can create comments.
1. The highlighting tools
  a) Highlighter tool (yellow)
  b) Cross-Out Text tool (red)
  c) Underline Text tool (green)
These associate a comment with specific words. Acrobat seeds the
comment with the selected text, which you can edit.
Use Highlighter when you're suggesting a change. Format the
comment as:
selected text
s/b   (s/b = should be)
new text
Please don't excerpt 60 words and just change a comma in the
middle - focus on the change.
Use Underline Text if you have overlapping comments; it's an
alternate to the Highlighter tool.
Use Cross-Out Text when you're suggesting deletion. If
the selected text is huge, replace the innards with "..."
If you're trying to select a link (e.g. "(see Table 37)"), select
some text around the link along with the link (if you manage to
comment just the link text itself, then clicking on it will follow
the link rather than open the comment box).
Please don't use the "Text Edits" tools like "Insert Text At Cursor".
2. The drawing markup tools
  a) Rectangle tool
  b) Oval tool
  c) and others
These associate a comment with specific areas on the page.  Use
these to highlight parts of figures or large sections of text.
3. Commenting tools
  a) Note tool (yellow)(Post-It Note)
This creates an arbitrary comment on a page, not associated
with any particular text.
Saving comments
===============
The location of these varies in different Acrobat versions.
Save comments to an .fdf file:
  File/Export/Comments (Acrobat 5)
  Comments/Export Comments/to File (Acrobat 7)
Save the .pdf file with comments:
  File/Save
Not using Acrobat FDF format?
=============================
If you don't have Acrobat and don't obtain the version to add
comments with Reader 7.0, you can provide comments in .txt format.
They must be accompanied by additional text describing where
they apply.
1. Number your company's comments starting with #1.
2. Identify the _PDF_ page number. Acrobat shows page numbers
   like this: "146 (181 of 417)".  Use the number inside the
   parenthesis in comments (e.g., 181).
3. Identify the section number.
4. Identify the figure or table.
5. Identify the paragraph/sentence or row/column to which the
   comment applies.
The text file should look like this:
HP #1
PDF Page 180
7.4.1 CRC Overview
Table 67 - CRC polynomials
Third row
<substance of comment>
HP #2
PDF Page 181
7.4.3 CRC checking
Second paragraph
<substance of comment>
...
--
Rob Elliott, elliott at hp.com
Hewlett-Packard Industry Standard Server Storage Advanced Technology
*
* 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