On 10/28/20 5:46 PM, Aisha Tammy wrote:
On 10/28/20 3:31 PM, Ingo Schwarze wrote:
Hi Aisha,

Aisha Tammy wrote on Wed, Oct 28, 2020 at 01:12:15PM -0400:

Here is a preliminary version update of math/lapack to 3.9.0
with some patches from debian and gentoo.

While FORTAN used to be my favourite language until about 1998,
i got out of the habit of using it after that, so i can't really
comment on the port in general, but ...

Current caveats
(1) I've had to remove the man pages installation.

1. Why?

In general, if a major change is needed when updating a port,
it is useful to mention the reason.


2. Isn't that a blocker?

For a programming library, having section 3 documentation seems
crucial to me.  What is the point of an undocumented public API?

Yes, i am aware that lapack is among the last 20 or so ports that
require USE_GROFF, and among the worst handful of these because the
man(7) code is both unusually problematic from a qualitative
standpoint (.ti nested inside .TP head, ...) and also hard to handle
from a perspective of quantity - the library is so large that even
reviewing the manual pages regarding which problems are contained
in them isn't easy.

But none of that should be your problem, nor should it prevent
formatting the manual pages with groff and installing them.

Yours,
   Ingo


That's fair. I removed them as it seemed like none of the other
distributions are installing them in this package.
Some of them have a separate man-pages packages for lapack.
Other reason was that the man pages haven't been updated from 2007.
So I am also not sure if they are the most up to date.
But as you said, having them is better than not having them.

I can try to add them back but it might take some more time.

Aisha


Just as I sent this email, I noticed that it seems they have
a Doxygen man generator that is quite up to date.
- https://github.com/Reference-LAPACK/lapack/blob/master/DOCS/Doxyfile_man
Their prebuilt man files are from 2007 so I'll try to use this
to generate the man pages!

Cheers,
Aisha

Reply via email to