SAS-1.1 revision 9 now available and in letter ballot

Elliott, Robert (Server Storage) elliott at hp.com
Tue Mar 22 13:54:03 PST 2005


* From the T10 Reflector (t10 at t10.org), posted by:
* "Elliott, Robert (Server Storage)" <elliott at hp.com>
*
Serial Attached SCSI 1.1 (SAS-1.1) revision 9 is now available 
on http://www.t10.org/drafts.htm and is in T10 letter ballot,
closing Tuesday 19 April 2005.

The preferred format for letter ballot comments is an Adobe 
Acrobat .fdf file.  Lacking that, .txt files are fine.

When you place your vote, email the .fdf and/or .txt files to
lohmeyer at t10.org and elliott at hp.com.

Not a T10 member?
=================
Comments are welcome 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 adds a new
feature allowing a .pdf to be created that lets Acrobat 
Reader 7.0 be used to create comments as well.  Unfortunately,
this only works with Acrobat 7-formatted .pdf files.  The 
standard sas1r07.pdf has an Acrobat 5.x compatible file
format.

If you want an Acrobat 7.x-formatted version of sas1r09.pdf 
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.

Viewing Acrobat comments
========================
There should be a Comments tab on the left which 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.

Creating Acrobat comments
=========================
There are several types of tools with which you can create comments.

1. The text markup tools
  a) Highlight tool (pen icon)
  b) StrikeOut tool (aka Cross-Out)
  c) Underline tool

These associate a comment with specific words. When you use 
these, Acrobat seeds the comment with the selected text, which 
you can then edit.

Use Highlight when you're suggesting a change. Format the comment
as "change <selected text> to <new text>".

Use Strikeout when you're suggesting complete removal. Format the
comment as "remove <selected text>".  

If the selected text is huge, you can 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.

2. The graphic markup tools
  a) Square tool
  b) Circle 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. Post-it notes
  a) Note tool (paper icon) 

This creates an arbitrary comment on a page, not associated 
with any particular text.

Please delete any blank comments (right click on it and select 
Delete) you accidentally create.

Menu items
==========
The location of these varies in different Acrobat versions.

Tools/Spelling/Check Form Fields and Comments
Checks the spelling inside the comments.

Tools/Comments/Summarize
Creates a new .pdf file in memory containing all the comment text.
Always use "Sort By Page."

File/Export/Comments (Acrobat 5)
Comments/Export Comments/to File (Acrobat 7)
Saves comments to an .fdf file.

File/Save
Saves the .pdf file with comments.

Comment content
===============
Please start each comment with the section number and name
(using abbreviations is OK). For example:
    7.4.1 CRC overview
    <substance of comment here>

Do not include page numbers in the comments - those are
calculated automatically.

If the comment is in a table or figure, include both the
section number and the caption:
    7.4.2 CRC generation
    Figure 64 - CRC generator bit order
    <substance of comment here>

If a comment applies to multiple sections, you can just place
one comment on the first occurrence and include all the 
section numbers:
    7.4.1 CRC overview
    7.4.2 CRC generation
    7.4.3 CRC checking
    <substance of comment here>

If a comment is global, place it on any (preferably the first)
occurrence and add "Global":
    7.4.1 CRC overview
    Global
    <substance of comment>

You don't need to label comments as editorial/technical -
they'll all be addressed.

You don't need to number your comments.

Not using FDF format?
=====================
If you don't have Acrobat, your comments are still welcome in 
.txt format.  They need additional text to explain where they
apply, though.

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.
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>

...

*
* 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