Issue in man page PR_SET_FPEXC.2const

Issue in man page PR_SET_FPEXC.2const

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    This is not very good to read. Maybe a table or a list?

"Set floating-point exception mode to I<mode>.  Pass B<PR_FP_EXC_SW_ENABLE> "
"to use FPEXC for FP exception enables, B<PR_FP_EXC_DIV> for floating-point "
"divide by zero, B<PR_FP_EXC_OVF> for floating-point overflow, "
"B<PR_FP_EXC_UND> for floating-point underflow, B<PR_FP_EXC_RES> for floating-"
"point inexact result, B<PR_FP_EXC_INV> for floating-point invalid operation, "
"B<PR_FP_EXC_DISABLED> for FP exceptions disabled, B<PR_FP_EXC_NONRECOV> for "
"async nonrecoverable exception mode, B<PR_FP_EXC_ASYNC> for async "
"recoverable exception mode, B<PR_FP_EXC_PRECISE> for precise exception mode."

Re: Issue in man page PR_SET_FPEXC.2const

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 2969 bytes --]

Hi Helge,

On Sun, Aug 24, 2025 at 02:48:47PM +0000, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    This is not very good to read. Maybe a table or a list?

Agree.  I've formatted it as a list:

	$ diffman-git HEAD
	--- HEAD^:man/man2const/PR_SET_FPEXC.2const
	+++ HEAD:man/man2const/PR_SET_FPEXC.2const
	@@ -13,17 +13,41 @@ SYNOPSIS
		int prctl(PR_SET_FPEXC, unsigned long mode);
	 
	 DESCRIPTION
	-       Set floating-point exception mode to mode.  Pass
	-       PR_FP_EXC_SW_ENABLE to use FPEXC for FP exception en‐
	-       ables, PR_FP_EXC_DIV for floating-point divide by
	-       zero, PR_FP_EXC_OVF for floating-point overflow,
	-       PR_FP_EXC_UND for floating-point underflow,
	-       PR_FP_EXC_RES for floating-point inexact result,
	-       PR_FP_EXC_INV for floating-point invalid operation,
	-       PR_FP_EXC_DISABLED for FP exceptions disabled,
	-       PR_FP_EXC_NONRECOV for async nonrecoverable exception
	-       mode, PR_FP_EXC_ASYNC for async recoverable exception
	-       mode, PR_FP_EXC_PRECISE for precise exception mode.
	+       Set floating-point exception mode to mode.  mode can
	+       be one of the following values.
	+
	+       PR_FP_EXC_SW_ENABLE
	+              Use FPEXC for FP exception enables.
	+
	+       PR_FP_EXC_DIV
	+              Use FPEXC for floating-point divide by zero.
	+
	+       PR_FP_EXC_OVF
	+              Use FPEXC for floating-point overflow.
	+
	+       PR_FP_EXC_UND
	+              Use FPEXC for floating-point underflow.
	+
	+       PR_FP_EXC_RES
	+              Use FPEXC for floating-point inexact result.
	+
	+       PR_FP_EXC_INV
	+              Use FPEXC for floating-point invalid opera‐
	+              tion.
	+
	+       PR_FP_EXC_DISABLED
	+              Use FPEXC for FP exceptions disabled.
	+
	+       PR_FP_EXC_NONRECOV
	+              Use FPEXC for async nonrecoverable exception
	+              mode.
	+
	+       PR_FP_EXC_ASYNC
	+              Use FPEXC for async recoverable exception
	+              mode.
	+
	+       PR_FP_EXC_PRECISE
	+              Use FPEXC for precise exception mode.
	 
	 RETURN VALUE
		On success, 0 is returned.  On error, -1 is returned,

Have a lovely night!
Alex

> 
> "Set floating-point exception mode to I<mode>.  Pass B<PR_FP_EXC_SW_ENABLE> "
> "to use FPEXC for FP exception enables, B<PR_FP_EXC_DIV> for floating-point "
> "divide by zero, B<PR_FP_EXC_OVF> for floating-point overflow, "
> "B<PR_FP_EXC_UND> for floating-point underflow, B<PR_FP_EXC_RES> for floating-"
> "point inexact result, B<PR_FP_EXC_INV> for floating-point invalid operation, "
> "B<PR_FP_EXC_DISABLED> for FP exceptions disabled, B<PR_FP_EXC_NONRECOV> for "
> "async nonrecoverable exception mode, B<PR_FP_EXC_ASYNC> for async "
> "recoverable exception mode, B<PR_FP_EXC_PRECISE> for precise exception mode."

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Issue in man page PR_SET_FPEXC.2const

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:     Colon instead of fullstop?

"Set floating-point exception mode to I<mode>.  I<mode> can be one of the "
"following values."

Issue in man page PR_SET_FPEXC.2const

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:     "enables" sounds strange here? Maybe activation?

"Use FPEXC for FP exception enables."

Issue in man page PR_SET_FPEXC.2const

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:     Is this the opposite to "enables" above? This is past tense, on purpose?

"Use FPEXC for FP exceptions disabled."

Re: Issue in man page PR_SET_FPEXC.2const

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 867 bytes --]

Hi Helge,

On Wed, Dec 24, 2025 at 02:38:22PM +0000, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:     Colon instead of fullstop?
> 
> "Set floating-point exception mode to I<mode>.  I<mode> can be one of the "
> "following values."

Thanks!  I've reworded, to make it easier:

	diff --git i/man/man2const/PR_SET_FPEXC.2const w/man/man2const/PR_SET_FPEXC.2const
	index b43a6f888..f4ed61b8f 100644
	--- i/man/man2const/PR_SET_FPEXC.2const
	+++ w/man/man2const/PR_SET_FPEXC.2const
	@@ -19,9 +19,8 @@ .SH SYNOPSIS
	 .fi
	 .SH DESCRIPTION
	 Set floating-point exception mode to
	-.IR mode .
	-.I mode
	-can be one of the following values.
	+.IR mode ,
	+which can be one of the following values.
	 .TP
	 .B PR_FP_EXC_SW_ENABLE
	 Use FPEXC for


Cheers,
Alex

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page PR_SET_FPEXC.2const

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 494 bytes --]

Hi Helge,

On Wed, Dec 24, 2025 at 02:38:23PM +0000, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:     Is this the opposite to "enables" above? This is past tense, on purpose?
> 
> "Use FPEXC for FP exceptions disabled."

I have no idea.  Some FP expert should come and review this text.
I don't know any.  If anyone is an FP expert and is reading this, please
review.


Have a lovely night!
Alex

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page PR_SET_FPEXC.2const

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 454 bytes --]

Hi Helge,

On Wed, Dec 24, 2025 at 02:38:23PM +0000, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:     "enables" sounds strange here? Maybe activation?
> 
> "Use FPEXC for FP exception enables."

I don't know what it wants to mean.

If anyone knows about FP and is reading this, please let us know what
this meant, so that we can reword it.


Cheers,
Alex

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]