[Pkg-openmpi-maintainers] Open Mpi 1.2.6 and several dozen new Debian man page woes

Dirk Eddelbuettel edd at debian.org
Sun Jun 1 14:15:20 UTC 2008


Manuel,

On 1 June 2008 at 00:12, Manuel Prinz wrote:
| Hi Jeff & Tim!
| 
| Am Freitag, 16. Mai 2008 17:01:08 schrieb Jeff Squyres:
| > Sun people had no idea why they were there -- they suspect leftover
| > from earlier days.  I've removed them in our trunk
| > (https://svn.open-mpi.org/trac/ompi/changeset/18449 ) -- can you let me
| > know if they now pass you lintalyzer?  If so, I'll file a CMR to get these
| > over to the 1.2 branch in case we ever do another 1.2 release.
| 
| I just tried your patch and it works great for most of the manpages. Here are the "leftovers":
| 
| W: openmpi-doc: manpage-has-errors-from-man   usr/share/man/man3/MPI_Bcast.3.gz 29: warning: `fR' not defined

I think .fR (on line 29 by itself) is spurious between '.SH INPUT/OUTPUT
PARAMETERS' and '1i' and can be removed

| W: openmpi-doc: manpage-has-errors-from-man  usr/share/man/man3/MPI_Comm_f2c.3.gz 5: warning [p 1, 0.8i]: can't break line

This one we had before -- line 5 is 200 characters long.  Didn't SUN say this
page can possibly be removed alltogether>

| W: openmpi-doc: manpage-has-errors-from-man usr/share/man/man3/MPI_Type_create_darray.3.gz 101: warning: `\' not defined

Hm, that is a paragraph on a line -- not sure where in line 101 this is. May
start by breaking it

| W: openmpi-doc: manpage-has-errors-from-man | usr/share/man/man3/MPI_Wait.3.gz 53: warning: `NOTES' not defined

Section starts with '.NOTES' instead of '.SH NOTES'

| W: openmpi-bin: manpage-has-errors-from-man usr/share/man/man1/mpiexec.openmpi.1.gz 458: warning: `hostfile'' not defined
| W: openmpi-bin: manpage-has-errors-from-man usr/share/man/man1/orterun.1.gz 458: warning: `hostfile'' not defined

In both cases the line starts with 'hostfile', this may just need an explicit
formatter for regular text, or to just realign the linebreak.

| I do not have much clue when it comes to manpages, so I'd be happy if you know how to fix those. It would be great if you could file the CMR even though there are these minor issues. Thanks in 
| advance!

Could you try these fixes ?

Cheers, Dirk

-- 
Three out of two people have difficulties with fractions.



More information about the Pkg-openmpi-maintainers mailing list