From patchwork Wed Jan 12 06:09:04 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Siddhesh Poyarekar X-Patchwork-Id: 49898 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 4678238A9415 for ; Wed, 12 Jan 2022 06:09:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4678238A9415 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1641967779; bh=pXn4Twxxjmb4+U84a4zatT/LSkF8W8SxjRoYsffs6j8=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=JQO3g5VRLG/f6SJfOwf2uXjBvwHW13Vh4+3/xIBnWYydRh0zMe6eO83SqSmfV9Vmk kWAoRpwuJN9vZLengaeA8OShQCAt2ibq0VUF1jbZuAAFmeo8T9m8SxML+jFVfHofb1 lgxkzeOiBveXillcMW7MVMBwwZ5rdbimodkpvvLM= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from cyan.elm.relay.mailchannels.net (cyan.elm.relay.mailchannels.net [23.83.212.47]) by sourceware.org (Postfix) with ESMTPS id EB6013858416 for ; Wed, 12 Jan 2022 06:09:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org EB6013858416 X-Sender-Id: dreamhost|x-authsender|siddhesh@gotplt.org Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id D7A4F2A1462; Wed, 12 Jan 2022 06:09:15 +0000 (UTC) Received: from pdx1-sub0-mail-a305.dreamhost.com (unknown [127.0.0.6]) (Authenticated sender: dreamhost) by relay.mailchannels.net (Postfix) with ESMTPA id 4D7D12A0CB8; Wed, 12 Jan 2022 06:09:15 +0000 (UTC) X-Sender-Id: dreamhost|x-authsender|siddhesh@gotplt.org Received: from pdx1-sub0-mail-a305.dreamhost.com (pop.dreamhost.com [64.90.62.162]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.96.96.32 (trex/6.4.3); Wed, 12 Jan 2022 06:09:15 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: dreamhost|x-authsender|siddhesh@gotplt.org X-MailChannels-Auth-Id: dreamhost X-Cooperative-Stretch: 638240555135916d_1641967755727_4120371199 X-MC-Loop-Signature: 1641967755727:3064960149 X-MC-Ingress-Time: 1641967755726 Received: from rhbox.redhat.com (unknown [1.186.121.232]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: siddhesh@gotplt.org) by pdx1-sub0-mail-a305.dreamhost.com (Postfix) with ESMTPSA id 4JYcZx4gJDz2t; Tue, 11 Jan 2022 22:09:13 -0800 (PST) To: libc-alpha@sourceware.org Subject: [PATCH] manual: Drop obsolete @refill Date: Wed, 12 Jan 2022 11:39:04 +0530 Message-Id: <20220112060904.3774521-1-siddhesh@sourceware.org> X-Mailer: git-send-email 2.33.1 MIME-Version: 1.0 X-Spam-Status: No, score=-3494.5 required=5.0 tests=BAYES_00, GIT_PATCH_0, JMQ_SPF_NEUTRAL, KAM_DMARC_NONE, KAM_DMARC_STATUS, RCVD_IN_BARRACUDACENTRAL, RCVD_IN_DNSWL_NONE, RCVD_IN_SBL, SPF_HELO_NONE, SPF_NEUTRAL, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Siddhesh Poyarekar via Libc-alpha From: Siddhesh Poyarekar Reply-To: Siddhesh Poyarekar Errors-To: libc-alpha-bounces+patchwork=sourceware.org@sourceware.org Sender: "Libc-alpha" The @refill command has been obsolete for a while and now texinfo has started warning about it. Signed-off-by: Siddhesh Poyarekar Reviewed-by: Florian Weimer --- manual/contrib.texi | 2 +- manual/creature.texi | 2 +- manual/ctype.texi | 4 ++-- manual/intro.texi | 6 +++--- manual/lang.texi | 2 +- manual/maint.texi | 16 ++++++++-------- manual/memory.texi | 2 +- manual/setjmp.texi | 2 +- manual/stdio.texi | 4 ++-- manual/string.texi | 2 +- 10 files changed, 21 insertions(+), 21 deletions(-) diff --git a/manual/contrib.texi b/manual/contrib.texi index 8ea53e5653..2a25202e30 100644 --- a/manual/contrib.texi +++ b/manual/contrib.texi @@ -525,7 +525,7 @@ The random number generation functions @code{random}, @code{srandom}, for the University of California at Berkeley and are copyrighted by the Regents of the University of California. They have undergone minor changes to fit into @theglibc{} and to fit the @w{ISO C} standard, -but the functional code is Berkeley's.@refill +but the functional code is Berkeley's. @item The Internet-related code (most of the @file{inet} subdirectory) and diff --git a/manual/creature.texi b/manual/creature.texi index 6193e0735c..530a02398e 100644 --- a/manual/creature.texi +++ b/manual/creature.texi @@ -9,7 +9,7 @@ If you compile your programs using @samp{gcc -ansi}, you get only the @w{ISO C} library features, unless you explicitly request additional features by defining one or more of the feature macros. @xref{Invoking GCC,, GNU CC Command Options, gcc, The GNU CC Manual}, -for more information about GCC options.@refill +for more information about GCC options. You should define these macros by using @samp{#define} preprocessor directives at the top of your source code files. These directives diff --git a/manual/ctype.texi b/manual/ctype.texi index d0618c5c38..88e3523dc4 100644 --- a/manual/ctype.texi +++ b/manual/ctype.texi @@ -57,7 +57,7 @@ character argument is passed as an @code{int}, and it may be the constant value @code{EOF} instead of a real character. The attributes of any given character can vary between locales. -@xref{Locales}, for more information on locales.@refill +@xref{Locales}, for more information on locales. These functions are declared in the header file @file{ctype.h}. @pindex ctype.h @@ -265,7 +265,7 @@ bits. This function is a BSD extension and is also an SVID extension. @standards{SVID, ctype.h} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} This is identical to @code{tolower}, and is provided for compatibility -with the SVID. @xref{SVID}.@refill +with the SVID. @xref{SVID}. @end deftypefun @deftypefun int _toupper (int @var{c}) diff --git a/manual/intro.texi b/manual/intro.texi index 779fec8f3d..9bdfd09c83 100644 --- a/manual/intro.texi +++ b/manual/intro.texi @@ -99,7 +99,7 @@ by the International Standardization Organization (ISO): We here refer to the standard as @w{ISO C} since this is the more general standard in respect of ratification. The header files and library facilities that make up @theglibc{} are -a superset of those specified by the @w{ISO C} standard.@refill +a superset of those specified by the @w{ISO C} standard. @pindex gcc If you are concerned about strict adherence to the @w{ISO C} standard, you @@ -144,7 +144,7 @@ general, the additional requirements and functionality defined by the POSIX standards are aimed at providing lower-level support for a particular kind of operating system environment, rather than general programming language support which can run in many diverse operating -system environments.@refill +system environments. @Theglibc{} implements all of the functions specified in @cite{ISO/IEC 9945-1:1996, the POSIX System Application Program @@ -1035,7 +1035,7 @@ feature test macro definition (@pxref{Feature Test Macros}). For more information about the use of header files and @samp{#include} directives, @pxref{Header Files,,, cpp.info, The GNU C Preprocessor -Manual}.@refill +Manual}. @Theglibc{} provides several header files, each of which contains the type and macro definitions and variable and function declarations diff --git a/manual/lang.texi b/manual/lang.texi index ca90a59f8f..40cd9ddd77 100644 --- a/manual/lang.texi +++ b/manual/lang.texi @@ -459,7 +459,7 @@ was invoked with the same @var{ap} argument. In @theglibc{}, @code{va_end} does nothing, and you need not ever use it except for reasons of portability. -@refill + @end deftypefn Sometimes it is necessary to parse the list of parameters more than once diff --git a/manual/maint.texi b/manual/maint.texi index ec234e15d7..49510db7bf 100644 --- a/manual/maint.texi +++ b/manual/maint.texi @@ -52,7 +52,7 @@ complete file names, such as @file{strlen.c}). Use @code{routines} for modules that define functions in the library, and @code{aux} for auxiliary modules containing things like data definitions. But the values of @code{routines} and @code{aux} are just concatenated, so there -really is no practical difference.@refill +really is no practical difference. @item tests The names of test programs for this section of the library. These @@ -70,7 +70,7 @@ indicates a bug in the library or error in building. The names of ``other'' programs associated with this section of the library. These are programs which are not tests per se, but are other small programs included with the library. They are built by -@w{@samp{make others}}.@refill +@w{@samp{make others}}. @item install-lib @itemx install-data @@ -82,7 +82,7 @@ Files to be installed by @w{@samp{make install}}. Files listed in installed in the directory specified by @samp{datadir} in @file{configparms} or @file{Makeconfig}. Files listed in @code{install} are installed in the directory specified by @samp{bindir} in -@file{configparms} or @file{Makeconfig}.@refill +@file{configparms} or @file{Makeconfig}. @item distribute Other files from this subdirectory which should be put into a @@ -337,7 +337,7 @@ subdirectory, it lists other subdirectories of @file{sysdeps} which are appended to the list, appearing after the subdirectory containing the @file{Implies} file. Lines in an @file{Implies} file that begin with a @samp{#} character are ignored as comments. For example, -@file{unix/bsd/Implies} contains:@refill +@file{unix/bsd/Implies} contains: @smallexample # BSD has Internet-related things. unix/inet @@ -388,7 +388,7 @@ operating system-dependent version of it, move the file into @file{sysdeps/generic} and write your new implementation in the appropriate system-specific subdirectory. Note that if a file is to be system-dependent, it @strong{must not} appear in one of the main source -directories.@refill +directories. There are a few special files that may exist in each subdirectory of @file{sysdeps}: @@ -408,7 +408,7 @@ the library. It can also set the @code{make} variable @samp{sysdep-routines}, to specify extra modules to be included in the library. You should use @samp{sysdep-routines} rather than adding modules to @samp{routines} because the latter is used in determining -what to distribute for each subdirectory of the main source tree.@refill +what to distribute for each subdirectory of the main source tree. Each makefile in a subdirectory in the ordered list of subdirectories to be searched is included in order. Since several system-dependent @@ -433,7 +433,7 @@ files that should go into the library for the system this subdirectory of @file{sysdeps} implements. For example, @file{sysdeps/unix/inet/Subdirs} contains @file{inet}; the @file{inet} directory contains various network-oriented operations which only make -sense to put in the library on systems that support the Internet.@refill +sense to put in the library on systems that support the Internet. @item configure @@ -625,7 +625,7 @@ partially defines them; a @file{sysdep.h} file in another directory must finish defining them for the particular machine and operating system variant. See @file{sysdeps/unix/sysdep.h} and the machine-specific @file{sysdep.h} implementations to see what these macros are and what -they should do.@refill +they should do. The system-specific makefile for the @file{unix} directory (@file{sysdeps/unix/Makefile}) gives rules to generate several files diff --git a/manual/memory.texi b/manual/memory.texi index 0b2b9c8795..23a039c57e 100644 --- a/manual/memory.texi +++ b/manual/memory.texi @@ -2796,7 +2796,7 @@ To illustrate this, suppose you have a function fails. If the file cannot be opened, it prints an error message and jumps out to the command level of your program using @code{longjmp}. Let's change @code{open2} (@pxref{Alloca Example}) to use this -subroutine:@refill +subroutine: @smallexample int diff --git a/manual/setjmp.texi b/manual/setjmp.texi index 17bdcaec99..7092a0dde2 100644 --- a/manual/setjmp.texi +++ b/manual/setjmp.texi @@ -136,7 +136,7 @@ This function restores current execution to the state saved in established that return point. Returning from @code{setjmp} by means of @code{longjmp} returns the @var{value} argument that was passed to @code{longjmp}, rather than @code{0}. (But if @var{value} is given as -@code{0}, @code{setjmp} returns @code{1}).@refill +@code{0}, @code{setjmp} returns @code{1}). @end deftypefun There are a lot of obscure but important restrictions on the use of diff --git a/manual/stdio.texi b/manual/stdio.texi index 1fac8e5f78..753c50920d 100644 --- a/manual/stdio.texi +++ b/manual/stdio.texi @@ -2532,7 +2532,7 @@ obstack @var{obstack} to allocate the space. @xref{Obstacks}. The characters are written onto the end of the current object. To get at them, you must finish the object with @code{obstack_finish} -(@pxref{Growing Objects}).@refill +(@pxref{Growing Objects}). @end deftypefun @node Variable Arguments Output @@ -2696,7 +2696,7 @@ variable argument list specified directly as for @code{vprintf}. @c inconsistent state in case of cancellation. The @code{obstack_vprintf} function is the equivalent of @code{obstack_printf} with the variable argument list specified directly -as for @code{vprintf}.@refill +as for @code{vprintf}. @end deftypefun Here's an example showing how you might use @code{vfprintf}. This is a diff --git a/manual/string.texi b/manual/string.texi index 7ca5ff6c94..0b60b3fbb4 100644 --- a/manual/string.texi +++ b/manual/string.texi @@ -1921,7 +1921,7 @@ strcasestr ("hello, World", "wo") This is like @code{strstr}, but @var{needle} and @var{haystack} are byte arrays rather than strings. @var{needle-len} is the length of @var{needle} and @var{haystack-len} is the length of -@var{haystack}.@refill +@var{haystack}. This function is a GNU extension. @end deftypefun