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

[Dirk Eddelbuettel]

On Tue, Jun 03, 2008 at 01:05:35PM -0400, Jeff Squyres wrote:
> On Jun 3, 2008, at 1:01 PM, Dirk Eddelbuettel wrote:
> 
> >Good idea. The Groff/troff error is after all about 'cannot break  
> >line'. Spaces may cure that.
> >
> >I just copied the page to a tempfile, handedited the spaces in and
> >tried 'man -l /tmp/MPI_Comm_f2c.3' which looks considerably better,
> >and linebroken, than the default.
> 
> 
> Does it pass your man page link checker thing?  I remember that we  
> dithered about this before...

Unsure. The package checker gets called after the whole package is
built, and I can never recall how to get groff to emit the same
warnings on the command-line :-/

But this is a pretty good indication:

edd at ron:~$ man -t -l /tmp/MPI_Comm_f2c.3 > /tmp/new
edd at ron:~$ man -t MPI_Comm_f2c > /tmp/old
<standard input>:5: warning [p 1, 1.2i]: can't break line
edd at ron:~$

So the 'new' page with Patent Pending Spaces (TM) gets formatted
without a growl; the default (from our current 1.2.6 package) gets the
growl the package checker shows too.

So let's commit.  Diff, in case this was unclear, is

edd at ron:~$ zcat /usr/share/man/man3/MPI_Comm_f2c.3.gz > /tmp/MPI_Comm_f2c.3.orig
edd at ron:~$ diff -u /tmp/MPI_Comm_f2c.3.orig /tmp/MPI_Comm_f2c.3
--- /tmp/MPI_Comm_f2c.3.orig    2008-06-03 12:11:07.000000000 -0500
+++ /tmp/MPI_Comm_f2c.3 2008-06-03 12:00:06.000000000 -0500
@@ -2,7 +2,7 @@
 .\" Copyright (c) 1996 Thinking Machines Corporation
 .TH MPI_Comm_f2c 3 "September 2006" "Open MPI 1.2" " "
 .SH NAME
-\fBMPI_Comm_f2c,MPI_Comm_c2f,MPI_File_f2c,MPI_File_c2f,MPI_Info_f2c,MPI_Info_c2f,MPI_Op_f2c,MPI_Op_c2f,MPI_Request_f2c,MPI_Request_c2f,MPI_Type_f2c,MPI_Type_c2f,MPI_Win_f2c,MPI_Win_c2f \fP \- Translates a C handle into a Fortran handle, or vice versa.
+\fBMPI_Comm_f2c,MPI_Comm_c2f, MPI_File_f2c, MPI_File_c2f, MPI_Info_f2c, MPI_Info_c2f, MPI_Op_f2c, MPI_Op_c2f, MPI_Request_f2c, MPI_Request_c2f, MPI_Type_f2c, MPI_Type_c2f, MPI_Win_f2c, MPI_Win_c2f \fP \- Translates a C handle into a Fortran handle, or vice versa.

 .SH SYNTAX
 .ft R
edd at ron:~$

Dirk

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