From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1NqZ3I-0003QH-2O
	for qemu-devel@nongnu.org; Sat, 13 Mar 2010 16:39:20 -0500
Received: from [199.232.76.173] (port=48843 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1NqZ3H-0003Py-Kr
	for qemu-devel@nongnu.org; Sat, 13 Mar 2010 16:39:19 -0500
Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim
	4.60) (envelope-from <vagrant@freegeek.org>) id 1NqZ3F-0006wE-NA
	for qemu-devel@nongnu.org; Sat, 13 Mar 2010 16:39:19 -0500
Received: from mail.freegeek.org ([67.51.72.37]:53113 helo=george.freegeek.org)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <vagrant@freegeek.org>) id 1NqZ3F-0006uo-CK
	for qemu-devel@nongnu.org; Sat, 13 Mar 2010 16:39:17 -0500
Date: Sat, 13 Mar 2010 13:38:53 -0800
From: Vagrant Cascadian <vagrant@freegeek.org>
Message-ID: <20100313213853.GE8032@claws.fglan>
References: <20100312182633.GC8032@claws.fglan>
	<f43fc5581003130305x73e4866apccef71f5c3e4b739@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <f43fc5581003130305x73e4866apccef71f5c3e4b739@mail.gmail.com>
Subject: [Qemu-devel] manpage errors
List-Id: qemu-devel.nongnu.org
List-Unsubscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/qemu-devel>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: Blue Swirl <blauwirbel@gmail.com>
Cc: qemu-devel@nongnu.org

On Sat, Mar 13, 2010 at 01:05:03PM +0200, Blue Swirl wrote:
> On 3/12/10, Vagrant Cascadian <vagrant@freegeek.org> wrote:
> >  i found this spelling typo and the previous one by running lintian on the qemu
> >  packages i work on for debian:
> >
> >  http://lintian.debian.org/full/pkg-qemu-devel@lists.alioth.debian.org.html#qemu
>
> Perhaps the manual page errors should be fixed too,

i did look into that a bit, though it is a little tricky because it's got the
qemu-doc.texi and qemu-options.texi (texinfo?) layer of abstraction. for the
full details:

  LANG=C MANWIDTH=80 man --warnings -E UTF-8 -l ./qemu.1 >/dev/null
  <standard input>:730: warning [p 9, 4.8i, div `an-div', 0.2i]: can't break line
  <standard input>:730: warning [p 9, 5.0i]: can't break line
  <standard input>:735: warning [p 9, 5.8i, div `an-div', 0.2i]: can't break line
  <standard input>:735: warning [p 9, 6.0i]: can't break line
  <standard input>:869: warning [p 11, 5.2i, div `an-div', 0.2i]: can't break line
  <standard input>:869: warning [p 11, 5.3i]: can't break line
  <standard input>:890: warning [p 11, 8.3i, div `an-div', 0.2i]: can't break line
  <standard input>:890: warning [p 11, 8.5i]: can't break line
  <standard input>:953: warning [p 12, 5.8i, div `an-div', 0.2i]: can't break line
  <standard input>:953: warning [p 12, 6.0i]: can't break line
  <standard input>:1732: warning [p 22, 1.8i, div `an-div', 0.2i]: can't break line
  <standard input>:1732: warning [p 22, 2.0i]: can't break line
  
the generated manpage has several lines longer than 80 characters describing
commandline arguments, such as:

       -smbios
       type=1[,manufacturer=str][,product=str][,version=str][,serial=str][,uuid=uuid][,sku=str][,family=str]
           Specify SMBIOS type 1 fields
...
       -net
       nic[,vlan=n][,macaddr=mac][,model=type][,name=name][,addr=addr][,vectors=v]

and so on...

i don't know if there is a way to more succinctly describe those options that
gets all the details... or an easy way to generate the manpage to fix the
formatting issues with those long lines.

live well,
  vagrant