manual: Drop obsolete @refill

Message ID
State New
Headers show
  • manual: Drop obsolete @refill
Related show

Commit Message

Sunil K Pandey via Libc-alpha Jan. 12, 2022, 6:09 a.m.
The @refill command has been obsolete for a while and now texinfo has
started warning about it.

Signed-off-by: Siddhesh Poyarekar <>

 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(-)



Sunil K Pandey via Libc-alpha Jan. 12, 2022, 8:47 a.m. | #1
* Siddhesh Poyarekar via Libc-alpha:

> The @refill command has been obsolete for a while and now texinfo has

> started warning about it.


> Signed-off-by: Siddhesh Poyarekar <>

Looks okay.

Reviewed-by: Florian Weimer <>



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.
 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}
 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,,,, The GNU C Preprocessor
 @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.
 @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:
 # BSD has Internet-related things.
@@ -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
 There are a few special files that may exist in each subdirectory of
@@ -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
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
 This function is a GNU extension.
 @end deftypefun