# requesting info page (and pdf) doc releases

5 messages from 2009-10-22 to 2009-10-23. Participants: Sebastian Pipping, Rustom Mody, Michael J Gruber, Junio C Hamano.
Thread: https://gitlist.dev/t/21330

## Sebastian Pipping, 2009-10-22 20:41

Subject: requesting info page (and pdf) doc releases
Message-ID: <4AE0C362.3030900@gentoo.org>
URL: https://gitlist.dev/e/4AE0C362.3030900%40gentoo.org

```
hi there!


would be nice to get info pages (and pdf) doc releases in addition to
html and man pages.  i imagine such a change to the release machine
should not be too hard to integrate.  we could use it in gentoo.

thanks,



sebastian

```

## Rustom Mody, 2009-10-22 22:13

Subject: Re: requesting info page (and pdf) doc releases
Message-ID: <f46c52560910221513w1cb19949lfa05ef964987d809@mail.gmail.com>
URL: https://gitlist.dev/e/f46c52560910221513w1cb19949lfa05ef964987d809%40mail.gmail.com
In-Reply-To: <4AE0C362.3030900@gentoo.org>

```
On Fri, Oct 23, 2009 at 2:11 AM, Sebastian Pipping <sping@gentoo.org> wrote:
>
> hi there!
>
>
> would be nice to get info pages (and pdf) doc releases in addition to
> html and man pages.  i imagine such a change to the release machine
> should not be too hard to integrate.  we could use it in gentoo.
>
> thanks,
>
>
>
> sebastian

+1
Why only gentoo? I would use it on ubuntu or windows as well

```

## Michael J Gruber, 2009-10-23 08:39

Subject: Re: requesting info page (and pdf) doc releases
Message-ID: <4AE16BDE.1000103@drmicha.warpmail.net>
URL: https://gitlist.dev/e/4AE16BDE.1000103%40drmicha.warpmail.net
In-Reply-To: <f46c52560910221513w1cb19949lfa05ef964987d809@mail.gmail.com>

```
Rustom Mody venit, vidit, dixit 23.10.2009 00:13:
> On Fri, Oct 23, 2009 at 2:11 AM, Sebastian Pipping <sping@gentoo.org> wrote:
>>
>> hi there!
>>
>>
>> would be nice to get info pages (and pdf) doc releases in addition to
>> html and man pages.  i imagine such a change to the release machine
>> should not be too hard to integrate.  we could use it in gentoo.
>>
>> thanks,
>>
>>
>>
>> sebastian
> 
> +1
> Why only gentoo? I would use it on ubuntu or windows as well

Because they don't build from source!? ;)

Michael

```

## Junio C Hamano, 2009-10-23 18:57

Subject: Re: requesting info page (and pdf) doc releases
Message-ID: <7vtyxqaqg5.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7vtyxqaqg5.fsf%40alter.siamese.dyndns.org
In-Reply-To: <f46c52560910221513w1cb19949lfa05ef964987d809@mail.gmail.com>

```
Rustom Mody <rustompmody@gmail.com> writes:

> On Fri, Oct 23, 2009 at 2:11 AM, Sebastian Pipping <sping@gentoo.org> wrote:
>>
>> would be nice to get info pages (and pdf) doc releases in addition to
>> html and man pages.  i imagine such a change to the release machine
>> should not be too hard to integrate.  we could use it in gentoo.
>
> +1
> Why only gentoo? I would use it on ubuntu or windows as well

As I understand it, Gentoo is supposed to build everything from the source
anyway, you would not want to use pregenerated info nor pdf, no?  You
shouldn't be using pregenerated html nor man for that matter...

FWIW, you can already say "make info" and "make pdf" yourselves if you
have necessary toolchains installed.  Integration is not an issue.

Neither my primary development box (Debian, which I would test before
pushing things out) nor the machine at k.org I use for the final sanity
check (FC11, on which the documents are automatically generated) has
dblatex nor docbook2x installed.  I am not particularly enthused about
installing a lot of dependencies for these packages on my machine.  I do
not want to bother k.org admins who are already overloaded to install
these on their machines either.

```

## Sebastian Pipping, 2009-10-23 19:22

Subject: Re: requesting info page (and pdf) doc releases
Message-ID: <4AE20264.2060207@gentoo.org>
URL: https://gitlist.dev/e/4AE20264.2060207%40gentoo.org
In-Reply-To: <7vtyxqaqg5.fsf@alter.siamese.dyndns.org>

```
Junio C Hamano wrote:
> Rustom Mody <rustompmody@gmail.com> writes:
> 
>> On Fri, Oct 23, 2009 at 2:11 AM, Sebastian Pipping <sping@gentoo.org> wrote:
>>> would be nice to get info pages (and pdf) doc releases in addition to
>>> html and man pages.  i imagine such a change to the release machine
>>> should not be too hard to integrate.  we could use it in gentoo.
>> +1
>> Why only gentoo? I would use it on ubuntu or windows as well
> 
> As I understand it, Gentoo is supposed to build everything from the source
> anyway, you would not want to use pregenerated info nor pdf, no?  You
> shouldn't be using pregenerated html nor man for that matter...

With "compiling" documentation things are a bit different.
Simplified, in contrast to source code compiling documentation leads to
the same results on all machines while sources produces lots of
different results depending on the configuration of the machine ("use
flags", compile flags, versions of linked libraries, ..) which differ
heavily from one machine to another.

Generating documentation downstream means more dependencies for us
without any advantages that I would be aware of.  In case of dblatex the
dependencies get quite extreme actually :-)  So we thought why not just
ask for it if you provide similar things already.


> FWIW, you can already say "make info" and "make pdf" yourselves if you
> have necessary toolchains installed.  Integration is not an issue.

We use make info at the moment.  (On a sidenote I hope you get it
working with the latest asciidoc again.  See my earlier mail on this list.)


> Neither my primary development box (Debian, which I would test before
> pushing things out) nor the machine at k.org I use for the final sanity
> check (FC11, on which the documents are automatically generated) has
> dblatex nor docbook2x installed.  I am not particularly enthused about
> installing a lot of dependencies for these packages on my machine.  I do
> not want to bother k.org admins who are already overloaded to install
> these on their machines either.

I see, thanks for your explanation.



Sebastian

```
