# Trouble generating info documentation

3 messages from 2008-01-02 to 2008-01-02. Participants: David Kastrup, Miklos Vajna, Junio C Hamano.
Thread: https://gitlist.dev/t/11449

## David Kastrup, 2008-01-02 12:37

Subject: Trouble generating info documentation
Message-ID: <86myrol7xf.fsf@lola.quinscape.zz>
URL: https://gitlist.dev/e/86myrol7xf.fsf%40lola.quinscape.zz

```

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, 2008-01-02 17:05

Subject: Re: Trouble generating info documentation
Message-ID: <20080102170556.GD29972@genesis.frugalware.org>
URL: https://gitlist.dev/e/20080102170556.GD29972%40genesis.frugalware.org
In-Reply-To: <86myrol7xf.fsf@lola.quinscape.zz>

```
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, 2008-01-02 18:59

Subject: Re: Trouble generating info documentation
Message-ID: <7vsl1gvysm.fsf@gitster.siamese.dyndns.org>
URL: https://gitlist.dev/e/7vsl1gvysm.fsf%40gitster.siamese.dyndns.org
In-Reply-To: <20080102170556.GD29972@genesis.frugalware.org>

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

```
