Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1phedL-0003zm-Nm for pgsql-hackers@arkaria.postgresql.org; Wed, 29 Mar 2023 22:51:11 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1phedJ-0008Bg-Qo for pgsql-hackers@arkaria.postgresql.org; Wed, 29 Mar 2023 22:51:09 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1phedJ-0008BX-De for pgsql-hackers@lists.postgresql.org; Wed, 29 Mar 2023 22:51:09 +0000 Received: from mail-il1-x12c.google.com ([2607:f8b0:4864:20::12c]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1phedE-0003ZD-Ab for pgsql-hackers@postgresql.org; Wed, 29 Mar 2023 22:51:08 +0000 Received: by mail-il1-x12c.google.com with SMTP id n1so8185625ili.10 for ; Wed, 29 Mar 2023 15:51:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telsasoft-com.20210112.gappssmtp.com; s=20210112; t=1680130263; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=BaKPzp5MwYHUIL7Hb/+KhKWxCk1XDhrCYFn4mxajA9c=; b=b5HrgGTrUgd/qXoPB/9l9uwAHUg5vW8UPjFa3NdFkHA2dMAUznSwoijSF8Q68lgptp gX2xu9Xj78yakJ7njw+usgUlB3mmKmf4rD6OPbHUBXHysWPEzj0fkpSNkeTsnivUSDpi L3TZRmC+N0eG3pLAvyt8QVLl5JxijUZ38OIJ0MMysOcGPZCmic9F+Nq5hDKGOquyTFJx kfvQJnJo1brC7MLShNEwkCrXh/dVQoBUh1mGYQUIXy8X76mkPenO3O+N34dNvLsb8U3I h3qy3S6ql9mtWUumVVkMRCdkOeBeBJYAbwBySV2GYP4oGeeUz9Pr03EAgwaoGNCdgl2b yxwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1680130263; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=BaKPzp5MwYHUIL7Hb/+KhKWxCk1XDhrCYFn4mxajA9c=; b=lllVT+4cd6i8+216rIQhxu1DUtwYQuWIZxXG3RpTO+m0Y530KwF/sFHSJqI6wz43uS is62anclLbuNs84B7x1JwvgOk3ojDx9XOLxd8Q38vH6H+stzhHCc73cirbgbjbC0o/oQ G0FOA+ut+7MAV5IF9iLq+gn1z1PjPxjprZK23lr4K9eBxwHX1oJZxdniUSK15pxU5t6u rDtTalxqlsZ3/zTM8J6BtGdy7334IVMQkl5U/mAFKf9scgQ1HAhpHAIfD2suocHvlyQX y8GEoTmYpzyc/Ix7pjMnKfWGnTS4QlyDIP9Hx/0m+RPAtER43lHE2tH5MNBryTOA+WzC KEaw== X-Gm-Message-State: AAQBX9fTykM5zgqBvUNuSPk8fcCZPO6k0waO+cpuQH3hbcGNSAppDLC7 T8WK2anBacbM47u35UT0DrtJdA== X-Google-Smtp-Source: AKy350YAxq5Cfp9iC3OmqF8YU1Se/b0Lgm33YFGRnf3UGxFK2Q9bSDN44da3h02y6zRomgWTWWI6Jw== X-Received: by 2002:a92:c501:0:b0:325:d689:6cd7 with SMTP id r1-20020a92c501000000b00325d6896cd7mr15149382ilg.16.1680130263653; Wed, 29 Mar 2023 15:51:03 -0700 (PDT) Received: from pryzbyj.telsasoft (charmander.telsasoft.com. [50.244.222.1]) by smtp.gmail.com with ESMTPSA id c30-20020a02331e000000b003afc548c3cdsm10853461jae.166.2023.03.29.15.51.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Mar 2023 15:51:03 -0700 (PDT) Received: by pryzbyj.telsasoft (Postfix, from userid 1000) id 201CE800108; Wed, 29 Mar 2023 17:51:02 -0500 (CDT) Date: Wed, 29 Mar 2023 17:51:01 -0500 From: Justin Pryzby To: Andres Freund Cc: Peter Eisentraut , pgsql-hackers@postgresql.org Subject: Re: what should install-world do when docs are not available? Message-ID: References: <20230325201414.sh7c6xlut2fpunnv@awork3.anarazel.de> <245481bd-95a5-4967-4580-e4a8105ad991@enterprisedb.com> <20230329162503.qkbyxzxnzxtsplhu@awork3.anarazel.de> <20230329224132.fnymznyxmta5ugrs@awork3.anarazel.de> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20230329224132.fnymznyxmta5ugrs@awork3.anarazel.de> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk > + Enables the building of documentation in HTML and > + man format. It defaults to auto. > + > + Enables the building of documentation in PDF > + format. It defaults to auto. These sound awkward. Recommend: Enables building the documentation in PDF format. It defaults to auto. > + > + > + > + > + Influences which CSS stylesheet is used. If > + website, instead of the default > + simple, is used, HTML documentation will use the > + stylesheet used on + url="https://www.postgresql.org/docs/current/">postgresql.org. s/Influences/Controls/ I think the default should be given separately from the description of the other option. Controls which CSS stylesheet is used. The default is simple. If set to website, the HTML documentation will use the same stylesheet used on postgresql.org.