From patchwork Tue Mar 12 17:01:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eli Schwartz X-Patchwork-Id: 1040 Return-Path: Delivered-To: patchwork@archlinux.org Received: from apollo.archlinux.org (localhost [127.0.0.1]) by apollo.archlinux.org (Postfix) with ESMTP id 501C3C70D700 for ; Tue, 12 Mar 2019 17:01:46 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on apollo X-Spam-Level: X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00=-1, DKIMWL_WL_HIGH=-0.001,DKIM_SIGNED=0.1,DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,MAILING_LIST_MULTI=-1,RCVD_IN_DNSWL_MED=-2.3, T_DMARC_POLICY_NONE=0.01 autolearn=ham autolearn_force=no version=3.4.2 X-Spam-BL-Results: [127.0.9.2] Received: from orion.archlinux.org (orion.archlinux.org [88.198.91.70]) by apollo.archlinux.org (Postfix) with ESMTPS for ; Tue, 12 Mar 2019 17:01:46 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 9A40911331AC0D; Tue, 12 Mar 2019 17:01:39 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [IPv6:2a01:4f8:160:3033::2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by orion.archlinux.org (Postfix) with ESMTPS; Tue, 12 Mar 2019 17:01:39 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 89D492BFC9; Tue, 12 Mar 2019 17:01:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=archlinux.org; s=luna2; t=1552410094; bh=5l3fmUdhCroZTV+hnHSnkUmxcvd0vYjWHt8+UAerd88=; h=From:To:Date:In-Reply-To:References:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Reply-To; b=dN4bTr9BVHHZ1ExYrqXVqmR5H2Q0Lo/KncYfTr/x67kbo5qrUsmjb8uEULtsjTJCA fW23L3mr4/Z9qItBNwVh3qP/hFkWZ/ZVc0gFrzY3bjmGtwkWPeQquj1pYGnWoSXgD8 4amO6dGZFHde76qXgAbYEPYlMcaVgT0wIdSBHLfrj0aU3JkLUvLD7tzU/fSLRahxgI pjJaQ7PLIsBxd9mWsSjmoj6HCUowH1crgqWHmtIjwXx1KSkpV+Fe/Q8SzQ9j86QSxb H6VmsY4julOYfzEpJ118tGVgovWtANPx4kbnj8jMAxkiKGhpha2ozbupw2t3Cy344t GwkmrBE5Xq4yz5BCybYThVYMYkYxrGKK1f3DCJilQL1pu++qirIxkuNjfXC3ZJD5rw 7SJ10YrbMYUFQ+KBdROtEg7Cj4BleEGKk05s0ywki1QZEg4emX6SbYzfh1A8dFLIj7 xq5fseAOb/gaU0IHWYHd9ry9bpymPkzTXCVjA8H6zZ9nhxZMcvKTblH7qet3jDuJ/z 9lak28Ju1hmrLBFy5ZVN6YDwrbqjWq3Opn/MsypQbKIY7nClXaJ9v+CgnfCXwd4X/M UiuAhTlAslJwau7a6kct4JfH8+QP/8jpoujbIJX3iCDeN3AV/LryVGR9GnCqVm2QZJ BWUre2CAV70W7QpZFB9QlnTo= Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 36B9B2BF60 for ; Tue, 12 Mar 2019 17:01:32 +0000 (UTC) Received: from orion.archlinux.org (orion.archlinux.org [IPv6:2a01:4f8:160:6087::1]) by luna.archlinux.org (Postfix) with ESMTPS for ; Tue, 12 Mar 2019 17:01:32 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 4681611331ABF8; Tue, 12 Mar 2019 17:01:26 +0000 (UTC) Received: from didactylos.localdomain (unknown [216.97.144.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: eschwartz) by orion.archlinux.org (Postfix) with ESMTPSA id BFB9411331ABF7; Tue, 12 Mar 2019 17:01:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=archlinux.org; s=orion; t=1552410086; bh=5l3fmUdhCroZTV+hnHSnkUmxcvd0vYjWHt8+UAerd88=; h=From:To:Subject:Date:In-Reply-To:References; b=SrmZVCWqnynFQoXwCSLURmae4U+y5fBGnLgGKrg+f1DnKq4WbNR5r1jiNnWVWVeK5 X572xmhEQg4MdKorTPha+zikXW1/KNB9tDJIXxjHVyXMlZF9pKE5i5GuBxFrT0dSy/ WSNRDCrAfCSfWYPYuVFMO10UnrhejGVh4J3hf+gS+I1D6WtcAXaunmceDRv9SBssAe JGPna+6dsUCG7E38ptvTe7ktu9Pwf4ghoHnRN/iZTtt9AnSNzhnvM1hzFWTTG8stYS 2deJQxCuGOVG0t0VZdkqxvNlVl+cbZQ6Ll79EtQzbFtK/Vn82/EnNUvL375n/1tFpD exaU3fEBRCICICmR8SOv7eyqDT8HEn0fkIH2IJ4+KQormd0dkU4v+YiXx3z/IIFAgl /OrWnPFv6SLuzH635pXuPpLXjesF7by2hatVH1dDzHGIz7kMVii3gHs1/sMh8qFE4H bggdOQuBmI9xoJJ9QteinmHNcIRE9gQh5453G/mzol91YP0wChQzNrjS70kYUQvghU h8vIit+QlY7o4XbhPmgeV0uDfGLJ/UEbMfVTBNJBNT+CkKZQZX7tYNvDo6oCy9eLTc QRJX2QMAcFqv0dqCShOu5gy75/Y/ffvGrcjtTGsqq9NtZsy1fGCp58nz0xpOjwkO8W zupD5pxtxXZ8HcgkegtMlwqg= From: Eli Schwartz To: pacman-dev@archlinux.org Date: Tue, 12 Mar 2019 13:01:14 -0400 Message-Id: <20190312170114.9291-3-eschwartz@archlinux.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190312170114.9291-1-eschwartz@archlinux.org> References: <20190312170114.9291-1-eschwartz@archlinux.org> MIME-Version: 1.0 Subject: [pacman-dev] [PATCH 3/3] doc: elaborate on what a build() function is meant for X-BeenThere: pacman-dev@archlinux.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion list for pacman development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Discussion list for pacman development Errors-To: pacman-dev-bounces@archlinux.org Sender: "pacman-dev" It is often not obvious to people, that build() can be run multiple times when continuing a build with --noextract. Signed-off-by: Eli Schwartz --- doc/PKGBUILD.5.asciidoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/PKGBUILD.5.asciidoc b/doc/PKGBUILD.5.asciidoc index 83a61458..6336a5cd 100644 --- a/doc/PKGBUILD.5.asciidoc +++ b/doc/PKGBUILD.5.asciidoc @@ -359,7 +359,11 @@ function. *build() Function*:: The optional `build()` function is use to compile and/or adjust the source - files in preparation to be installed by the `package()` function. + files in preparation to be installed by the `package()` function. All + commands specific to the package creation (but not source code + preparation), before the final installation of files into the packaging + root, should be performed here. The `build()` function is permitted to run + multiple times if `makepkg --noextract` is used. *check() Function*:: An optional `check()` function can be specified in which a package's