SAT revision 8 now available and in letter ballot

Sheffield, Robert L robert.l.sheffield at intel.com
Wed Jan 18 10:30:58 PST 2006


* From the T10 Reflector (t10 at t10.org), posted by:
* "Sheffield, Robert L" <robert.l.sheffield at intel.com>
*
This is a multi-part message in MIME format.

------_=_NextPart_001_01C61C5D.53BA609C
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

SCSI/ATA Translation (SAT) revision 08 is now available on
http://www.t10.org/drafts.htm (or
ftp://ftp.t10.org/t10/drafts/sat/sat-r08.pdf).
SAT-r08 is in T10 letter ballot, closing Friday 17 February 2006 at noon
MST.
The preferred format for letter ballot comments is an Adobe=20
Acrobat .fdf file. Lacking that, .txt files are fine.=20
When you place your vote, email the .fdf and/or .txt files to=20
lohmeyer at t10.org and Robert.L.Sheffield at intel.com.=20
Not a T10 member?=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=20
Comments are welcome from anyone. Send them to me and I'll=20
include them in my own comment set.=20
Creating an .fdf file=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=20
Historically, only the full version of Adobe Acrobat could=20
create comments, not Acrobat Reader. Acrobat 7.0 adds a new=20
feature allowing a .pdf to be created that lets Acrobat=20
Reader 7.0 be used to create comments as well. Unfortunately,=20
this only works with Acrobat 7-formatted .pdf files. The=20
standard sas1r07.pdf has an Acrobat 5.x compatible file=20
format.=20
If you want an Acrobat 7.x-formatted version of SAT-r08.pdf=20
to create comments with Reader 7.0, send me an email.=20
Converting .fdf to .txt=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=20
A perl program to generate text versions of Acrobat comments=20
|from an .fdf file is available on http://www.t10.org/tools.htm.=20
John Lohmeyer or I will run this for you if needed.=20
Viewing Acrobat comments=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =

There should be a Comments tab on the left which leads to=20
a listing of all the comments (its location differs in different=20
versions of Acrobat). Comments can be sorted by page, date,=20
author, etc.=20
Creating Acrobat comments=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=20
There are several types of tools with which you can create comments.=20
1. The text markup tools=20
a) Highlight tool (pen icon)=20
b) StrikeOut tool (aka Cross-Out)=20
c) Underline tool=20
These associate a comment with specific words. When you use=20
these, Acrobat seeds the comment with the selected text, which=20
you can then edit.=20
Use Highlight when you're suggesting a change. Format the comment=20
as "change <selected text> to <new text>".=20
Use Strikeout when you're suggesting complete removal. Format the=20
comment as "remove <selected text>".=20
If the selected text is huge, you can replace the innards with "..."=20
If you're trying to select a link (e.g. "(see Table 37)"), select=20
some text around the link along with the link. If you manage to=20
comment just the link text itself, then clicking on it will follow=20
the link rather than open the comment box.=20
2. The graphic markup tools=20
a) Square tool=20
b) Circle tool=20
c) and others=20
These associate a comment with specific areas on the page. Use=20
these to highlight parts of figures or large sections of text.=20
3. Post-it notes=20
a) Note tool (paper icon)=20
This creates an arbitrary comment on a page, not associated=20
with any particular text.=20
Please delete any blank comments (right click on it and select=20
Delete) you accidentally create.=20
Menu items=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=20
The location of these varies in different Acrobat versions.=20
Tools/Spelling/Check Form Fields and Comments=20
Checks the spelling inside the comments.=20
Tools/Comments/Summarize=20
Creates a new .pdf file in memory containing all the comment text.=20
Always use "Sort By Page."=20
File/Export/Comments (Acrobat 5)=20
Comments/Export Comments/to File (Acrobat 7)=20
Saves comments to an .fdf file.=20
File/Save=20
Saves the .pdf file with comments.=20
Comment content=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=20
Please start each comment with the section number and name=20
(using abbreviations is OK). For example:=20
7.4.1 CRC overview=20
<substance of comment here>=20
Do not include page numbers in the comments - those are=20
calculated automatically.=20
If the comment is in a table or figure, include both the=20
section number and the caption:=20
	8.2.2 PC (page control) field=20
	Table 10 - PC field values=20
	<substance of comment here>=20
If a comment applies to multiple sections, you can just place=20
one comment on the first occurrence and include all the=20
section numbers:=20
	8.2.1 LOG SENSE command overview=20
	8.2.2 PC (page control) field=20
	8.2.3 PAGE CODE field=20
	<substance of comment here>=20
If a comment is global, place it on any (preferably the first)=20
occurrence and add "Global":=20
	8.2.2 PC (page control) field=20
	Global=20
	<substance of comment>=20
You don't need to label comments as editorial/technical -=20
they'll all be addressed.=20
You don't need to number your comments.=20
Not using FDF format?=20
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=20
If you don't have Acrobat, your comments are still welcome in=20
.txt format. They need additional text to explain where they=20
apply, though.=20
1. Number your company's comments starting with #1.=20
2. Identify the _PDF page number_. Acrobat shows page numbers=20
like this: "146 (181 of 417)". Use the number inside the=20
parenthesis in comments.=20
3. Identify the section number.=20
4. Identify the figure or table.=20
5. Identify the paragraph/sentence or row/column to which the=20
comment applies.=20
The text file should look like this:=20
Intel #1=20
PDF Page 50=20
8.2.1 LOG SENSE command overview=20
Table 10 - PC field values=20
Third row=20
<substance of comment>=20
Inte #2=20
PDF Page 51=20
8.3.1 MODE SELECT (6) command overview=20
Second paragraph=20
<substance of comment>=20
...=20




------_=_NextPart_001_01C61C5D.53BA609C
Content-Type: text/html;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">

 SAT revision 8 now available and in letter ballot SCSI/ATA Translation (SAT) = revision 08 is now available on
 (or ). 
SAT-r08 is in T10 letter = ballot, closing Friday 17 February 2006 at noon MST. 
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 = Robert.L.Sheffield at intel.com. = 
Not a T10 member?
 
Comments are welcome from = anyone. Send them to me and I'llinclude them in my own = comment set. 
Creating an .fdf = file
 
New">=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 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 SAT-r08.pdf
 to create comments with Reader 7.0, = send me an email.=20 
Converting .fdf to = .txt
 
New">=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= 
A perl program to generate = text versions of Acrobat commentsfrom an .fdf file is = available on .
 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 commentas ;change <selected = text> to <new text>;.Use Strikeout when you're = suggesting complete removal. Format thecomment as ;remove = <selected text>;.=20 
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);), selectsome 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)=20 
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. 
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: 8.2.2 PC (page control) = field
 Table 10 - PC field = values
 <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: 8.2.1 LOG SENSE command = overview
 8.2.2 PC (page control) = field
 8.2.3 PAGE CODE = field
 <substance of comment = here> If a comment is global, place it = on any (preferably the first)
 occurrence and add = ;Global;: 8.2.2 PC (page control) = field
 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 numberslike 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 thecomment applies. 
The text file should look like = this: 
Intel #1
 PDF Page 50
 8.2.1 LOG SENSE command = overview
 Table 10 - PC field = values
 Third row
 <substance of = comment> 
Inte #2
 PDF Page 51
 8.3.1 MODE SELECT (6) command = overview
 Second paragraph
 <substance of = comment> 
...... 


------_=_NextPart_001_01C61C5D.53BA609C--
*
* 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