Horton

Thread

Commits

  1. Remove obsolete documentation build tools for Windows

  2. Replace search.cpan.org with metacpan.org

  1. Documented toolchain for building docs on Windows

    Daniel Gustafsson <daniel@yesql.se> — 2018-06-28T10:17:39Z

    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? 

cheers ./daniel

  2. Re: Documented toolchain for building docs on Windows

    Peter Eisentraut <peter.eisentraut@2ndquadrant.com> — 2018-06-28T10:39:43Z

    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.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

  3. Re: Documented toolchain for building docs on Windows

    Daniel Gustafsson <daniel@yesql.se> — 2018-06-28T11:19:31Z

    > On 28 Jun 2018, at 12:39, Peter Eisentraut <peter.eisentraut@2ndquadrant.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

  4. Re: Documented toolchain for building docs on Windows

    Peter Eisentraut <peter.eisentraut@2ndquadrant.com> — 2018-06-29T13:08:39Z

    On 6/28/18 13:19, Daniel Gustafsson wrote:
> 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”?

I'm thinking, just delete the file and the documentation section.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

  5. Re: Documented toolchain for building docs on Windows

    Daniel Gustafsson <daniel@yesql.se> — 2018-06-29T16:51:03Z

    > On 29 Jun 2018, at 15:08, Peter Eisentraut <peter.eisentraut@2ndquadrant.com> wrote:
> 
> On 6/28/18 13:19, Daniel Gustafsson wrote:
>> 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”?
> 
> I'm thinking, just delete the file and the documentation section.

Well, that's a pretty decisive way to make it a no-op =) The attached patch
does that, along with a note in the relnotes to highlight the dropped support
which I think is warranted should we take this approach.

cheers ./daniel

  6. Re: Documented toolchain for building docs on Windows

    Peter Eisentraut <peter.eisentraut@2ndquadrant.com> — 2018-07-13T08:09:00Z

    On 29.06.18 18:51, Daniel Gustafsson wrote:
>> On 29 Jun 2018, at 15:08, Peter Eisentraut <peter.eisentraut@2ndquadrant.com> wrote:
>>
>> On 6/28/18 13:19, Daniel Gustafsson wrote:
>>> 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”?
>>
>> I'm thinking, just delete the file and the documentation section.
> 
> Well, that's a pretty decisive way to make it a no-op =) The attached patch
> does that, along with a note in the relnotes to highlight the dropped support
> which I think is warranted should we take this approach.

I have committed this to master now.  The scripts have already been
broken since PG10, so mentioning it in the PG11 release notes doesn't
seem appropriate.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

  7. Re: Documented toolchain for building docs on Windows

    Daniel Gustafsson <daniel@yesql.se> — 2018-07-13T22:23:53Z

    > On 13 Jul 2018, at 10:09, Peter Eisentraut <peter.eisentraut@2ndquadrant.com> wrote:
> 
> On 29.06.18 18:51, Daniel Gustafsson wrote:
>>> On 29 Jun 2018, at 15:08, Peter Eisentraut <peter.eisentraut@2ndquadrant.com> wrote:
>>> 
>>> On 6/28/18 13:19, Daniel Gustafsson wrote:
>>>> 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”?
>>> 
>>> I'm thinking, just delete the file and the documentation section.
>> 
>> Well, that's a pretty decisive way to make it a no-op =) The attached patch
>> does that, along with a note in the relnotes to highlight the dropped support
>> which I think is warranted should we take this approach.
> 
> I have committed this to master now.  The scripts have already been
> broken since PG10, so mentioning it in the PG11 release notes doesn't
> seem appropriate.

Ok, that makes sense. Thanks!

cheers ./daniel

  8. Re: Documented toolchain for building docs on Windows

    Michail Nikolaev <michail.nikolaev@gmail.com> — 2018-07-18T09:17:57Z

    Hello.

Also, please check
http://www.postgresql-archive.org/PATCH-Updating-documentation-about-bulding-documentation-in-Windows-tp6002394.html

I have done the same on 23 Jan + additional docs on how to build
documentation using Windows Linux Subsystem :)

It will be cool to include docs about WLS method.

Thanks,
Michail.



сб, 14 июл. 2018 г. в 1:24, Daniel Gustafsson <daniel@yesql.se>:

> > On 13 Jul 2018, at 10:09, Peter Eisentraut <
> peter.eisentraut@2ndquadrant.com> wrote:
> >
> > On 29.06.18 18:51, Daniel Gustafsson wrote:
> >>> On 29 Jun 2018, at 15:08, Peter Eisentraut <
> peter.eisentraut@2ndquadrant.com> wrote:
> >>>
> >>> On 6/28/18 13:19, Daniel Gustafsson wrote:
> >>>> 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”?
> >>>
> >>> I'm thinking, just delete the file and the documentation section.
> >>
> >> Well, that's a pretty decisive way to make it a no-op =) The attached
> patch
> >> does that, along with a note in the relnotes to highlight the dropped
> support
> >> which I think is warranted should we take this approach.
> >
> > I have committed this to master now.  The scripts have already been
> > broken since PG10, so mentioning it in the PG11 release notes doesn't
> > seem appropriate.
>
> Ok, that makes sense. Thanks!
>
> cheers ./daniel
>

  9. Re: Documented toolchain for building docs on Windows

    Peter Eisentraut <peter.eisentraut@2ndquadrant.com> — 2018-07-22T21:27:31Z

    On 18.07.18 11:17, Michail Nikolaev wrote:
> Also, please
> check http://www.postgresql-archive.org/PATCH-Updating-documentation-about-bulding-documentation-in-Windows-tp6002394.html
> 
> I have done the same on 23 Jan + additional docs on how to build
> documentation using Windows Linux Subsystem :)

It doesn't seem that that documentation is very much about how to build
the documentation on WLS.  It's just a description of how to set up a
PostgreSQL build environment under WLS and then ... see the Unix build
instructions.  That's nice, but then it's not in the right place in the
documentation.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services