Re: [PATCH 1/2] system_data_types.7: Add 'fexcept_t'

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Michael,

On 2020-09-22 21:57, Michael Kerrisk (man-pages) wrote:
>
> The previous sentence is rather hard to parse. What (other) part of
> the sentence does "to provide auxiliary information" relate to.
> I suggest splitting the sentence in two and rewording.
>
>
>> +A floating-point control mode is a system variable whose
>
> You suddenly introduce "floating-point control mode" here.
> How does it relate to the preceding sentences? It's not clear.
>
> Going off to look at the standard... I see that actually your
> sentences come pretty much straight from the standard. So, first, I
> think the standard could have been clearer here. Second, and more
> important, (for copyright reasons) we are on shaky ground if we just
> lift whole passages from the standard.  The text does really need to
> be in your own words. Can you come up with something?>
> Alternatively, I guess we could explicitly quote the standard.
> Something like
>
>      POSIX describes this type as follows:
>      .RS
>      .PP
>      [The text]
>      .RE

Yes.  A few patches ago I asked about that,
but you didn't answer to that specifically,
so I guessed that it was just fair use:

https://lore.kernel.org/linux-man/6dc80c25-85bf-925c-49c2-f79865027c0f@xxxxxxxxx/T/#mbfdcaf4fe625b4ff7ea90dc7396005fda1283612

But I guess explicitly quoting POSIX would be easy and better,
as you proposed.

I never used that type, so I wouldn't dare to describe it in my own words.

Thanks,

Alex



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux