From owner-freebsd-git@freebsd.org Wed Dec 16 16:58:58 2020 Return-Path: Delivered-To: freebsd-git@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 089194C1578 for ; Wed, 16 Dec 2020 16:58:58 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: from mail-il1-f169.google.com (mail-il1-f169.google.com [209.85.166.169]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Cx1YY0YFQz3PML for ; Wed, 16 Dec 2020 16:58:56 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: by mail-il1-f169.google.com with SMTP id q1so23208599ilt.6 for ; Wed, 16 Dec 2020 08:58:56 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=sT8+iLbNUcwSnuk/maitUCZWDWytAGA0whVapT4nG00=; b=cipXuwrn7HYNs3UDgWhIpjuaeUsZLnTVRPFL/frgmepYAWGHbttMGpaqCVrtfIzULF 5wUM59brzWbEVXWN4pKQAeGMK/vVb0fprdvTc0w8yEc5hcHGTKvRyX8ws0WPHfjHFLau vK2HVSfWvaIBRQipG1WdQEzoV+1jsveQDqnVUbTO8VJCPqK0ZunJmrO8a++7G476GQ0G l9if4gx68K7MA3Mvx8LHohFprdSwakTQFoPsaaM8aCNj0RUNgFbFZR2JHbMUxp+s2gzr G+PWjHyN6I/cu+wRBGHfg4RrTYg9NEcKZBjhu62A+hGyLBQsVSWK+hal2cm/mdpyfcyt o6qA== X-Gm-Message-State: AOAM533fc8IcVD9hD4/SoO49TAnSoOd4Hs/q0PYVp7JrF0/oclonzBu4 49ZpfBrGKipb5wS8GmdWM8GpE6xaI/hBUX/fncuthuF5HD+Dpg== X-Google-Smtp-Source: ABdhPJzLdyBD1dge9cNy61yfv0+eHgZfJd82UUtbo1qFI+9GJ/URlE40vjwyaHBRrCO1BpLKw+HjRni9MJg5o3ws4s8= X-Received: by 2002:a92:b694:: with SMTP id m20mr39696784ill.182.1608137934889; Wed, 16 Dec 2020 08:58:54 -0800 (PST) MIME-Version: 1.0 From: Ed Maste Date: Wed, 16 Dec 2020 11:58:43 -0500 Message-ID: Subject: Git commit message templates To: freebsd-git Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 4Cx1YY0YFQz3PML X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of carpeddiem@gmail.com designates 209.85.166.169 as permitted sender) smtp.mailfrom=carpeddiem@gmail.com X-Spamd-Result: default: False [-3.00 / 15.00]; R_SPF_ALLOW(-0.20)[+ip4:209.85.128.0/17:c]; TO_DN_ALL(0.00)[]; NEURAL_HAM_SHORT(-1.00)[-1.000]; FORGED_SENDER(0.30)[emaste@freebsd.org,carpeddiem@gmail.com]; MIME_TRACE(0.00)[0:+]; FREEMAIL_ENVFROM(0.00)[gmail.com]; RBL_DBL_DONT_QUERY_IPS(0.00)[209.85.166.169:from]; R_DKIM_NA(0.00)[]; FROM_NEQ_ENVFROM(0.00)[emaste@freebsd.org,carpeddiem@gmail.com]; ASN(0.00)[asn:15169, ipnet:209.85.128.0/17, country:US]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; TO_DOM_EQ_FROM_DOM(0.00)[]; FREEFALL_USER(0.00)[carpeddiem]; FROM_HAS_DN(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; MIME_GOOD(-0.10)[text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-git@freebsd.org]; DMARC_NA(0.00)[freebsd.org]; RCPT_COUNT_ONE(0.00)[1]; SPAMHAUS_ZRD(0.00)[209.85.166.169:from:127.0.2.255]; RCVD_IN_DNSWL_NONE(0.00)[209.85.166.169:from]; RWL_MAILSPIKE_POSSIBLE(0.00)[209.85.166.169:from]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MAILMAN_DEST(0.00)[freebsd-git] X-BeenThere: freebsd-git@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Discussion of git use in the FreeBSD project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 Dec 2020 16:58:58 -0000 I've written up an article on commit messages that's now incorporated into Warner's doc collection, with an intended final destination of the handbook. The current version of that document is here: https://github.com/bsdimp/freebsd-git-docs/blob/main/commit.md One outstanding Git transition item is work on commit message templates. We currently have an SVN template that lists the metadata fields we use, such as PR:, Reviewed by:, and such. Git supports local commit hooks (in .git/hooks) and I've made a trivial port of that to a git commit message preparation hook. I imagine we'd have these in the tree (in tools/tools/git/hooks/) and provide either documentation or a script to install or symlink them into the user's .git/hooks/ directory. The current trivial hook is open in https://reviews.freebsd.org/D27633.