From 5916dec460f2e0eec1d792d502a79f11628862c9 Mon Sep 17 00:00:00 2001
From: Jim Meyering <meyering@redhat.com>
Date: Tue, 1 Apr 2008 11:38:02 +0200
Subject: [PATCH] printf doc: xref print(3) and libc's "Output Conversion
 Syntax" node

* coreutils.texi (printf invocation): Add xref.
Use "The GNU C Library Reference Manual" as the name of the 'libc'
document consistently.
* man/printf.x: Add See also: printf(3).
Suggested by A. Costa in http://bugs.debian.org/465522
---
 doc/coreutils.texi | 19 +++++++++++--------
 man/printf.x       |  2 ++
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index f161c4d..2745edf 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2181,7 +2181,7 @@ locale, the default is @samp{%b %e %H:%M %Y} (for example,
 Time stamps are listed according to the time zone rules specified by
 the @env{TZ} environment variable, or by the system default rules if
 @env{TZ} is not set.  @xref{TZ Variable,, Specifying the Time Zone
-with @env{TZ}, libc, The GNU C Library}.
+with @env{TZ}, libc, The GNU C Library Reference Manual}.
 
 @item -e[@var{in-tabchar}[@var{in-tabwidth}]]
 @itemx --expand-tabs[=@var{in-tabchar}[@var{in-tabwidth}]]
@@ -6584,7 +6584,7 @@ programs like @command{make} that rely on file timestamps.
 Time stamps are listed according to the time zone rules specified by
 the @env{TZ} environment variable, or by the system default rules if
 @env{TZ} is not set.  @xref{TZ Variable,, Specifying the Time Zone
-with @env{TZ}, libc, The GNU C Library}.
+with @env{TZ}, libc, The GNU C Library Reference Manual}.
 
 The following option changes how file timestamps are printed.
 
@@ -9353,7 +9353,8 @@ operations, for a user to change the ctime field to a user-specified value.
 Time stamps assume the time zone rules specified by the @env{TZ}
 environment variable, or by the system default rules if @env{TZ} is
 not set.  @xref{TZ Variable,, Specifying the Time Zone with @env{TZ},
-libc, The GNU C Library}.  You can avoid ambiguities during
+libc, The GNU C Library Reference Manual}.
+You can avoid ambiguities during
 daylight saving transitions by using @sc{utc} time stamps.
 
 The program accepts the following options.  Also see @ref{Common options}.
@@ -10077,7 +10078,7 @@ The valid format sequences for file systems are:
 Time stamps are listed according to the time zone rules specified by
 the @env{TZ} environment variable, or by the system default rules if
 @env{TZ} is not set.  @xref{TZ Variable,, Specifying the Time Zone
-with @env{TZ}, libc, The GNU C Library}.
+with @env{TZ}, libc, The GNU C Library Reference Manual}.
 @end table
 
 @exitstatus
@@ -10225,8 +10226,10 @@ printf @var{format} [@var{argument}]@dots{}
 
 @command{printf} prints the @var{format} string, interpreting @samp{%}
 directives and @samp{\} escapes to format numeric and string arguments
-in a way that is mostly similar to the C @samp{printf} function.  The
-differences are as follows:
+in a way that is mostly similar to the C @samp{printf} function.
+@xref{Output Conversion Syntax,, @command{printf} format directives,
+libc, The GNU C Library Reference Manual}, for details.
+The differences are as follows:
 
 @itemize @bullet
 
@@ -12406,7 +12409,7 @@ i}, as in @samp{who am i}.
 Time stamps are listed according to the time zone rules specified by
 the @env{TZ} environment variable, or by the system default rules if
 @env{TZ} is not set.  @xref{TZ Variable,, Specifying the Time Zone
-with @env{TZ}, libc, The GNU C Library}.
+with @env{TZ}, libc, The GNU C Library Reference Manual}.
 
 The program accepts the following options.  Also see @ref{Common options}.
 
@@ -12546,7 +12549,7 @@ so the output looks like @samp{Thu Mar @ 3 13:47:51 PST 2005}.
 Normally, @command{date} uses the time zone rules indicated by the
 @env{TZ} environment variable, or the system default rules if @env{TZ}
 is not set.  @xref{TZ Variable,, Specifying the Time Zone with
-@env{TZ}, libc, The GNU C Library}.
+@env{TZ}, libc, The GNU C Library Reference Manual}.
 
 @findex strftime @r{and @command{date}}
 @cindex time formats
diff --git a/man/printf.x b/man/printf.x
index 6489ec5..22fc5af 100644
--- a/man/printf.x
+++ b/man/printf.x
@@ -2,3 +2,5 @@
 printf \- format and print data
 [DESCRIPTION]
 .\" Add any additional description here
+[SEE ALSO]
+printf(3)
-- 
2.7.4