From patchwork Sat Dec 14 17:33:15 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Sebor X-Patchwork-Id: 1209753 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=209.132.180.131; helo=sourceware.org; envelope-from=gcc-patches-return-515993-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.b="fPh6TwhK"; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="qHoC1M/c"; 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 47ZvlJ2PFQz9sP3 for ; Sun, 15 Dec 2019 04:33:29 +1100 (AEDT) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to :from:subject:message-id:date:mime-version:content-type; q=dns; s=default; b=KHVY7ij873qZLJ9ClhGOJdeLf0eSKhCYd4/xGimTk3AfA6ms7f /KKMGJcRbYUEgZhQqcY//znIQqKMZzAgQVVYOA7wRumpvkaYHPE6+qqgjqszK0Uv DaNLOmrUcYYtxJOsNKCQKQ4wM38AZOyK94LuWO4Y3aVbLWyEDZ2XayCDA= 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 :from:subject:message-id:date:mime-version:content-type; s= default; bh=CGFZ2mw4NUyQjbcs6oywMXjesx4=; b=fPh6TwhKgesBFAbLo34/ /Nm25VyrOfbzyrljfbf24ZSVCKO307H4mrMQUc0Gie099Zs6TgDJnPmr6qz0Z7aR +trcfXzzuvlHNXBIb9o8JW8GVbs8AUSV9ZiRJIVcQZ0wwUn65kvFOUXdjmgnUyMx w9XVvpFBwVG1NZRKRP0DKPg= Received: (qmail 32945 invoked by alias); 14 Dec 2019 17:33:21 -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 32932 invoked by uid 89); 14 Dec 2019 17:33:21 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-12.4 required=5.0 tests=AWL, BAYES_00, FREEMAIL_FROM, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_NONE, SPF_PASS autolearn=ham version=3.3.1 spammy=denotes, H*M:90a6, Wuninitialized, denoted X-HELO: mail-yb1-f173.google.com Received: from mail-yb1-f173.google.com (HELO mail-yb1-f173.google.com) (209.85.219.173) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 14 Dec 2019 17:33:19 +0000 Received: by mail-yb1-f173.google.com with SMTP id 63so1162961yba.2 for ; Sat, 14 Dec 2019 09:33:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:from:subject:message-id:date:user-agent:mime-version :content-language; bh=97g0nvD3qTizpP83h4/QT6/Hy67dtPCWsqHyIEoJzI0=; b=qHoC1M/ctFP90cbTuFo0IKazl4w9GDAZgMXLyVCMun5NBRKEwDWPjHwez8A+V8ryqY vQBGMmgorODCZubx0QO1JxiyYzq8i/QLO2E+rVNRfXn+VwUmD+BQw+hPPuwGQt4ULDmf x3mCBlnIKV1jvE3+HIQW3khF6WUEbpbRd610hAIo+ugn2ffELrGUFk3vlJKraOx8spKB i13Wg3LkhQ+AzMnC0bM6UWrQnRReipYPz1JGA9pithBdJJ0wJcS6pCK/XgPeMeOJ2wgx lXA8xww7BCr5H36UZo1s0NuAExjwAfA2JHkmU4W0tH3i9itLp6Vw9mnEci/0s/m1OGzT W23w== Received: from [192.168.0.41] (75-166-99-91.hlrn.qwest.net. [75.166.99.91]) by smtp.gmail.com with ESMTPSA id i17sm5939708ywg.66.2019.12.14.09.33.16 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 14 Dec 2019 09:33:16 -0800 (PST) To: gcc-patches From: Martin Sebor Subject: [committed] fix typos in attribute access Message-ID: <6ba90fc9-3b32-90a6-5481-77e585442cac@gmail.com> Date: Sat, 14 Dec 2019 10:33:15 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1 MIME-Version: 1.0 X-IsSubscribed: yes Committed in r279398. Martin gcc/ChangeLog: * doc/extend.texi (attribute access): Correct typos. Index: gcc/doc/extend.texi =================================================================== --- gcc/doc/extend.texi (revision 279397) +++ gcc/doc/extend.texi (working copy) @@ -2489,10 +2489,10 @@ The following attributes are supported on most tar @itemx access (@var{access-mode}, @var{ref-index}, @var{size-index}) The @code{access} attribute enables the detection of invalid or unsafe -accesses by functions to which they apply to or their callers, as well -as write-only accesses to objects that are never read from. Such accesses +accesses by functions to which they apply or their callers, as well as +write-only accesses to objects that are never read from. Such accesses may be diagnosed by warnings such as @option{-Wstringop-overflow}, -@option{-Wunnitialized}, @option{-Wunused}, and others. +@option{-Wuninitialized}, @option{-Wunused}, and others. The @code{access} attribute specifies that a function to whose by-reference arguments the attribute applies accesses the referenced object according to @@ -2501,13 +2501,13 @@ one of three names: @code{read_only}, @code{read_w The remaining two are positional arguments. The required @var{ref-index} positional argument denotes a function -argument of pointer (or in C++, refeference) type that is subject to +argument of pointer (or in C++, reference) type that is subject to the access. The same pointer argument can be referenced by at most one distinct @code{access} attribute. The optional @var{size-index} positional argument denotes a function argument of integer type that specifies the maximum size of the access. -The size is the number of elements of the type refefenced by @var{ref-index}, +The size is the number of elements of the type referenced by @var{ref-index}, or the number of bytes when the pointer type is @code{void*}. When no @var{size-index} argument is specified, the pointer argument must be either null or point to a space that is suitably aligned and large for at least one @@ -2520,10 +2520,10 @@ applies is used to read the referenced object but the argument specifying the size of the access denoted by @var{size-index} is zero, the referenced object must be initialized. The mode implies a stronger guarantee than the @code{const} qualifier which, when cast away -from a pointer, does not prevent a function from modifying the pointed-to -object. Examples of the use of the @code{read_only} access mode is -the argument to the @code{puts} function, or the second and third arguments -to the @code{memcpy} function. +from a pointer, does not prevent the pointed-to object from being modified. +Examples of the use of the @code{read_only} access mode is the argument to +the @code{puts} function, or the second and third arguments to +the @code{memcpy} function. @smallexample __attribute__ ((access (read_only))) int puts (const char*); @@ -2534,7 +2534,7 @@ The @code{read_write} access mode applies to argum without the @code{const} qualifier. It specifies that the pointer to which it applies is used to both read and write the referenced object. Unless the argument specifying the size of the access denoted by @var{size-index} -is zero, the object refrenced by the pointer must be initialized. An example +is zero, the object referenced by the pointer must be initialized. An example of the use of the @code{read_write} access mode is the first argument to the @code{strcat} function.