Re: Documented toolchain for building docs on Windows

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Documented toolchain for building docs on Windows
Date: 2018-06-28 11:19:31
Message-ID: 4EC74690-CBD5-4C42-BEA3-30C85ECD904E@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 28 Jun 2018, at 12:39, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> wrote:
>
> On 6/28/18 12:17, Daniel Gustafsson wrote:
>> Section "17.1. Building with Visual C++ or the Microsoft Windows SDK” in the
>> documentation has a subsection "Building the Documentation” which seems to list
>> a required toolchain which is out of date with information in the Documentation
>> appendix (it still lists OpenJade etc).
>>
>> I don’t know anything about building on Windows so I might be off, but doesn’t
>> that need to be updated to match the new toolchain?
>
> Yes, I had complained about this before, but nobody responded. I can
> review a new text, but I can't write it.

Ah, my archive search skills are apparently lacking, thus the duplicate.

Looking at little more at this, the docs mention builddoc.bat which was
replaced in 2011 in favor of builddoc.pl. This program in turn is using
openjade and is thus, I assume, not working anymore.

Unless someone steps up before 11 is rolled, maybe builddoc.pl should be made
into a exit immediately no-op since "nothing" is better than “broken”?

cheers ./daniel

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2018-06-28 13:32:23 Re: Add Pgfe library to client interfaces
Previous Message Daniel Gustafsson 2018-06-28 11:00:47 search.cpan.org is EOL, update links