]> Savannah Git Hosting - gnulib.git/commitdiff
doc: Avoid some overfull lines in the TeX output.
authorWerner LEMBERG <wl@gnu.org>
Tue, 24 Jul 2018 00:46:14 +0000 (02:46 +0200)
committerBruno Haible <bruno@clisp.org>
Tue, 24 Jul 2018 00:46:14 +0000 (02:46 +0200)
* doc/glibc-functions/futimesat.texi: Replace a long @code with a
@example.
* doc/pastposix-functions/pthread_attr_getstackaddr.texi: Insert a
newline before the long URL.
* doc/pastposix-functions/pthread_attr_setstackaddr.texi: Likewise.
* doc/relocatable-maint.texi: Use @smallexample instead of @example.
Add line breaks in code snippets.

ChangeLog
doc/glibc-functions/futimesat.texi
doc/pastposix-functions/pthread_attr_getstackaddr.texi
doc/pastposix-functions/pthread_attr_setstackaddr.texi
doc/relocatable-maint.texi

index 7daeebe161eb52c94b8a797205499828c635b03a..79821f90d5f4b2c670e77a3f296b28f9b94f915d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2018-07-23  Werner LEMBERG  <wl@gnu.org>
+
+       doc: Avoid some overfull lines in the TeX output.
+       * doc/glibc-functions/futimesat.texi: Replace a long @code with a
+       @example.
+       * doc/pastposix-functions/pthread_attr_getstackaddr.texi: Insert a
+       newline before the long URL.
+       * doc/pastposix-functions/pthread_attr_setstackaddr.texi: Likewise.
+       * doc/relocatable-maint.texi: Use @smallexample instead of @example.
+       Add line breaks in code snippets.
+
 2018-07-17  Paul Eggert  <eggert@cs.ucla.edu>
 
        hard-locale: simplify by removing hard-locale.m4
index 73a9235f1936131405a3c97c6fdacf70d3a7175f..ac7bb615da44b0f0f7ed259a791c5146a30f12a5 100644 (file)
@@ -18,6 +18,11 @@ On some platforms, this function mis-handles trailing slash:
 Solaris 9.
 @item
 This function cannot set full timestamp resolution.  Use
-@code{file ? utimensat(fd,file,times,0) : futimens(fd,times)}, or the
-gnulib module fdutimensat, instead.
+
+@example
+file ? utimensat(fd, file, times, 0)
+     : futimens(fd, times)
+@end example
+
+@noindent or the gnulib module fdutimensat, instead.
 @end itemize
index a3cf1ac8a41803f66a1bc45d7d334933909d9ae2..d0aaf42bdab50936d805ff359c3510cd4ccfb0bd 100644 (file)
@@ -2,7 +2,8 @@
 @section @code{pthread_attr_getstackaddr}
 @findex pthread_attr_getstackaddr
 
-POSIX specification: @url{http://www.opengroup.org/susv3xsh/pthread_attr_getstackaddr.html}
+POSIX specification:@inlinefmt{tex,@*}
+@url{http://www.opengroup.org/susv3xsh/pthread_attr_getstackaddr.html}
 
 Gnulib module: ---
 
index 5c695abda1245009d3f6fad9e0a4a8333d633e8b..9e6b588da3c6c4a729a72e8ff9b41e997fd20433 100644 (file)
@@ -2,7 +2,8 @@
 @section @code{pthread_attr_setstackaddr}
 @findex pthread_attr_setstackaddr
 
-POSIX specification: @url{http://www.opengroup.org/susv3xsh/pthread_attr_setstackaddr.html}
+POSIX specification:@inlinefmt{tex,@*}
+@url{http://www.opengroup.org/susv3xsh/pthread_attr_setstackaddr.html}
 
 Gnulib module: ---
 
index 36cceb6223bfc346bf96492b723e32d6ebdeaa19..d1e7090bc08daecbc1d6c78363631aa5be050157 100644 (file)
@@ -120,7 +120,7 @@ If your package installs shell scripts, also import the
 @code{relocatable-script} module.  Then, near the beginning of each
 shell script that your package installs, add the following:
 
-@example
+@smallexample
 @@relocatable_sh@@
 if test "@@RELOCATABLE@@" = yes; then
   exec_prefix="@@exec_prefix@@"
@@ -142,7 +142,7 @@ fi
 # Get some relocated directory names.
 sysconfdir=`relocate "@@sysconfdir@@"`
 some_datadir=`relocate "@@datadir@@/something"`
-@end example
+@end smallexample
 
 You must adapt the definition of @code{orig_installdir}, depending on
 where the script gets installed.  Also, at the end, instead of
@@ -154,13 +154,16 @@ If your package installs Perl scripts, also import the
 @code{relocatable-perl} module.  Then, near the beginning of each
 Perl script that your package installs, add the following:
 
-@example
+@smallexample
 @@relocatable_pl@@
 if ("@@RELOCATABLE@@" eq "yes") @{
   my $exec_prefix = "@@exec_prefix@@";
   my $orig_installdir = "@@bindir@@"; # see Makefile.am's *_SCRIPTS variables
-  my ($orig_installprefix, $curr_installprefix) = find_prefixes($orig_installdir, find_curr_installdir());
-  sub relocate @{ # the subroutine is defined whether or not the enclosing block is executed
+  my ($orig_installprefix, $curr_installprefix) =
+    find_prefixes($orig_installdir, find_curr_installdir());
+
+  # the subroutine is defined whether or not the enclosing block is executed
+  sub relocate @{
     my ($dir) = @@_;
     if ("@@RELOCATABLE@@" eq "yes") @{
       $dir =~ s%^$orig_installprefix/%$curr_installprefix/%;
@@ -174,7 +177,7 @@ if ("@@RELOCATABLE@@" eq "yes") @{
 # (The gnulib module 'configmake' can help with this.)
 $sysconfdir = relocate("@@sysconfdir@@");
 $some_datadir = relocate(@@datadir@@/something");
-@end example
+@end smallexample
 
 You must adapt the definition of @code{$orig_installdir}, depending on
 where the script gets installed.  Also, at the end, instead of
@@ -211,9 +214,10 @@ endif
 
 @code{SHLIBS_IN_BINDIR} is defined in @file{configure.ac} as follows:
 
-@example
-AM_CONDITIONAL([SHLIBS_IN_BINDIR], [case "$host_os" in mingw* | cygwin*) true;; *) false;; esac])
-@end example
+@smallexample
+AM_CONDITIONAL([SHLIBS_IN_BINDIR],
+               [case "$host_os" in mingw* | cygwin*) true;; *) false;; esac])
+@end smallexample
 
 @item
 You may also need to add a couple of variable assignments to your