Re: Documented toolchain for building docs on Windows

2018-07-22 Thread Peter Eisentraut
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



Re: Images in the official documentation

2018-07-22 Thread Jürgen Purtz
Because I strongly support the involvement of SVG into our 
documentation, I welcome every activity to establish this goal. The mail 
to which Pavel had replied 
(https://www.postgresql.org/message-id/4ea1bacb-02ca-e967-31d7-d2a6db30abff%40purtz.de) 
contained the two graphics /PageLayout.svg/ "Page Layout" and 
/pgDump.svg/ "pg_dump, psql, pg_restore". Actually they are *not* part 
of our documentation. They are only part of a proof-of-concept to 
generate SVG and include the result into HTML and PDF output. The two 
examples can be used as references for comparisons with any tool.


Kind regards, Jürgen


On 20.07.2018 18:14, Pavel Golub wrote:

Hello, Jürgen.

You wrote:


JP> On 19.07.2018 14:06, Pavel Golub wrote:

I disagree. From what I heard, GraphViz is the winner for now. I can
give you my two cents: plantuml is another good choice

JP> Ok, please give us an example - possibly the two previous graphics.

Fair enough. Let's try different formats. Sorry, what exactly previous
graphics we're talking about?

JP> Kind regards, Jürgen