From patchwork Tue Dec 6 10:55:21 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rical Jasan X-Patchwork-Id: 86739 Delivered-To: patch@linaro.org Received: by 10.140.20.101 with SMTP id 92csp1951683qgi; Tue, 6 Dec 2016 02:55:56 -0800 (PST) X-Received: by 10.84.216.24 with SMTP id m24mr63358112pli.26.1481021756686; Tue, 06 Dec 2016 02:55:56 -0800 (PST) Return-Path: Received: from sourceware.org (server1.sourceware.org. [209.132.180.131]) by mx.google.com with ESMTPS id k17si18945934pgh.279.2016.12.06.02.55.56 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 06 Dec 2016 02:55:56 -0800 (PST) Received-SPF: pass (google.com: domain of libc-alpha-return-75509-patch=linaro.org@sourceware.org designates 209.132.180.131 as permitted sender) client-ip=209.132.180.131; Authentication-Results: mx.google.com; dkim=pass header.i=@sourceware.org; spf=pass (google.com: domain of libc-alpha-return-75509-patch=linaro.org@sourceware.org designates 209.132.180.131 as permitted sender) smtp.mailfrom=libc-alpha-return-75509-patch=linaro.org@sourceware.org DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-type; q=dns; s=default; b=c9i2V k1GXoTVwn7ae11GshEoCyFX2IfqdQFM7nJS/Lwaa6OZ4GZMg0ddc/krmUzI3UmAJ lpnIb+Q+HMAUylN/UeXhwW+QXyJP8arqA4f0RTYKf2ogoGBBGcWj6eexUZceQYXj D4HX6NiD+DhJj708ruW+6Bj7DIVCGit9vFmncA= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-type; s=default; bh=gJgcjcIOfBe dfUyJIBt1M2p9GeU=; b=EporJw/Ci83dChUUt7XUBPr+zcUh5Fz1My8/UEdL8Xq UJW3r6sIlMe57VZDPcD1FJCu6yql/l0yzzZ++dRDcGNsSutrL9ZOHH9VDjkmw5LQ qH6HEevQJibi2VUky3w9BJJzrNoc7N/AqlYsYg/p83I5bO9iToJgdnP9O9OX1TnI = Received: (qmail 56762 invoked by alias); 6 Dec 2016 10:55:45 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Delivered-To: mailing list libc-alpha@sourceware.org Received: (qmail 56623 invoked by uid 89); 6 Dec 2016 10:55:41 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-4.7 required=5.0 tests=AWL, BAYES_00, RCVD_IN_DNSWL_NONE, RP_MATCHES_RCVD, SPF_PASS autolearn=ham version=3.3.2 spammy=merely, preparation, 16748, !!! X-HELO: mail.pacific.net From: Rical Jasan To: libc-alpha@sourceware.org Cc: joseph@codesourcery.com, mtk.manpages@gmail.com, carlos@redhat.com Subject: [PATCH v2 1/5] manual: Refactor header and standards annotations. Date: Tue, 6 Dec 2016 02:55:21 -0800 Message-Id: <20161206105525.21117-2-ricaljasan@pacific.net> In-Reply-To: <20161206105525.21117-1-ricaljasan@pacific.net> References: <20161206105525.21117-1-ricaljasan@pacific.net> MIME-Version: 1.0 X-Null-Tag: bd3ffbe20f67efdedd7846426c9d2395 This commit handles some initial cleanup, making sure any existing header and standards annotations conform to the expected syntax. * manual/filesys.texi: Refactor code in preparation for future work on header and standards annotations. * manual/llio.texi: Likewise. * manual/locale.texi: Likewise. * manual/time.texi: Likewise. * manual/users.texi: Likewise. --- manual/filesys.texi | 2 +- manual/llio.texi | 2 +- manual/locale.texi | 2 +- manual/time.texi | 2 +- manual/users.texi | 6 ++---- 5 files changed, 6 insertions(+), 8 deletions(-) diff --git a/manual/filesys.texi b/manual/filesys.texi index 26758e6..dc047c0 100644 --- a/manual/filesys.texi +++ b/manual/filesys.texi @@ -3559,9 +3559,9 @@ opening the file you should use the @code{O_EXCL} flag. Using @end deftypefun @cindex TMPDIR environment variable +@c !!! are we putting SVID/GNU/POSIX.1/BSD in here or not?? @comment stdio.h @comment SVID -@c !!! are we putting SVID/GNU/POSIX.1/BSD in here or not?? @deftypevr {SVID Macro} {char *} P_tmpdir This macro is the name of the default directory for temporary files. @end deftypevr diff --git a/manual/llio.texi b/manual/llio.texi index e2697aa..e4524bc 100644 --- a/manual/llio.texi +++ b/manual/llio.texi @@ -938,9 +938,9 @@ file descriptors belonging to the standard streams @code{stdin}, @code{stdout}, and @code{stderr}; see @ref{Standard Streams}. @pindex unistd.h +@table @code @comment unistd.h @comment POSIX.1 -@table @code @item STDIN_FILENO @vindex STDIN_FILENO This macro has value @code{0}, which is the file descriptor for diff --git a/manual/locale.texi b/manual/locale.texi index 780ce01..ae71ccc 100644 --- a/manual/locale.texi +++ b/manual/locale.texi @@ -1406,8 +1406,8 @@ English. @Theglibc{} contains @code{rpmatch} to give applications easy access to the corresponding locale definitions. -@comment GNU @comment stdlib.h +@comment GNU @deftypefun int rpmatch (const char *@var{response}) @safety{@prelim{}@mtsafe{@mtslocale{}}@asunsafe{@asucorrupt{} @ascuheap{} @asulock{} @ascudlopen{}}@acunsafe{@acucorrupt{} @aculock{} @acsmem{} @acsfd{}}} @c Calls nl_langinfo with YESEXPR and NOEXPR, triggering @mtslocale but diff --git a/manual/time.texi b/manual/time.texi index 6a899b7..e590c77 100644 --- a/manual/time.texi +++ b/manual/time.texi @@ -2740,9 +2740,9 @@ by @var{which} in the structure pointed at by @var{old}. The return value and error conditions are the same as for @code{setitimer}. @end deftypefun +@vtable @code @comment sys/time.h @comment BSD -@vtable @code @item ITIMER_REAL This constant can be used as the @var{which} argument to the @code{setitimer} and @code{getitimer} functions to specify the real-time diff --git a/manual/users.texi b/manual/users.texi index 0d94db1..0924f39 100644 --- a/manual/users.texi +++ b/manual/users.texi @@ -1674,8 +1674,7 @@ You can translate between a traditional @code{struct utmp} and an XPG these functions are merely copies, since the two structures are identical. -@comment utmpx.h -@comment utmp.h +@comment utmp.h utmpx.h @comment GNU @deftypefun int getutmp (const struct utmpx *@var{utmpx}, struct utmp *@var{utmp}) @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} @@ -1683,8 +1682,7 @@ identical. compatible, from @var{utmpx} to @var{utmp}. @end deftypefun -@comment utmpx.h -@comment utmp.h +@comment utmp.h utmpx.h @comment GNU @deftypefun int getutmpx (const struct utmp *@var{utmp}, struct utmpx *@var{utmpx}) @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}