docs/119545: books/arch-handbook/usb/chapter.sgml formatting

Marcin Cieslak saper at SYSTEM.PL
Thu Jan 10 22:20:07 UTC 2008


>Number:         119545
>Category:       docs
>Synopsis:       books/arch-handbook/usb/chapter.sgml formatting
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jan 10 22:20:02 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Marcin Cieslak
>Release:        FreeBSD 7.0-PRERELEASE amd64
>Organization:
>Environment:

System: FreeBSD radziecki.saper.info 7.0-PRERELEASE FreeBSD 7.0-PRERELEASE #7: Sun Jan 6 03:23:21 CET 2008 saper at radziecki.saper.info:/usr/obj/usr/src/sys/VAIO amd64


>Description:

The USB chapter of the Architecture Handbook contains some strange markup:

1) Missing reference [ 2] in  "Access to these registers is provided through a virtualised hub 
	as suggested in the USB specification [ 2]" 
2) In the OCHI chapter: typo 
	"to which aqueue of transfer descriptors"
	should probably be "to which a queue ..."

3) In the OHCI chapter:
  <para>framelist interruptisochronous control bulk</para>

Should this be some form of a graph? 

3) In the "Device Information chapter":

     <para>Level 0 Level 1 Level 2 Slot 0</para>
     <para>Slot 3 Slot 2 Slot 1</para>
     <para>(Only 4 out of 32 slots shown)</para>

Another graphing attempt?

>How-To-Repeat:
>Fix:

Difficult to fix (except for 2) without knowing original author's intent.

>Release-Note:
>Audit-Trail:
>Unformatted:



More information about the freebsd-doc mailing list