SBC-2 now in letter ballot

Elliott, Robert (Server Storage) elliott at hp.com
Fri Jul 23 10:51:21 PDT 2004


* From the T10 Reflector (t10 at t10.org), posted by:
* "Elliott, Robert (Server Storage)" <elliott at hp.com>
*
SCSI Block Commands - 2 (SBC-2) revision 15 is now available 
on http://www.t10.org/drafts.htm and is in T10 letter ballot,
closing Tuesday 24 August 2004.

The preferred format for letter ballot comments is in an 
Adobe Acrobat FDF file (this requires the full version of 
Adobe Acrobat).  Lacking that, text 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.


Viewing Acrobat comments
========================
Windows/Bookmarks and Window/Comments both make the Bookmarks and
Comments tabs visible on the left.  Select the Comments tab, and
all the comments are listed.  They 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 (S with strikeout icon)
  c) Underline tool (U with underline icon)
  (shortcut key U; Shift-U cycles through them)

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 (square icon)
  b) Circle tool (circle icon)
  (shortcut key N; Shift-N cycles through them)

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)(shortcut key S) 

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
==========
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."  If you have perl, you may use
File/Save As... to save this into a .txt file, then run the .txt 
file through the perl program described below to create a text 
file  with numbered comments.

File/Export/Comments
outputs all your comments to an .fdf file.

File/Save
saves the .pdf file with comments.


Comment content
===============
Do not include page numbers in the comments.

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

If the comment is in a table or figure, start with 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.


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>

...


Converting .fdf to .txt
=======================
If you want to generate text versions of Acrobat comments yourself, 
you may use one of the perl programs on http://www.t10.org/tools.htm.
Separate versions are provided for Acrobat 4 and Acrobat 5; I 
haven't tried Acrobat 6 yet.

--
Rob Elliott, elliott at hp.com
Hewlett-Packard Industry Standard Server Storage Advanced Technology
https://ecardfile.com/id/RobElliott
*
* 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