1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
boot: 0.921
performance: 0.850
device: 0.807
ppc: 0.791
PID: 0.788
graphic: 0.782
semantic: 0.730
network: 0.721
architecture: 0.718
socket: 0.696
register: 0.696
kernel: 0.604
permissions: 0.574
hypervisor: 0.565
files: 0.555
vnc: 0.540
x86: 0.489
risc-v: 0.480
assembly: 0.475
debug: 0.433
mistranslation: 0.423
arm: 0.406
TCG: 0.404
VMM: 0.402
peripherals: 0.372
i386: 0.363
user-level: 0.363
virtual: 0.323
KVM: 0.289
QEMU manpages provoke man(1) "can't break line" warnings
I noticed when I ran 'man qemu' for version 2.8.0 I am getting this back at the terminal;
<standard input>:1674: warning [p 1, 188.5i, div `an-div', 0.2i]: can't break line
<standard input>:1677: warning [p 1, 188.8i, div `an-div', 0.2i]: can't break line
This still reproduces with current QEMU:
$ man -l build/qemu.1 >/dev/null
<standard input>:248: warning [p 3, 6.8i, div `an-div', 0.2i]: can't break line
<standard input>:376: warning [p 5, 2.5i, div `an-div', 0.2i]: can't break line
<standard input>:667: warning [p 8, 9.7i, div `an-div', 0.2i]: can't break line
(and so on for more warnings)
'man' produces these warnings when the input has a line which it is unable to cleanly line-break to fit in the output terminal (and so the number of warnings you get depends on the width of the terminal you're using). For instance this line:
.IP "\fB\-boot [order=\fR\fIdrives\fR\fB][,once=\fR\fIdrives\fR\fB][,menu=on|off][,splash=\fR\fIsp_name\fR\fB][,splash\-time=\fR\fIsp_time\fR\fB][,
has no spaces in the whole of the part after "-boot" so it will typically not line break cleanly.
Ideally we would fix this by arranging to have the groff output include '\:' zero-width break points between the ']' and '[' in this kind of long line so that it knew where to wrap. But I don't know if this is easy/possible with how we're generating the manpages at the moment.
In any case the warning is harmless and the hard-wrapped lines are not too unreadable, so this is a minor issue.
Still happens with the new Sphinx-generated manpages, for exactly the same reason.
This is an automated cleanup. This bug report has been moved to QEMU's
new bug tracker on gitlab.com and thus gets marked as 'expired' now.
Please continue with the discussion here:
https://gitlab.com/qemu-project/qemu/-/issues/214
|