From patchwork Tue Aug 13 13:24:53 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 1146361 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-506817-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=redhat.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="KurfcokG"; 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 467D3X56hWz9sDQ for ; Tue, 13 Aug 2019 23:25:12 +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:date :from:to:cc:subject:message-id:mime-version:content-type; q=dns; s=default; b=eBYl4OT7DNWUVUtTA+aM/QJOSEUMEGWctTjfH0e38Qr9nxGZS7 QA6unrLUJHQu9xC57KEX9pEOFtmMT5fbFjx1gngCg7OsRxiLYPQKbqVfa6oYYCdG NWayS0rqQLw0uIQQifypwZt1tey/I+4URwopUVUfoKPzb9bxGYOJvPqHI= 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:date :from:to:cc:subject:message-id:mime-version:content-type; s= default; bh=gvySsztX75IRkbsrMOwlWbEyNaQ=; b=KurfcokGnHjaMBdzxJ54 RAeYrpfHbIgRE7Nd+MsAjA5rrTApL+HFHHJjOuXWlYcXwmVx4PFSfvCu15JVvHLj etNZEIJ13GtLnSmyeE+yL7x+cjS4wfYtV4xbfPPp+EaM+LtMmX5p/TXcXaja3LOi vQUZ75okiwBHOOoci5uqAG8= Received: (qmail 26887 invoked by alias); 13 Aug 2019 13:25:05 -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 26555 invoked by uid 89); 13 Aug 2019 13:24:57 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-16.3 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_HELO_PASS autolearn=ham version=3.3.1 spammy= X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 13 Aug 2019 13:24:56 +0000 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 123F72F8BD5; Tue, 13 Aug 2019 13:24:55 +0000 (UTC) Received: from localhost (unknown [10.33.36.86]) by smtp.corp.redhat.com (Postfix) with ESMTP id AB1E760BE2; Tue, 13 Aug 2019 13:24:54 +0000 (UTC) Date: Tue, 13 Aug 2019 14:24:53 +0100 From: Jonathan Wakely To: gcc-patches@gcc.gnu.org Cc: Martin Liska Subject: [PATCH] Improve documentation of target hooks for libc functions Message-ID: <20190813132453.GF9487@redhat.com> MIME-Version: 1.0 Content-Disposition: inline X-Clacks-Overhead: GNU Terry Pratchett User-Agent: Mutt/1.12.0 (2019-05-25) * target.def (libc_has_function, libc_has_fast_function): Improve documentation strings. * doc/tm.texi: Regenerate. Bootstrapped x86_64-linux. OK for trunk? commit c3645cae6c78896218c60135349056a5bf943b8a Author: Jonathan Wakely Date: Tue Aug 13 14:01:01 2019 +0100 Improve documentation of target hooks for libc functions * target.def (libc_has_function, libc_has_fast_function): Improve documentation strings. * doc/tm.texi: Regenerate. diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index 8e5b01c9383..89990cbc871 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -5591,12 +5591,12 @@ macro, a reasonable default is used. @deftypefn {Target Hook} bool TARGET_LIBC_HAS_FUNCTION (enum function_class @var{fn_class}) This hook determines whether a function from a class of functions -@var{fn_class} is present at the runtime. +@var{fn_class} is present in the target C library. @end deftypefn @deftypefn {Target Hook} bool TARGET_LIBC_HAS_FAST_FUNCTION (int @var{fcode}) This hook determines whether a function from a class of functions -@var{fn_class} has a fast implementation. +@code{(enum function_class)}@var{fcode} has a fast implementation. @end deftypefn @defmac NEXT_OBJC_RUNTIME diff --git a/gcc/target.def b/gcc/target.def index 7cc0f37a0d1..73334e0e8fc 100644 --- a/gcc/target.def +++ b/gcc/target.def @@ -2545,14 +2545,14 @@ set via @code{__attribute__}.", DEFHOOK (libc_has_function, "This hook determines whether a function from a class of functions\n\ -@var{fn_class} is present at the runtime.", +@var{fn_class} is present in the target C library.", bool, (enum function_class fn_class), default_libc_has_function) DEFHOOK (libc_has_fast_function, "This hook determines whether a function from a class of functions\n\ -@var{fn_class} has a fast implementation.", +@code{(enum function_class)}@var{fcode} has a fast implementation.", bool, (int fcode), default_libc_has_fast_function)