From nobody Thu Sep 07 18:29:25 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4RhSSk0k31z4ssqc for ; Thu, 7 Sep 2023 18:29:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4RhSSk0Hv7z3J1d; Thu, 7 Sep 2023 18:29:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1694111366; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=O5Dp/tj/Mn5LVqXh7rHe48HNWFLFujQjF6yqa4AGcMw=; b=lU+OmBcxKz0jqrI0vE9Khmgm6ukNL6/XJVb5z4pUQDWP+erOv7W+HTvGmQnZB9eiWoTzFo YJnet/bflwvuUho/sZKGW0hq1KpWIdIZKVytTU9XY5CYblwdj3X2Ay+9S/bHVXXc1igMqr WmvB6XiBeHad9e6KxfhBceCXrnIRNY0sFhB3ivSdC8ZqUUD4U0vaPy5PO1cjQT4MuKlx5i 9sIm1Wr+LP3ndO7OLqjZCgnDlEdyYHS6q4jbgwjpGNJ+Y2FUdOLckPZfO+WXZ7LVF3S3Bl CURNkuJRH0Sx6LVi6AX96+fn8lNyLsoYF0Osx+w4Vp25mOop47dNSEfC0enMxg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1694111366; a=rsa-sha256; cv=none; b=wCSvfFs5GCsZwTWemDuATvV3iDjTGL8yLLxKx+35+EHTpfo2zx5awvJ8HIXuVzesDJwxip XfxTdX43BsQvgH1Li+aYughCTLq5ytRaGAzTsSFXDr3ViGankPZf/LLZPRyTsoTeN5Gzyi oG/ANjSqcHGiQOgGPQmi2F5IlxhEWjVoCJ3Hio3Ax4WmlIWFqFHVO78fJprdIUrw6W/pjA 12dHK+ZQeLewamB5vfDzi7j+W13mHaWUlaQBsUUU3LlkMoIP8QKjwP5sWIwBruDT2rs6R+ kid6aPvNtHBQTon3mTkw4IMa6F4PSGqA0c/xKzcmA2T/S3VpJmgVtcxLYsDmxg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1694111366; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=O5Dp/tj/Mn5LVqXh7rHe48HNWFLFujQjF6yqa4AGcMw=; b=Ed9cffQ33AQtZg4O/bhXb6TuOHDX5bXethwNxjMTSqbDHhPqV77+j5RldEWPBzEU+E1Jfe M0s2T1cltLEiBcMpL8lSn207fs5XGNksCWuPw9jKfk2xZJmfEZPC8UZOVqg+FX2xFqj+QD /34f55GW6nLCihW2NtoJd0ftylfzkZQZE/+bw9KHrBrecPNfsZKwtANNFABdh689VCdbQf N1HqHssfmwHNDVux1/WaNeC6msyQ3RdATMqASoNyb1rhkBVOm4uiJSVIupQCEtj6cjB5Pd IxsL7WdIGdH3G6qfIoCYzKeJnLJQwRVh8w+av7TbzLqueKTl+Ey/0gn5emIxVw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4RhSSj6TX0z18kt; Thu, 7 Sep 2023 18:29:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 387ITPSY065872; Thu, 7 Sep 2023 18:29:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 387ITPoM065869; Thu, 7 Sep 2023 18:29:25 GMT (envelope-from git) Date: Thu, 7 Sep 2023 18:29:25 GMT Message-Id: <202309071829.387ITPoM065869@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 2c37efcbbb - main - Committer's: Change the way to install commit template hook List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2c37efcbbbe845eab97517b90d099a22bc32c67c Auto-Submitted: auto-generated The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=2c37efcbbbe845eab97517b90d099a22bc32c67c commit 2c37efcbbbe845eab97517b90d099a22bc32c67c Author: Yasuhiro Kimura AuthorDate: 2023-09-07 18:27:39 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-09-07 18:27:39 +0000 Committer's: Change the way to install commit template hook Currently commit message template hook is installed as following. * The one for src repository is also used for doc and ports. * The file is downloaded through web interface (https://cgit.freebsd.org/) and installed under .git/hooks. However, * Both doc and ports repositories have their own hooks inside them. So it is obviously better to use them than using the one for src repository. * For src repository committer need to download and install hook file each time it is updated. So change the way to install commit message template hook as following. * For doc and src repository, create symbolic link under '.git/hooks' that points to real hook file. * For ports repository. set the path to look for hooks to '.hooks'. This is because ports repository also provides some other hooks and creating symbolic link for each of them is bothersome. PR: 273574 --- .../en/articles/committers-guide/_index.adoc | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index dfdd674457..667e635bd2 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -391,10 +391,27 @@ Again, note that `gitrepo.freebsd.org` has been canonicalized to `repo.freebsd.o * Install commit message template hook: + +For doc repository: ++ +[source,shell] +.... +% cd .git/hooks +% ln -s ../../.hooks/prepare-commit-msg +.... ++ +For ports repository: ++ +[source,shell] +.... +% git config --add core.hooksPath .hooks +.... ++ +For src repository: ++ [source,shell] .... -% fetch https://cgit.freebsd.org/src/plain/tools/tools/git/hooks/prepare-commit-msg -o .git/hooks -% chmod 755 .git/hooks/prepare-commit-msg +% cd .git/hooks +% ln -s ../../tools/tools/git/hooks/prepare-commit-msg .... [[admin-branch]]