GCC testsuite documentation for `arm_mixed_fp` is now complete.
The GCC testsuite documentation now includes a description of `arm_mixed_fp`, clarifying its purpose and usage.
The GCC testsuite documentation in doc/sourcebuild.texi is updated to include a clear explanation of arm_mixed_fp. This addition provides necessary context for developers regarding its function within the testsuite, especially concerning floating-point configurations on ARM targets. The change completes the documentation that was intended to be part of an earlier commit.
In Details
This commit addresses a documentation gap in gcc/doc/sourcebuild.texi by adding a description for arm_mixed_fp. In the GCC testsuite infrastructure, arm_mixed_fp is a target-support.exp helper that checks for a specific ARM floating-point configuration. It determines if the target allows mixed-precision floating-point operations, which is crucial for properly executing and verifying tests that involve combinations of single- and double-precision types. The documentation now clarifies this testsuite-specific context, which is important for testsuite maintainers and contributors to unde…
For Context
Compilers like GCC are constantly tested to make sure they work correctly on many different computer processors. These tests are organized into a 'testsuite.' Sometimes, a particular test might only make sense or be valid for certain processor configurations. For example, some ARM processors can handle a mix of different types of floating-point numbers (numbers with decimal points), while others handle them differently. A special flag or setting, arm_mixed_fp, helps the testsuite know which kind of ARM processor it's running on. This update simply adds a clear explanation of what arm_mixed_fp means and why it's used in the GCC testsuite documentation. This makes it easier for anyone working with the testsuite to understand why certain tests are run or skipped for different ARM devices.