From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NqksR-0006t7-6t for qemu-devel@nongnu.org; Sun, 14 Mar 2010 06:16:55 -0400 Received: from [199.232.76.173] (port=58188 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NqksN-0006q9-Rk for qemu-devel@nongnu.org; Sun, 14 Mar 2010 06:16:51 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1NqksK-0006Gu-O3 for qemu-devel@nongnu.org; Sun, 14 Mar 2010 06:16:51 -0400 Received: from mx20.gnu.org ([199.232.41.8]:17069) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1NqksK-0006Cz-Ds for qemu-devel@nongnu.org; Sun, 14 Mar 2010 06:16:48 -0400 Received: from mail-pw0-f45.google.com ([209.85.160.45]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NqkqM-0002yy-Br for qemu-devel@nongnu.org; Sun, 14 Mar 2010 06:14:46 -0400 Received: by pwi9 with SMTP id 9so1385386pwi.4 for ; Sun, 14 Mar 2010 03:14:12 -0700 (PDT) MIME-Version: 1.0 In-Reply-To: <20100313213853.GE8032@claws.fglan> References: <20100312182633.GC8032@claws.fglan> <20100313213853.GE8032@claws.fglan> Date: Sun, 14 Mar 2010 12:14:12 +0200 Message-ID: From: Blue Swirl Content-Type: multipart/mixed; boundary=00032555547ea8b3620481c006b1 Subject: [Qemu-devel] Re: manpage errors List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Vagrant Cascadian Cc: qemu-devel@nongnu.org --00032555547ea8b3620481c006b1 Content-Type: text/plain; charset=UTF-8 On 3/13/10, Vagrant Cascadian wrote: > On Sat, Mar 13, 2010 at 01:05:03PM +0200, Blue Swirl wrote: > > On 3/12/10, Vagrant Cascadian 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 > :730: warning [p 9, 4.8i, div `an-div', 0.2i]: can't break line > :730: warning [p 9, 5.0i]: can't break line > :735: warning [p 9, 5.8i, div `an-div', 0.2i]: can't break line > :735: warning [p 9, 6.0i]: can't break line > :869: warning [p 11, 5.2i, div `an-div', 0.2i]: can't break line > :869: warning [p 11, 5.3i]: can't break line > :890: warning [p 11, 8.3i, div `an-div', 0.2i]: can't break line > :890: warning [p 11, 8.5i]: can't break line > :953: warning [p 12, 5.8i, div `an-div', 0.2i]: can't break line > :953: warning [p 12, 6.0i]: can't break line > :1732: warning [p 22, 1.8i, div `an-div', 0.2i]: can't break line > :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. How about this patch? I get no warnings anymore. --00032555547ea8b3620481c006b1 Content-Type: text/x-diff; charset=US-ASCII; name="0001-Fix-manpage-errors.patch" Content-Disposition: attachment; filename="0001-Fix-manpage-errors.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: f_g6rokkfp RnJvbSBjYjUzZmEwMmU5NDY1MTc0ZWNkMWVhNzAzOGE0ODUzOTgwMWIxMWM4IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBCbHVlIFN3aXJsIDxibGF1d2lyYmVsQGdtYWlsLmNvbT4KRGF0 ZTogU3VuLCAxNCBNYXIgMjAxMCAwOTo0OTo0MCArMDAwMApTdWJqZWN0OiBbUEFUQ0hdIEZpeCBt YW5wYWdlIGVycm9ycwoKU3BsaXQgbG9uZyB1bmJyZWFrYWJsZSBsaW5lcyB0byBzbWFsbGVyIHNl Y3Rpb25zLgoKU3BvdHRlZCBieSBEZWJpYW4gTGludGlhbiB0b29sOgpodHRwOi8vbGludGlhbi5k ZWJpYW4ub3JnL2Z1bGwvcGtnLXFlbXUtZGV2ZWxAbGlzdHMuYWxpb3RoLmRlYmlhbi5vcmcuaHRt bCNxZW11CgpTaWduZWQtb2ZmLWJ5OiBCbHVlIFN3aXJsIDxibGF1d2lyYmVsQGdtYWlsLmNvbT4K LS0tCiBxZW11LWRvYy50ZXhpICAgfCAgICAyICstCiBxZW11LW9wdGlvbnMuaHggfCAgIDEyICsr KysrKy0tLS0tLQogMiBmaWxlcyBjaGFuZ2VkLCA3IGluc2VydGlvbnMoKyksIDcgZGVsZXRpb25z KC0pCgpkaWZmIC0tZ2l0IGEvcWVtdS1kb2MudGV4aSBiL3FlbXUtZG9jLnRleGkKaW5kZXggMTQ5 NDc1Ny4uNjY0N2I3YiAxMDA2NDQKLS0tIGEvcWVtdS1kb2MudGV4aQorKysgYi9xZW11LWRvYy50 ZXhpCkBAIC0xNTA0LDcgKzE1MDQsNyBAQCBxZW11LXN5c3RlbS1zcGFyYyAtcHJvbS1lbnYgJ2F1 dG8tYm9vdD89ZmFsc2UnIFwKICAtcHJvbS1lbnYgJ2Jvb3QtZGV2aWNlPXNkKDAsMiwwKTpkJyAt cHJvbS1lbnYgJ2Jvb3QtYXJncz1saW51eCBzaW5nbGUnCiBAZW5kIGV4YW1wbGUKIAotQGl0ZW0g LU0gW1NTLTR8U1MtNXxTUy0xMHxTUy0yMHxTUy02MDBNUHxMWHxWb3lhZ2VyfFNQQVJDQ2xhc3Np Y3xTUEFSQ2Jvb2t8U1MtMnxTUy0xMDAwfFNTLTIwMDBdCitAaXRlbSAtTSBbU1MtNHxTUy01fFNT LTEwfFNTLTIwfFNTLTYwME1QfExYfFZveWFnZXJ8U1BBUkNDbGFzc2ljXSBbfFNQQVJDYm9va3xT Uy0yfFNTLTEwMDB8U1MtMjAwMF0KIAogU2V0IHRoZSBlbXVsYXRlZCBtYWNoaW5lIHR5cGUuIERl ZmF1bHQgaXMgU1MtNS4KIApkaWZmIC0tZ2l0IGEvcWVtdS1vcHRpb25zLmh4IGIvcWVtdS1vcHRp b25zLmh4CmluZGV4IGZkNTBhZGQuLjg0NTBiNDUgMTAwNjQ0Ci0tLSBhL3FlbXUtb3B0aW9ucy5o eAorKysgYi9xZW11LW9wdGlvbnMuaHgKQEAgLTg1Miw3ICs4NTIsNyBAQCBMb2FkIFNNQklPUyBl bnRyeSBmcm9tIGJpbmFyeSBmaWxlLgogQGZpbmRleCAtc21iaW9zCiBTcGVjaWZ5IFNNQklPUyB0 eXBlIDAgZmllbGRzCiAKLUBpdGVtIC1zbWJpb3MgdHlwZT0xWyxtYW51ZmFjdHVyZXI9QHZhcntz dHJ9XVsscHJvZHVjdD1AdmFye3N0cn1dWyx2ZXJzaW9uPUB2YXJ7c3RyfV1bLHNlcmlhbD1AdmFy e3N0cn1dWyx1dWlkPUB2YXJ7dXVpZH1dWyxza3U9QHZhcntzdHJ9XVssZmFtaWx5PUB2YXJ7c3Ry fV0KK0BpdGVtIC1zbWJpb3MgdHlwZT0xWyxtYW51ZmFjdHVyZXI9QHZhcntzdHJ9XVsscHJvZHVj dD1AdmFye3N0cn1dIFssdmVyc2lvbj1AdmFye3N0cn1dWyxzZXJpYWw9QHZhcntzdHJ9XVssdXVp ZD1AdmFye3V1aWR9XVssc2t1PUB2YXJ7c3RyfV0gWyxmYW1pbHk9QHZhcntzdHJ9XQogU3BlY2lm eSBTTUJJT1MgdHlwZSAxIGZpZWxkcwogRVRFWEkKIApAQCAtOTMyLDcgKzkzMiw3IEBAIERFRigi bmV0ZGV2IiwgSEFTX0FSRywgUUVNVV9PUFRJT05fbmV0ZGV2LAogI2VuZGlmCiAgICAgInNvY2tl dF0saWQ9c3RyWyxvcHRpb25dWyxvcHRpb25dWywuLi5dXG4iKQogU1RFWEkKLUBpdGVtIC1uZXQg bmljWyx2bGFuPUB2YXJ7bn1dWyxtYWNhZGRyPUB2YXJ7bWFjfV1bLG1vZGVsPUB2YXJ7dHlwZX1d WyxuYW1lPUB2YXJ7bmFtZX1dWyxhZGRyPUB2YXJ7YWRkcn1dWyx2ZWN0b3JzPUB2YXJ7dn1dCitA aXRlbSAtbmV0IG5pY1ssdmxhbj1AdmFye259XVssbWFjYWRkcj1AdmFye21hY31dWyxtb2RlbD1A dmFye3R5cGV9XSBbLG5hbWU9QHZhcntuYW1lfV1bLGFkZHI9QHZhcnthZGRyfV1bLHZlY3RvcnM9 QHZhcnt2fV0KIEBmaW5kZXggLW5ldAogQ3JlYXRlIGEgbmV3IE5ldHdvcmsgSW50ZXJmYWNlIENh cmQgYW5kIGNvbm5lY3QgaXQgdG8gVkxBTiBAdmFye259IChAdmFye259CiA9IDAgaXMgdGhlIGRl ZmF1bHQpLiBUaGUgTklDIGlzIGFuIGUxMDAwIGJ5IGRlZmF1bHQgb24gdGhlIFBDCkBAIC0xMDYz LDcgKzEwNjMsNyBAQCBwcm9jZXNzZWQgYW5kIGFwcGxpZWQgdG8gLW5ldCB1c2VyLiBNaXhpbmcg dGhlbSB3aXRoIHRoZSBuZXcgY29uZmlndXJhdGlvbgogc3ludGF4IGdpdmVzIHVuZGVmaW5lZCBy ZXN1bHRzLiBUaGVpciB1c2UgZm9yIG5ldyBhcHBsaWNhdGlvbnMgaXMgZGlzY291cmFnZWQKIGFz IHRoZXkgd2lsbCBiZSByZW1vdmVkIGZyb20gZnV0dXJlIHZlcnNpb25zLgogCi1AaXRlbSAtbmV0 IHRhcFssdmxhbj1AdmFye259XVssbmFtZT1AdmFye25hbWV9XVssZmQ9QHZhcntofV1bLGlmbmFt ZT1AdmFye25hbWV9XVssc2NyaXB0PUB2YXJ7ZmlsZX1dWyxkb3duc2NyaXB0PUB2YXJ7ZGZpbGV9 XQorQGl0ZW0gLW5ldCB0YXBbLHZsYW49QHZhcntufV1bLG5hbWU9QHZhcntuYW1lfV1bLGZkPUB2 YXJ7aH1dWyxpZm5hbWU9QHZhcntuYW1lfV0gWyxzY3JpcHQ9QHZhcntmaWxlfV1bLGRvd25zY3Jp cHQ9QHZhcntkZmlsZX1dCiBDb25uZWN0IHRoZSBob3N0IFRBUCBuZXR3b3JrIGludGVyZmFjZSBA dmFye25hbWV9IHRvIFZMQU4gQHZhcntufSwgdXNlCiB0aGUgbmV0d29yayBzY3JpcHQgQHZhcntm aWxlfSB0byBjb25maWd1cmUgaXQgYW5kIHRoZSBuZXR3b3JrIHNjcmlwdAogQHZhcntkZmlsZX0g dG8gZGVjb25maWd1cmUgaXQuIElmIEB2YXJ7bmFtZX0gaXMgbm90IHByb3ZpZGVkLCB0aGUgT1MK QEAgLTEwODMsNyArMTA4Myw3IEBAIHFlbXUgbGludXguaW1nIC1uZXQgbmljLHZsYW49MCAtbmV0 IHRhcCx2bGFuPTAsaWZuYW1lPXRhcDAgXAogICAgICAgICAgICAgICAgLW5ldCBuaWMsdmxhbj0x IC1uZXQgdGFwLHZsYW49MSxpZm5hbWU9dGFwMQogQGVuZCBleGFtcGxlCiAKLUBpdGVtIC1uZXQg c29ja2V0Wyx2bGFuPUB2YXJ7bn1dWyxuYW1lPUB2YXJ7bmFtZX1dWyxmZD1AdmFye2h9XVssbGlz dGVuPVtAdmFye2hvc3R9XTpAdmFye3BvcnR9XVssY29ubmVjdD1AdmFye2hvc3R9OkB2YXJ7cG9y dH1dCitAaXRlbSAtbmV0IHNvY2tldFssdmxhbj1AdmFye259XVssbmFtZT1AdmFye25hbWV9XVss ZmQ9QHZhcntofV0gWyxsaXN0ZW49W0B2YXJ7aG9zdH1dOkB2YXJ7cG9ydH1dWyxjb25uZWN0PUB2 YXJ7aG9zdH06QHZhcntwb3J0fV0KIAogQ29ubmVjdCB0aGUgVkxBTiBAdmFye259IHRvIGEgcmVt b3RlIFZMQU4gaW4gYW5vdGhlciBRRU1VIHZpcnR1YWwKIG1hY2hpbmUgdXNpbmcgYSBUQ1Agc29j a2V0IGNvbm5lY3Rpb24uIElmIEBvcHRpb257bGlzdGVufSBpcwpAQCAtMTEwMyw3ICsxMTAzLDcg QEAgcWVtdSBsaW51eC5pbWcgLW5ldCBuaWMsbWFjYWRkcj01Mjo1NDowMDoxMjozNDo1NyBcCiAg ICAgICAgICAgICAgICAtbmV0IHNvY2tldCxjb25uZWN0PTEyNy4wLjAuMToxMjM0CiBAZW5kIGV4 YW1wbGUKIAotQGl0ZW0gLW5ldCBzb2NrZXRbLHZsYW49QHZhcntufV1bLG5hbWU9QHZhcntuYW1l fV1bLGZkPUB2YXJ7aH1dWyxtY2FzdD1AdmFye21hZGRyfTpAdmFye3BvcnR9XQorQGl0ZW0gLW5l dCBzb2NrZXRbLHZsYW49QHZhcntufV1bLG5hbWU9QHZhcntuYW1lfV1bLGZkPUB2YXJ7aH1dIFss bWNhc3Q9QHZhcnttYWRkcn06QHZhcntwb3J0fV0KIAogQ3JlYXRlIGEgVkxBTiBAdmFye259IHNo YXJlZCB3aXRoIGFub3RoZXIgUUVNVSB2aXJ0dWFsCiBtYWNoaW5lcyB1c2luZyBhIFVEUCBtdWx0 aWNhc3Qgc29ja2V0LCBlZmZlY3RpdmVseSBtYWtpbmcgYSBidXMgZm9yCkBAIC0xMTQzLDcgKzEx NDMsNyBAQCBxZW11IGxpbnV4LmltZyAtbmV0IG5pYyxtYWNhZGRyPTUyOjU0OjAwOjEyOjM0OjU2 IFwKIC9wYXRoL3RvL2xpbnV4IHViZDA9L3BhdGgvdG8vcm9vdF9mcyBldGgwPW1jYXN0CiBAZW5k IGV4YW1wbGUKIAotQGl0ZW0gLW5ldCB2ZGVbLHZsYW49QHZhcntufV1bLG5hbWU9QHZhcntuYW1l fV1bLHNvY2s9QHZhcntzb2NrZXRwYXRofV1bLHBvcnQ9QHZhcntufV1bLGdyb3VwPUB2YXJ7Z3Jv dXBuYW1lfV1bLG1vZGU9QHZhcntvY3RhbG1vZGV9XQorQGl0ZW0gLW5ldCB2ZGVbLHZsYW49QHZh cntufV1bLG5hbWU9QHZhcntuYW1lfV1bLHNvY2s9QHZhcntzb2NrZXRwYXRofV0gWyxwb3J0PUB2 YXJ7bn1dWyxncm91cD1AdmFye2dyb3VwbmFtZX1dWyxtb2RlPUB2YXJ7b2N0YWxtb2RlfV0KIENv bm5lY3QgVkxBTiBAdmFye259IHRvIFBPUlQgQHZhcntufSBvZiBhIHZkZSBzd2l0Y2ggcnVubmlu ZyBvbiBob3N0IGFuZAogbGlzdGVuaW5nIGZvciBpbmNvbWluZyBjb25uZWN0aW9ucyBvbiBAdmFy e3NvY2tldHBhdGh9LiBVc2UgR1JPVVAgQHZhcntncm91cG5hbWV9CiBhbmQgTU9ERSBAdmFye29j dGFsbW9kZX0gdG8gY2hhbmdlIGRlZmF1bHQgb3duZXJzaGlwIGFuZCBwZXJtaXNzaW9ucyBmb3IK LS0gCjEuNS42LjUKCg== --00032555547ea8b3620481c006b1--