Package: docbook-xsl
Version: 1.75.2+dfsg-5
Severity: normal

Example output in linux-manual-2.6.32
(/usr/share/man/man9/__scsi_device_lookup_by_target.9.gz):

.SH "SYNOPSIS"
.HP \w'struct\ scsi_device\ *\ __scsi_device_lookup_by_target('u
.BI "struct scsi_device * __scsi_device_lookup_by_target(struct\ scsi_target\ 
*\ " "starget" ", uint\ " "lun" ");"

Given a wide enough terminal this renders nicely as:

SYNOPSIS
       struct scsi_device * __scsi_device_lookup_by_target(struct scsi_target * 
starget, uint lun);

but on an 80-column terminal it renders as:

SYNOPSIS
       struct scsi_device *
                                                           __scsi_device_lookup_
by_target(struct scsi_target * starget,
                                                           uint lun);

It seems to me that there should be a break point between the open
parenthesis and the first parameter and that indentation of the
following lines should be limited to about half the output width.

Ben.

-- System Information:
Debian Release: squeeze/sid
  APT prefers proposed-updates
  APT policy: (500, 'proposed-updates'), (500, 'unstable'), (500, 'stable'), 
(1, 'experimental')
Architecture: i386 (x86_64)

Kernel: Linux 2.6.32-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages docbook-xsl depends on:
ii  xml-core                      0.13       XML infrastructure and XML catalog

Versions of packages docbook-xsl recommends:
ii  docbook-xml                   4.5-7      standard XML documentation system 
ii  docbook-xsl-doc-html [docbook 1.75.2-1   stylesheets for processing DocBook

Versions of packages docbook-xsl suggests:
pn  dbtoepub                      <none>     (no description available)
pn  docbook-xsl-saxon             <none>     (no description available)
pn  fop                           <none>     (no description available)
pn  libsaxon-java                 <none>     (no description available)
pn  libxalan2-java                <none>     (no description available)
pn  xalan                         <none>     (no description available)

-- no debconf information



-- 
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
Archive: http://lists.debian.org/20100214154858.6187.7854.report...@localhost

Reply via email to