manual: Update _TIME_BITS to clarify it's user defined

Message ID 20211014215531.2618113-1-shorne@gmail.com
State Committed
Commit ad6feef1b0c2cc6d7ad29c5cc4e14ba16f360f06
Delegated to: Adhemerval Zanella Netto
Headers
Series manual: Update _TIME_BITS to clarify it's user defined |

Checks

Context Check Description
dj/TryBot-apply_patch success Patch applied to master at the time it was sent
dj/TryBot-32bit success Build for i686

Commit Message

Stafford Horne Oct. 14, 2021, 9:55 p.m. UTC
  The current language reads "This macro determines...", changing to
"Define this macro...".  This is consistent with other feature macro
documentation language.

When I first read the previous language it seems to indicate that the
macro is already defined.  By changing the language to "Define this
macro..." it's clear that its the user's responsibility to define it.
---
 manual/creature.texi | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
  

Comments

Adhemerval Zanella Netto Oct. 18, 2021, 4:30 p.m. UTC | #1
On 14/10/2021 18:55, Stafford Horne via Libc-alpha wrote:
> The current language reads "This macro determines...", changing to
> "Define this macro...".  This is consistent with other feature macro
> documentation language.
> 
> When I first read the previous language it seems to indicate that the
> macro is already defined.  By changing the language to "Define this
> macro..." it's clear that its the user's responsibility to define it.

LGTM, thanks.

Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>

> ---
>  manual/creature.texi | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/manual/creature.texi b/manual/creature.texi
> index c13de52f1f..6193e0735c 100644
> --- a/manual/creature.texi
> +++ b/manual/creature.texi
> @@ -171,8 +171,8 @@ This macro was introduced as part of the Large File Support extension
>  @end defvr
>  
>  @defvr Macro _TIME_BITS
> -This macro determines the bit size of @code{time_t}, and therefore the
> -bit size of all @code{time_t}-derived types and the prototypes of all
> +Define this macro to control the bit size of @code{time_t}, and therefore
> +the bit size of all @code{time_t}-derived types and the prototypes of all
>  related functions.
>  
>  @enumerate
>
  

Patch

diff --git a/manual/creature.texi b/manual/creature.texi
index c13de52f1f..6193e0735c 100644
--- a/manual/creature.texi
+++ b/manual/creature.texi
@@ -171,8 +171,8 @@  This macro was introduced as part of the Large File Support extension
 @end defvr
 
 @defvr Macro _TIME_BITS
-This macro determines the bit size of @code{time_t}, and therefore the
-bit size of all @code{time_t}-derived types and the prototypes of all
+Define this macro to control the bit size of @code{time_t}, and therefore
+the bit size of all @code{time_t}-derived types and the prototypes of all
 related functions.
 
 @enumerate