Trouble generating info documentation

Trouble generating info documentation

[David Kastrup]

[-- Attachment #1: Type: text/plain, Size: 102 bytes --]


Hi,

in my version of docbook2x, the --to-stdout option is broken and
requires the following patch:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Type: text/x-patch, Size: 654 bytes --]

diff -u -L /sudo:root@lola.quinscape.zz:/usr/bin/db2x_texixml -L /tmp/buffer-content-236002qn /tmp/tramp.23600D1t /tmp/buffer-content-236002qn
--- /tmp/buffer-content-236002qn
+++ /sudo:root@lola.quinscape.zz:/usr/bin/db2x_texixml
@@ -782,9 +782,11 @@
                 $openstr = '>-';
             }
         } else {
-            $openstr .= '> ' . shell_quote($filename);
-            print "$filename\n"
-                if $self->{options}->{'list-files'};
+	    if ($self->{options}->{'list-files'})
+	    {
+		$openstr .= '> ' . shell_quote($filename);
+		print "$filename\n";
+	    }
         }
     }
 

Diff finished.  Wed Jan  2 13:33:08 2008

[-- Attachment #3: Type: text/plain, Size: 1872 bytes --]


After fixing this (anybody got a clue how to get this upstream?) I get
the following problem upon make info:

makeinfo --no-split gitman.texi
gitman.texi:2462: Node `CO1-1' previously defined at line 1830.
gitman.texi:9205: Node `CO1-1' previously defined at line 1830.
gitman.texi:9206: Node `CO1-2' previously defined at line 2463.
gitman.texi:9207: Node `CO1-3' previously defined at line 2465.
gitman.texi:9229: Node `CO2-1' previously defined at line 1848.
gitman.texi:9230: Node `CO2-2' previously defined at line 1849.
gitman.texi:12904: Node `CO1-1' previously defined at line 1830.
gitman.texi:12905: Node `CO1-2' previously defined at line 2463.
gitman.texi:16075: warning: @strong{Note...} produces a spurious cross-reference in Info; reword to avoid that.
gitman.texi:18303: Node `CO1-1' previously defined at line 1830.
gitman.texi:18304: Node `CO1-2' previously defined at line 2463.
gitman.texi:18305: Node `CO1-3' previously defined at line 2465.
gitman.texi:18332: Node `CO2-1' previously defined at line 1848.
gitman.texi:18348: Node `CO3-1' previously defined at line 9254.
gitman.texi:18349: Node `CO3-2' previously defined at line 9255.
gitman.texi:18350: Node `CO3-3' previously defined at line 9256.
gitman.texi:18373: Node `CO4-1' previously defined at line 9277.
gitman.texi:18375: Node `CO4-2' previously defined at line 9278.
gitman.texi:18376: Node `CO4-3' previously defined at line 9279.
gitman.texi:18408: Node `CO5-1' previously defined at line 9301.
gitman.texi:18412: Node `CO5-2' previously defined at line 9302.
gitman.texi:22624: Node `CO1-1' previously defined at line 1830.
gitman.texi:22625: Node `CO1-2' previously defined at line 2463.
gitman.texi:22626: Node `CO1-3' previously defined at line 2465.
makeinfo: Removing output file `/rep/git/Documentation/gitman.info' due to errors; use --force to preserve.


-- 
David Kastrup

Re: Trouble generating info documentation

[Miklos Vajna]

[-- Attachment #1: Type: text/plain, Size: 295 bytes --]

On Wed, Jan 02, 2008 at 01:37:48PM +0100, David Kastrup <dak@gnu.org> wrote:
> in my version of docbook2x, the --to-stdout option is broken and
> requires the following patch:

according to the INSTALL file, you need docbook2X 0.8.3. the latest
stable 0.8.8 doesn't work here either.

- VMiklos

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: Trouble generating info documentation

[Junio C Hamano]

Miklos Vajna <vmiklos@frugalware.org> writes:

> On Wed, Jan 02, 2008 at 01:37:48PM +0100, David Kastrup <dak@gnu.org> wrote:
>> in my version of docbook2x, the --to-stdout option is broken and
>> requires the following patch:
>
> according to the INSTALL file, you need docbook2X 0.8.3. the latest
> stable 0.8.8 doesn't work here either.

Yuck.  Also docbook2x seems to be available even much less
widely than other tools we use for documentation, which is
double yuck.

For now the "info" pages need to stay as a second class citizen,
it appears.