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
No comments:
Post a Comment