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

Jeff Squyres jsquyres at cisco.com
Tue Jun 3 17:40:36 UTC 2008


Ok, will do.

I assume I should also do the same in MPI_Status_f2c.3 -- the line is  
not nearly as long, but we might as well be consistent with spaces and  
commas.

All the changes are now committed:

https://svn.open-mpi.org/trac/ompi/changeset/18559
https://svn.open-mpi.org/trac/ompi/changeset/18560

Do you want me to make you a demo/unofficial 1.2 tarball with these  
changes and you can test the lint checker thingy?



On Jun 3, 2008, at 1:12 PM, Dirk Eddelbuettel wrote:

> 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.


-- 
Jeff Squyres
Cisco Systems




More information about the Pkg-openmpi-maintainers mailing list