rjmccall added a comment.

In D146188#4223249 <https://reviews.llvm.org/D146188#4223249>, @xiongji90 wrote:

> Hi, @rjmccall and @sepavloff 
> In UserManual, we include a section `Controlling Floating Point Behavior`: 
> https://github.com/llvm/llvm-project/blob/main/clang/docs/UsersManual.rst#controlling-floating-point-behavior
>  , now we need to add a new section for floating-point environment, do we 
> need to add the new section in parallel with `Controlling Floating Point 
> Behavior` section or just put the section under `Controlling Floating Point 
> Behavior`? And current `Controlling Floating Point Behavior` includes 
> following description:
> `Clang provides a number of ways to control floating point behavior, 
> including with command line options and source pragmas.`
> So, we need to update it to `Clang provides a number of ways to control 
> floating point behavior, including with command line options, source pragmas 
> and builtins.` and mention __builtin_flt_rounds, __builtin_set_flt_rounds in 
> this section. Does this meet your expectation?

I think you should add a subsection to Controlling Floating Point Behavior 
about the floating-point environment.  You should not mention these builtins 
there specifically — if you want an example function that reads or modifies the 
environment, you should use one of the standard APIs like the `FLT_ROUNDS` 
macro or the `fesetround` function.  You should also add the documentation for 
these builtins where you've currently got it, and that documentation can 
cross-reference to Controlling Floating Point Behavior.  Does that make sense?


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D146188/new/

https://reviews.llvm.org/D146188

_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to