Trouble generating info documentation

David Kastrup· Jan 2, 2008, 12:37 UTC · lore

Hi,

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

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



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

Miklos Vajna· Jan 2, 2008, 17:05 UTC · re: David Kastrup · lore

Re: Trouble generating info documentation

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

Junio C Hamano· Jan 2, 2008, 18:59 UTC · re: Miklos Vajna · lore

Re: Trouble generating info documentation

Miklos Vajna <vmiklos@frugalware.org> writes:

Show 6 quoted lines

> 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.