SES-2 revision 19 now available and in letter ballot

Elliott, Robert (Server Storage) Elliott at hp.com
Tue Nov 13 16:26:53 PST 2007


* From the T10 Reflector (t10 at t10.org), posted by:
* "Elliott, Robert (Server Storage)" <Elliott at hp.com>
*
SCSI Enclosure Services - 2 (SES-2) revision 19 is now available
on http://www.t10.org/drafts.htm and is in T10 letter ballot,
closing Thursday 13 December 2007.  The project has been open
since May 2002, so it seemed about time to finish it (and begin
SES-3).
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 added 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 ses2r19.pdf is an Acrobat 5.x compatible file.
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.
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
=========================
In Edit...Preferences, turn off "Create new pop-ups aligned to the
edge of the document" and turn on "Copy selected text into Highlight,
Cross-Out, and Underline comment pop-ups."
There are several types of 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 <new text>" (s/b = should be)
Use Cross-Out Text when you're suggesting complete removal. Format the
comment as "remove <selected text>".  If the selected text is huge,
replace the innards with "..."
User Underline Text if you have overlapping comments; it's an alternate
to the Highlighter tool.
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.
Menu items
==========
The location of these varies in different Acrobat versions.
Tools/Comments/Summarize
Creates a new .pdf file in memory containing just 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
===============
Don't bother including the section number and name in the comment
(unlike requested for SAS, SAS-1.1, and SBC-2).
Don't bother including page numbers in the comments - those are
calculated automatically.
If a comment applies to multiple sections, you can just place
one comment on the first occurrence and include all the
section numbers in the description.
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 must be accompanied by additional text
explaining 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.
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