This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [PATCH, rs6000] Alphabetize prototypes of AltiVec built-in functions in extend.texi
- From: Segher Boessenkool <segher at kernel dot crashing dot org>
- To: Kelvin Nilsen <kdnilsen at linux dot ibm dot com>
- Cc: gcc-patches at gcc dot gnu dot org
- Date: Fri, 13 Jul 2018 13:16:34 -0500
- Subject: Re: [PATCH, rs6000] Alphabetize prototypes of AltiVec built-in functions in extend.texi
- References: <59df7615-4c01-0047-5fba-1eb6a04be6b0@linux.ibm.com>
On Tue, Jul 10, 2018 at 06:13:50PM -0500, Kelvin Nilsen wrote:
> This patch alphabetizes the list of AltiVec built-in function prototypes that consume about 15 pages of the gcc.pdf file. As part of the alphabetization effort, certain functions that should not be documented in this section of the manual are separated from the others and moved to the end of the section with comments to explain their role.
>
> This patch prepares the way for future patches that will remove certain prototypes from this section and will insert certain prototypes that are currently missing from this section. It also improves readability and maintainability of the section.
I don't think having these thing alphabetical is a good idea; there are
much better orderings possible. But it is a step towards sorting out the
mess that is the current documentation, so okay for trunk!
Thanks for working on this.
Segher
> * doc/extend.texi (PowerPC AltiVec Built-in Functions):
> Alphabetize prototypes of built-in functions, separating out
> built-in functions that are listed in this section but should be
> described elsewhere.