From patchwork Wed May 23 22:04:23 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kelvin Nilsen X-Patchwork-Id: 919416 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=gcc.gnu.org (client-ip=209.132.180.131; helo=sourceware.org; envelope-from=gcc-patches-return-478329-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=linux.ibm.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="EFK8FxRl"; dkim-atps=neutral Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 40rn0T4Wtlz9s0W for ; Thu, 24 May 2018 08:16:05 +1000 (AEST) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to:cc :from:subject:date:mime-version:content-type :content-transfer-encoding:message-id; q=dns; s=default; b=W16Ap D8jGi3N3lGMsYcMh8AxYNv7ZlyTTggS+UvC/Hk34+SWNuEAkCZlMM0HU/D3teh+d fgNf5CXurGCd4/oXTbXCfc9aho+nDgGTq/GoMFkxL+fCX+tYWo+VfZMLz2X6C5QN cYk+IVZ9U1VyyuFXfC8vNYqvR7gSakpC3nnQQ8= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to:cc :from:subject:date:mime-version:content-type :content-transfer-encoding:message-id; s=default; bh=9kCX43CqdFl fTT7X4qmY6iT1Bxs=; b=EFK8FxRlOptV4iT7V1SPEg6ylksbrZwyZRv+3lr/hmJ BXj+xoacpX0kAizOv1iPIfRAJu6L968JBMyoYo9oFImU6sHA5tNm4x33cNZGlwuC ht3Zcc9sYdl3KZvwnUmOnmPvO4ac+ReyMfGMFct9kPesDWU7I7EagW0MQ+iCQnbU = Received: (qmail 21929 invoked by alias); 23 May 2018 22:15:54 -0000 Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org Received: (qmail 21901 invoked by uid 89); 23 May 2018 22:15:51 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-12.6 required=5.0 tests=BAYES_00, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_LOW, SPF_PASS autolearn=unavailable version=3.3.2 spammy=lon, parenthesis, Collection X-HELO: mx0a-001b2d01.pphosted.com Received: from mx0b-001b2d01.pphosted.com (HELO mx0a-001b2d01.pphosted.com) (148.163.158.5) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 23 May 2018 22:15:46 +0000 Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w4NME2GV131451 for ; Wed, 23 May 2018 18:15:44 -0400 Received: from e37.co.us.ibm.com (e37.co.us.ibm.com [32.97.110.158]) by mx0b-001b2d01.pphosted.com with ESMTP id 2j5e0rq2r7-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 23 May 2018 18:15:43 -0400 Received: from localhost by e37.co.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 23 May 2018 16:15:43 -0600 Received: from b01cxnp23033.gho.pok.ibm.com (9.57.198.28) by e37.co.us.ibm.com (192.168.1.137) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; Wed, 23 May 2018 16:15:40 -0600 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23033.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w4NM4Or410617234; Wed, 23 May 2018 22:04:24 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 97AD9B205F; Wed, 23 May 2018 19:06:12 -0400 (EDT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5DEBCB2065; Wed, 23 May 2018 19:06:12 -0400 (EDT) Received: from Kelvins-MacBook-Pro-2.local (unknown [9.85.149.189]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP; Wed, 23 May 2018 19:06:12 -0400 (EDT) To: gcc-patches@gcc.gnu.org Cc: segher@gcc.gnu.org From: Kelvin Nilsen Subject: [PATCH, rs6000] Remove incorrect built-in function documentation Date: Wed, 23 May 2018 17:04:23 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:52.0) Gecko/20100101 Thunderbird/52.7.0 MIME-Version: 1.0 X-TM-AS-GCONF: 00 x-cbid: 18052322-0024-0000-0000-00001878BBF2 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00009073; HX=3.00000241; KW=3.00000007; PH=3.00000004; SC=3.00000261; SDB=6.01036678; UDB=6.00530354; IPR=6.00815805; MB=3.00021264; MTD=3.00000008; XFM=3.00000015; UTC=2018-05-23 22:15:41 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18052322-0025-0000-0000-000050220BC0 Message-Id: X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2018-05-23_08:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 impostorscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1709140000 definitions=main-1805230220 This patch removes several incorrectly documented functions from the "PowerPC AltiVec Built-in Functions" section of the "Using the GNU Compiler Collection" manual. The following two functions are removed because they are not implemented: vector float vec_copysign (vector float); vector float vec_recip (vector float, vector float); The following six functions are removed because though they are implemented, they are not specified in the AltiVec PIM document and the type of the result vector does not match the type of the supplied pointer argument: vector signed int vec_lde (int, const long long *); vector unsigned int vec_lde (int, const unsigned long long *); vector int vec_ld (int, long *) vector unsigned int vec_ld (int, const unsigned long *); vector signed int vec_lvewx (int, long *); vector unsigned int vec_lvewx (int, unsigned long *); The following two functions are removed because they are not implemented. Also, they are not specified in the AltiVec PIM document and the type of the result vector does not match the type of the supplied pointer argument: vector signed int vec_ldl (int, const long *); vector unsigned int vec_ldl (int, const unsigned long *); The following four functions are removed because they are not implemented. They do happen to be specified in the AltiVec PIM document. Until they are implemented, they should not be documented: void vec_st (vector pixel, int, unsigned short *) void vec_st (vector pixel, int, short *) void vec_stl (vector pixel, int, unsigned short *); void vec_stl (vector pixel, int, short *); The following two functions are removed because they are not implemented. They are not specified in the AltiVec PIM or ABI v.2 documents: void vec_stvehx (vector pixel, int, short *); void vec_stvehx (vector pixel, int, unsigned short *); The following function was incompletely documented. The argument list lacked a closing parenthesis. There is no function by this name. test_vsi_packsu_vssi_vssi (vector signed short x, This patch successfully builds on both powerpc64le-unknown-linux (P8) and on powerpc-linux (P7 big-endian, with both -m32 and -m64 target options). The patch affects only extend.texi. The gcc.pdf file has been built and reviewed. Is this ok for the trunk? gcc/ChangeLog: 2018-05-23 Kelvin Nilsen * doc/extend.texi (PowerPC AltiVec Built-in Functions): Remove descriptions of various incorrectly documented functions. Index: gcc/doc/extend.texi =================================================================== --- gcc/doc/extend.texi (revision 260607) +++ gcc/doc/extend.texi (working copy) @@ -16354,8 +16354,6 @@ vector signed char vec_vavgsb (vector signed char, vector unsigned char vec_vavgub (vector unsigned char, vector unsigned char); -vector float vec_copysign (vector float); - vector float vec_ceil (vector float); vector signed int vec_cmpb (vector float, vector float); @@ -16569,10 +16567,8 @@ vector float vec_ld (int, const float *); vector bool int vec_ld (int, const vector bool int *); vector signed int vec_ld (int, const vector signed int *); vector signed int vec_ld (int, const int *); -vector signed int vec_ld (int, const long *); vector unsigned int vec_ld (int, const vector unsigned int *); vector unsigned int vec_ld (int, const unsigned int *); -vector unsigned int vec_ld (int, const unsigned long *); vector bool short vec_ld (int, const vector bool short *); vector pixel vec_ld (int, const vector pixel *); vector signed short vec_ld (int, const vector signed short *); @@ -16592,14 +16588,10 @@ vector unsigned short vec_lde (int, const unsigned vector float vec_lde (int, const float *); vector signed int vec_lde (int, const int *); vector unsigned int vec_lde (int, const unsigned int *); -vector signed int vec_lde (int, const long *); -vector unsigned int vec_lde (int, const unsigned long *); vector float vec_lvewx (int, float *); vector signed int vec_lvewx (int, int *); vector unsigned int vec_lvewx (int, unsigned int *); -vector signed int vec_lvewx (int, long *); -vector unsigned int vec_lvewx (int, unsigned long *); vector signed short vec_lvehx (int, short *); vector unsigned short vec_lvehx (int, unsigned short *); @@ -16612,10 +16604,8 @@ vector float vec_ldl (int, const float *); vector bool int vec_ldl (int, const vector bool int *); vector signed int vec_ldl (int, const vector signed int *); vector signed int vec_ldl (int, const int *); -vector signed int vec_ldl (int, const long *); vector unsigned int vec_ldl (int, const vector unsigned int *); vector unsigned int vec_ldl (int, const unsigned int *); -vector unsigned int vec_ldl (int, const unsigned long *); vector bool short vec_ldl (int, const vector bool short *); vector pixel vec_ldl (int, const vector pixel *); vector signed short vec_ldl (int, const vector signed short *); @@ -17143,8 +17133,6 @@ vector unsigned char vec_vrlb (vector unsigned cha vector float vec_round (vector float); -vector float vec_recip (vector float, vector float); - vector float vec_rsqrt (vector float); vector float vec_rsqrte (vector float); @@ -17558,8 +17546,6 @@ void vec_st (vector unsigned short, int, unsigned void vec_st (vector bool short, int, vector bool short *); void vec_st (vector bool short, int, unsigned short *); void vec_st (vector pixel, int, vector pixel *); -void vec_st (vector pixel, int, unsigned short *); -void vec_st (vector pixel, int, short *); void vec_st (vector bool short, int, short *); void vec_st (vector signed char, int, vector signed char *); void vec_st (vector signed char, int, signed char *); @@ -17595,8 +17581,6 @@ void vec_stvehx (vector signed short, int, short * void vec_stvehx (vector unsigned short, int, unsigned short *); void vec_stvehx (vector bool short, int, short *); void vec_stvehx (vector bool short, int, unsigned short *); -void vec_stvehx (vector pixel, int, short *); -void vec_stvehx (vector pixel, int, unsigned short *); void vec_stvebx (vector signed char, int, signed char *); void vec_stvebx (vector unsigned char, int, unsigned char *); @@ -17620,8 +17604,6 @@ void vec_stl (vector bool short, int, vector bool void vec_stl (vector bool short, int, unsigned short *); void vec_stl (vector bool short, int, short *); void vec_stl (vector pixel, int, vector pixel *); -void vec_stl (vector pixel, int, unsigned short *); -void vec_stl (vector pixel, int, short *); void vec_stl (vector signed char, int, vector signed char *); void vec_stl (vector signed char, int, signed char *); void vec_stl (vector unsigned char, int, vector unsigned char *); @@ -18577,8 +18559,6 @@ vector int vec_packs (vector long long, vector lon vector unsigned int vec_packs (vector unsigned long long, vector unsigned long long); -test_vsi_packsu_vssi_vssi (vector signed short x, - vector unsigned char vec_packsu (vector signed short, vector signed short ) vector unsigned char vec_packsu (vector unsigned short, vector unsigned short ) vector unsigned short int vec_packsu (vector signed int, vector signed int);