Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ef023-0001kn-Ts for pgsql-docs@arkaria.postgresql.org; Fri, 26 Jan 2018 09:10:48 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ef022-0005A8-VA for pgsql-docs@arkaria.postgresql.org; Fri, 26 Jan 2018 09:10:46 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1ef022-00059s-Ln for pgsql-docs@lists.postgresql.org; Fri, 26 Jan 2018 09:10:46 +0000 Received: from mail-oi0-x244.google.com ([2607:f8b0:4003:c06::244]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1ef01y-0000Um-UY for pgsql-docs@postgresql.org; Fri, 26 Jan 2018 09:10:45 +0000 Received: by mail-oi0-x244.google.com with SMTP id m83so7447742oik.8 for ; Fri, 26 Jan 2018 01:10:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=3i8SnLFQdRjDb10EKZUrnGFqUuirND1CY5qvoksNcig=; b=DJr05+NGuCLMEshdA0JJ5EQb422n7j7gcg8zCHarBleva/nnJmlAThrs1PNuFc9b0M XkT22LKDQaVr6iQi0sZz3tdDnwnfLyi0miKdUJxqnLFc3jnPL0O1AJgKwaxGydynGPgW yDq+exnwndQy0zEQyYH1spDhMgYHD2UjIRBHgzG/VR1EU3PgFw7LJrPbTFsjBTze65Qm 4zGQ3uVsiN2EZN2Elxq+7dvpm8wW9S7mswwzzijRDMsuwX/aeP2pQYU13w4+kSW0MVR6 nJx7P3zKvxPJQThZuvp3OUbapKa3O0MbezUDoiZ9sQa5Y70HURcfko4uqQTaOx9bUiD/ u2lg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=3i8SnLFQdRjDb10EKZUrnGFqUuirND1CY5qvoksNcig=; b=Zn2gkCOyCdh21tDXCdTTioaUBP5y2opM31zIbsz6YblXazJrqqRatRdocxwOr9QVib 3wmrvKljIyL8bGY2Rembe/8DwGR1cSwrAqRL+FNnw5gjd8hM3kZjg2SdmFFOV39TImUB TqcfU/RhA3Us9oQzxRuyCQIWan5UE1GsczP6tzEFOA0dVefQb93w5m374waonB+AqNrc lBC0QbznJ60RY1gI8gMAW11P7mk6tsXaFdw8H9Q5t3BH0hpDq0crpVKJ5imZGvpmluS9 JHFJ2A67W28WQyPTkWEirpIJTRzTC527oTuB0ZfTFleE8U5HCT7vhPzSKAc4GYSfJPrP lsFA== X-Gm-Message-State: AKwxytfwGFVMKpZ2PwgLo34oqJmwZ2v0e+fXJeHu5TlUk5ZRrEhO2Cuv LYOoMc85X0xOoAbZSfsfW8kmjypdUcpGXXfMZRc= X-Google-Smtp-Source: AH8x224cnb4zL2Pw/+XG/8zL8eKaixZEfMKTxZqVYMVgaH6q1o8ea4zequeyRVczpcS5/aA8yl4xzT1kiw66GqzfzMo= X-Received: by 10.202.54.5 with SMTP id d5mr12772259oia.70.1516957840340; Fri, 26 Jan 2018 01:10:40 -0800 (PST) MIME-Version: 1.0 References: <8f724de9-9e97-02eb-1249-dd6f12f69d27@2ndquadrant.com> In-Reply-To: <8f724de9-9e97-02eb-1249-dd6f12f69d27@2ndquadrant.com> From: Michail Nikolaev Date: Fri, 26 Jan 2018 09:10:29 +0000 Message-ID: Subject: Re: [PATCH] Updating documentation about bulding documentation in Windows. To: Peter Eisentraut Cc: pgsql-docs@postgresql.org Content-Type: multipart/alternative; boundary="001a113ce2a6367c060563aa4542" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --001a113ce2a6367c060563aa4542 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hello. It is not so easy to fix the script because it is based on old toolset (probably on 9.6). I'll try one more attempt. Regardning WSL: I think it is better to keep some instructions because there are a lot of common errors - line ending, correct usage of linux\windows file system mappings. Most of Windows users are not familiar with it. I could rewrtite it as: 1. clone using WSL to Windows filesystem 2. disable autoclrf 3. edit documentation in Windows (usig Unix line-ending) and build in WLS. Thanks, Michail. =D0=BF=D1=82, 26 =D1=8F=D0=BD=D0=B2. 2018 =D0=B3. =D0=B2 8:03, Peter Eisent= raut < peter.eisentraut@2ndquadrant.com>: > On 1/23/18 16:05, Michail Nikolaev wrote: > > Current documentation contains outdated instruction and scripts relativ= e > > to building documentation on Windows machine. > > > > I removed useless scripts and wrote some guide to build docs using > > Windows Linux Subsystem. > > Why not fix the script instead? > > Using WSL is also a good idea, but then we could just say, use WSL and > follow the instructions for the particular Linux distribution. We don't > need to repeat all that again. > > -- > Peter Eisentraut http://www.2ndQuadrant.com/ > PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services > --001a113ce2a6367c060563aa4542 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hello.

It is not so easy to fix the scr= ipt because it is based on old toolset (probably on 9.6).
I'l= l try one more attempt.

Regardning WSL:
= I think it is better to keep some instructions because there are a lot of c= ommon errors - line ending, correct usage of linux\windows file system mapp= ings.=C2=A0
Most of Windows users are not familiar with it. I cou= ld rewrtite it as:=C2=A0
  1. clone using WSL= to Windows filesystem
  2. disable autoclrf
  3. edit documentation in Windows (usig Unix line-= ending) and build in WLS.

=
Thanks,=C2=A0
Michail.


=D0=BF=D1=82, 26 =D1=8F=D0=BD=D0=B2. 2018 =D0=B3. =D0= =B2 8:03, Peter Eisentraut <peter.eisentraut@2ndquadrant.com>:
On 1/23/18 16:05, Michail Nikolaev wrote:
> Current documentation contains outdated instruction and scripts relati= ve
> to building documentation on Windows machine.
>
> I removed useless scripts and wrote some guide to build docs using
> Windows Linux Subsystem.

Why not fix the script instead?

Using WSL is also a good idea, but then we could just say, use WSL and
follow the instructions for the particular Linux distribution.=C2=A0 We don= 't
need to repeat all that again.

--
Peter Eisentraut=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 http://w= ww.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--001a113ce2a6367c060563aa4542--