From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
To: Andres Freund <andres@anarazel.de>
Cc: pgsql-hackers@postgresql.org, samay sharma <smilingsamay@gmail.com>
Cc: Nazir Bilal Yavuz <byavuz81@gmail.com>
Subject: Re: [RFC] building postgres with meson - v11
Date: Wed, 31 Aug 2022 10:42:22 +0200
Message-ID: <15743360-7b79-d04e-0791-d9ccb341dd56@enterprisedb.com> (raw)
In-Reply-To: <20220824153008.i7pnmh7xilqhsnej@awork3.anarazel.de>
References: <20211012083721.hvixq4pnh2pixr3j@alap3.anarazel.de>
<20220811002012.ju3rrz47i2e5tdha@awork3.anarazel.de>
<e0c44fb2-8b66-a4b9-b274-7ed3a1a0ab74@enterprisedb.com>
<20220817215317.poeofidf7o7dy6hy@awork3.anarazel.de>
<8992c637-0922-8cf8-9188-104153eb3561@enterprisedb.com>
<20220820180139.6uj5etquyonz4otf@awork3.anarazel.de>
<7dae5979-c6c0-cec5-7a36-76a85aa8053d@enterprisedb.com>
<20220824153008.i7pnmh7xilqhsnej@awork3.anarazel.de>
On 24.08.22 17:30, Andres Freund wrote:
>> 0545eec895 meson: Add docs
>>
>> We should think more about how to arrange the documentation. We
>> probably don't want to copy-and-paste all the introductory and
>> requirements information. I think we can make this initially much
>> briefer, like the Windows installation chapter. For example, instead
>> of documenting each setup option again, just mention which ones exist
>> and then point (link) to the configure chapter for details.
> The current docs, including the windows ones, are already hard to follow. I
> think we should take some care to not make the meson bits even more
> confusing. Cross referencing left and right seems problematic from that angle.
If you look at the current structure of the installation chapter
17.1. Short Version
17.2. Requirements
17.3. Getting the Source
17.4. Installation Procedure
17.5. Post-Installation Setup
17.6. Supported Platforms
17.7. Platform-Specific Notes
only 17.1, small parts of 12.2, and 17.4 should differ between make and
meson. There is no conceivable reason why the meson installation
chapter should have a different "Getting the Source" section. And some
of the post-installation and platform-specific information doesn't
appear at all on the meson chapter.
I think we can try to be a bit more ingenious in how we weave this
together in the best way. What I really wouldn't want is two separate
chapters that duplicate the entire process. I think we could do one
chapter, like
- Short Version
- Requirements
- Getting the Source
- Installation Procedure
- Installation Procedure using Meson
- Post-Installation Setup
- Supported Platforms
- Platform-Specific Notes
Alternatively, if people prefer two separate chapters, let's think about
some source-code level techniques to share the common contents.
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-hackers@postgresql.org
Cc: peter.eisentraut@enterprisedb.com, andres@anarazel.de, smilingsamay@gmail.com, byavuz81@gmail.com
Subject: Re: [RFC] building postgres with meson - v11
In-Reply-To: <15743360-7b79-d04e-0791-d9ccb341dd56@enterprisedb.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox