manpage-has-errors-from-man lintian warning

[KaiHa]

Lintian complaints:

W: nix: manpage-has-errors-from-man usr/share/man/man1/nix-store.1.gz 1199: warning [p 13, 7.2i]: can't break line

[infinity0]

This is a syntax error with the man page, check line 1199 and nroff syntax manual.

Probably best fixed upstream. Note they use xml format https://github.com/NixOS/nix/blob/master/doc/manual/command-ref/nix-store.xml and translate it to nroff somehow.

[aszlig]

@KaiHa: Can you paste a bit of context (eg. 5 lines) of the line where you got that error?

[KaiHa]

@KaiHa: Can you paste a bit of context (eg. 5 lines) of the line where you got that error?

Sure @aszlig, but since I took so long to respond the error has moved in the meantime (2.3.1) a few lines:

W: nix-bin: manpage-has-errors-from-man usr/share/man/man1/nix-store.1.gz 1292: warning [p 14, 2.2i]: can't break line

The corresponding context is the following:

1286 .if n \{\
1287 .RE
1288 .\}
1289 .SH "OPERATION \-\-GENERATE\-BINARY\-CACHE\-KEY"
1290 .SS "Synopsis"
1291 .HP \w'\fBnix\-store\fR\ 'u
1292 \fBnix\-store\fR \fB\-\-generate\-binary\-cache\-key\fR\ \fBkey\-name\fR\ \fBsecret\-key\-file\fR\ \fBpublic\-key\-file\fR
1293 .SS "Description"
1294 .PP
1295 This command generates an
1296 \m[blue]\fBEd25519 key pair\fR\m[]\&\s-2\u[3]\d\s+2
1297 that can be used to create a signed binary cache\&. It takes three mandatory parameters:
1298 .sp

If you are generally interested in enhancing the man pages, there are a few spelling errors about which linitian complains about. You can find the lintian messages here.