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: 703089 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org 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 3tXz7Y15bmz9t1B for ; Tue, 6 Dec 2016 21:55:52 +1100 (AEDT) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.b="lgz9L5kf"; dkim-atps=neutral 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=VufDq PCIU3FG+UIAJxu1E3J4UXFgIkjIq3i81oZXl4vN3jHwEt4UGascdHele1O6aSsOW QcQKCHK4jtwmx+/2orOx3MwRFhjHud4lgMzx6sjY7Gkcz7alO4ERXITzobotv1xS UPG06PIfnbQ2P9GFlPGLohf3beBn8Q2fBAx3sc= 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=lgz9L5kf7xltKYOE6w9roUVgaa5UEGaF3bTG36rIwQ3 RdYvBVS1LncaP8GFntPPcOPVxM7eW5V1yMbzb+lFb2DPHBXQhb6LwXa0QwyFaJAS AYV6t7TgRzu0vEBk9tOcmlg40UfXL8fkPBLafv1PiH5rGqMhnPTollF5u+iCV3xM = 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{}}