Re: MPFR and MPC

[Bengt Richter <bokr@bokr.com>]

Hi,

On +2020-07-23 15:36:21 +0200, Andreas Enge wrote:
> Hello,
> 
> mpfr just had a new release 4.1.0:
>    https://ftp.gnu.org/pub/gnu/mpfr/
> and I am planning to make one for mpc as well.
> 
> Should I follow some procedure for an update in Guix, or could I just push
> two commits to core-updates?
> 
> Andreas
> 
> 
It would seem easy to forget that all readers may not know what MPFR and MPC
(and other acronyms) mean, yet be curious enough to want to look them up ;-)

To help such people, I think it would be great if "info guix acronyms"
searched for and found a glossary section (e.g. 14.9 Acronyms ?) with an
easy index that would also mostly succeed with e.g., "info guix|grep -iwC5 mpfr"
(which BTW does find something to go on right now, but not a definition)


From info guix:
--8<---------------cut here---------------start------------->8---
14.4.4 Synopses and Descriptions
--------------------------------
[...]
   Descriptions should take between five and ten lines.  Use full
sentences, and avoid using acronyms without first introducing them.
--8<---------------cut here---------------end--------------->8---

ISTM using this advice would be good for posting to the mailing list
when meanings are not obvious from thread context.

Otherwise acronyms come across a little like identity challenges,
saying "if you don't know what that means, you don't belong in this meeting."

(well, that might be true sometimes for meetings of specialists with urgent work to do,
but not for inclusive public mailing lists :)

-- 
Regards,
Bengt Richter