[prev in list] [next in list] [prev in thread] [next in thread] 

List:       coreutils
Subject:    makeinfo issue: `Realpath usage examples' has no Up field
From:       Bernhard Voelker <mail () bernhard-voelker ! de>
Date:       2017-09-04 22:20:38
Message-ID: a536d124-52a2-a3ef-5d87-8b8662d782f6 () bernhard-voelker ! de
[Download RAW message or body]

I'm getting the following error with older makeinfo (4.13):

  ./doc/coreutils.texi:14177: `Realpath usage examples' has no Up field (perhaps incorrect sectioning?).
  makeinfo: Removing output file `doc/coreutils.info' due to errors; use --force to preserve.

I know that we require much newer 6.1, but fixing this simple issue
seems tempting.  I don't know if this is the correct fix, and probably
adding a one-entry menu is stylistic bug, but it silences the error.
WDYT?

Have a nice day,
Berny


["0001-doc-fix-Up-field-of-realpath-examples.patch" (text/x-patch)]

>From ee0cdae2b188c20397e9be39dc0d219f2e8728c2 Mon Sep 17 00:00:00 2001
From: Bernhard Voelker <mail@bernhard-voelker.de>
Date: Tue, 5 Sep 2017 00:20:01 +0200
Subject: [PATCH] doc: fix Up field of realpath examples

Older versions of 'makeinfo' choke on a missing reference:

  ./doc/coreutils.texi:14177: `Realpath usage examples' has no Up field\
  (perhaps incorrect sectioning?).
  makeinfo: Removing output file `doc/coreutils.info' due to errors; \
  use --force to preserve.

* doc/coreutils.texi (realpath invocation): Add a menu referencing
the usage examples - introduced in v8.27-91-g7449f0d.
---
 doc/coreutils.texi | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index eb17462..8870b5a 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -14078,6 +14078,10 @@ Exit status:
 @pindex realpath
 @findex realpath
 
+@menu
+* Realpath usage examples::              Realpath usage examples.
+@end menu
+
 @command{realpath} expands all symbolic links and resolves references to
 @samp{/./}, @samp{/../} and extra @samp{/} characters.  By default,
 all but the last component of the specified files must exist.  Synopsis:
-- 
2.1.4



[prev in list] [next in list] [prev in thread] [next in thread]