From patchwork Tue Aug 9 19:34:39 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Niedermayer X-Patchwork-Id: 37205 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:3d0d:b0:8d:a68e:8a0e with SMTP id y13csp453992pzi; Tue, 9 Aug 2022 12:34:51 -0700 (PDT) X-Google-Smtp-Source: AA6agR7I2knaSzmms7KwrGifXg6CgX7LgodjJ19JYab0LGSVvobA4KZ1mJWdIkwise6jMw9IxsIY X-Received: by 2002:a17:906:93f0:b0:730:6d4e:970c with SMTP id yl16-20020a17090693f000b007306d4e970cmr18419727ejb.188.1660073691578; Tue, 09 Aug 2022 12:34:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1660073691; cv=none; d=google.com; s=arc-20160816; b=FFj9+Qsv8MjmLqqyL4Dk7TEiC9Y9q0QgTtu5x+kCPy8a3XggfMbzrgLGKRDRS6O8nL c/X+XpXcF1HyAGo55P/re5lrY1XlOW9AkyMbCat+xJQtVE/Qk+w5ndhEcT7jbxBQV3Be /mSWPTy7m1cNTRBPeNbcgr0WXGQgh/lsPWu4m1XG2NQHEZMd7rU541finx1JkNUoJAcX SVrJYNqlwnwhQu7gKnIYBN1SR+LWjIsmlq/o3JIWTx3zWRnMAvVVpPQ2ktU2Y3zch472 uH8b4NpqOHpiq4dBkjnPxu1R0ixUa9XzL9edbF4+MIAil4kRmltSWc06AmP+7CWJD3TI LgvA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:message-id:date:to:from:delivered-to; bh=JGhDHZw09ahXwsmIbr/wkzaYcfHBIcSJeWEsW2eGv84=; b=tsoSdL2IdBLr7v3gLstHL+f5BAP1hh8TzvpeF4GkbxqzP8EfgXMsk5EmzRkM8hrRWa SSnJzhGcw+q0EiONmEtl4hwLMINwU8wEwSQflupRVYplQg0PAwCGu3dABM2qyI0hP4AB j9uACAQ0oKmNIM0wSoo69QZ2YiBeDv0GX364+/clUeyWe8qGrA8m6Kk7+r7LWMAwlgvM X1VLrKf3oh5zcHDxsDwL/1+YtxkKvqokbfBLv/8RPufwg2IeBKdI1iUOUSDHlbu//dX5 i5vWCVwMiA7zweBmnYPIKr3uL8Eq/6VD2tOYqEKGTJWYTSGaj/8IMNYa2gxuc/VGGOIX C5Ag== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id y7-20020a056402358700b0043e6a689b4bsi9938323edc.536.2022.08.09.12.34.50; Tue, 09 Aug 2022 12:34:51 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id D62456802B5; Tue, 9 Aug 2022 22:34:48 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from vie01a-dmta-at01-1.mx.upcmail.net (vie01a-dmta-at01-1.mx.upcmail.net [62.179.121.145]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id E1F026802B5 for ; Tue, 9 Aug 2022 22:34:41 +0300 (EEST) Received: from [172.31.216.235] (helo=vie01a-pemc-psmtp-pe12.mail.upcmail.net) by vie01a-dmta-at01.mx.upcmail.net with esmtp (Exim 4.92) (envelope-from ) id 1oLUzw-00AtL8-Ii for ffmpeg-devel@ffmpeg.org; Tue, 09 Aug 2022 21:34:40 +0200 Received: from ren-mail-psmtp-mg01. ([80.109.253.241]) by vie01a-pemc-psmtp-pe12.mail.upcmail.net with ESMTP id LUzvoZPkb8s8ULUzvoHT7r; Tue, 09 Aug 2022 21:34:40 +0200 Received: from localhost ([213.47.68.29]) by ren-mail-psmtp-mg01. with ESMTP id LUzvoy8ZrOPqFLUzvoCVj4; Tue, 09 Aug 2022 21:34:39 +0200 X-Env-Mailfrom: michael@niedermayer.cc X-Env-Rcptto: ffmpeg-devel@ffmpeg.org X-SourceIP: 213.47.68.29 X-CNFS-Analysis: v=2.4 cv=OcX7sjfY c=1 sm=1 tr=0 ts=62f2b6cf a=2hcxjKEKjp0CzLx6oWAm4g==:117 a=2hcxjKEKjp0CzLx6oWAm4g==:17 a=MKtGQD3n3ToA:10 a=1oJP67jkp3AA:10 a=GEAsPZ9sns4A:10 a=74_OhrOYAAAA:8 a=9WL1Mq25NTnYzs_bLB8A:9 a=sXAPJFFmzZfmHMDDykbx:22 From: Michael Niedermayer To: FFmpeg development discussions and patches Date: Tue, 9 Aug 2022 21:34:39 +0200 Message-Id: <20220809193439.13308-1-michael@niedermayer.cc> X-Mailer: git-send-email 2.17.1 X-CMAE-Envelope: MS4wfG7fZV3vCbZcwpbfSQFtXrNKK8Xe4JZiT+5gR/PN2QEz+CawaRHhrFFI4Voonxmj/H3Ny4HWS0rIdAmDqERm+yBSHYAgqxhvLk0DWxLXk2KzixIs1Tj9 KLt+S0LSzrSbg/u4S/vczprwPDstgndTPLve66UqIc1M9JrRSF+1brcwt35xE/pV0uYJFH1U3S4/6A== Subject: [FFmpeg-devel] [PATCH v2] doc/git-howto.texi: Document commit signing X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Michael Niedermayer MIME-Version: 1.0 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: L1RhlA6uRqeS From: Michael Niedermayer Signed-off-by: Michael Niedermayer --- doc/git-howto.texi | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/doc/git-howto.texi b/doc/git-howto.texi index 874afabbbc..48389751a4 100644 --- a/doc/git-howto.texi +++ b/doc/git-howto.texi @@ -187,11 +187,18 @@ to make sure you don't have untracked files or deletions. git add [-i|-p|-A] @end example -Make sure you have told Git your name and email address +Make sure you have told Git your name, email address and GPG key @example git config --global user.name "My Name" git config --global user.email my@@email.invalid +git config --global user.signingkey ABCDEF0123245 +@end example + +Enable signing all commits or use -S + +@example +git config --global commit.gpgsign true @end example Use @option{--global} to set the global configuration for all your Git checkouts. @@ -423,6 +430,19 @@ git checkout -b svn_23456 $SHA1 where @var{$SHA1} is the commit hash from the @command{git log} output. +@chapter gpg key generation + +If you have no gpg key yet, we recommand that you create a ed25519 based key as it +is small, fast and secure. Especially it results in small signatures in git. + +@example +gpg --default-new-key-algo "ed25519/cert,sign+cv25519/encr" --quick-generate-key "human@server.com" +@end example + +When genarting a key, make sure the email specified matches the email used in git as some sites like +github consider mismatches a reason to declare such commits unverified. After generating a key you +can add it to the MAINTAINER file and upload it to a keyserver. + @chapter Pre-push checklist Once you have a set of commits that you feel are ready for pushing,