From patchwork Mon Aug 8 14:50:08 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Niedermayer X-Patchwork-Id: 37188 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:92a9:b0:8d:7f3b:94fc with SMTP id q41csp1882916pzg; Mon, 8 Aug 2022 07:50:30 -0700 (PDT) X-Google-Smtp-Source: AA6agR7cLAuyiAqZujlroBTlpl3Mn7mv38SzD6BcaZ6nvN22t5BcQ7h7/3xFam7AYpSAdUFi+pkF X-Received: by 2002:a17:907:3f98:b0:730:cfce:9c0f with SMTP id hr24-20020a1709073f9800b00730cfce9c0fmr14503959ejc.475.1659970230582; Mon, 08 Aug 2022 07:50:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1659970230; cv=none; d=google.com; s=arc-20160816; b=EVaE2V0oZn/iTqQsGOR0I89A2a6Fojw2JLd9xTTeVorTUqaFmdNWAa1p/TeoYeFz4D M8S/Xv9NokENYzGjRXtHdNwzIJK5GSQOKeSiZ4YQNFa4IpivQfra9QmGNg8BwxMm+cV+ k/Sy5ahVdc/rVdURMReHRpxaifXGMSeqLbYnVT01ta7zuPvh8GiCEmZOFKkADZ4czXBF pUaz4wQynlS0I95WRnIU9jgzDoFcweYM8FvVemI4IGGG5QAwN/4T4dRZLM+dqDhiLHck NHALIdeTQOi7dpqiC99eKmU+wtOsIvQN7XFNXSnB8LpZ/lh1gW2+OkVIE76/OF/6bfl3 BWiQ== 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:references:in-reply-to:message-id:date :to:from:delivered-to; bh=nMHyKNE9sTaM3XxjZ1pFqdsfZmLag7vtShzfo9rvzT4=; b=HljrbdNdmLoR6hqKme3irQ1xTe2QGQf0VOL8sz5NT5ISOxfs0ksLsj42ecwpyYZKql 8gZJLSrYC391uRUZmWDldRUl6NCxqqekCCKpQdbFO7oD3xbo09eUKAlLmpQ3wrYi9D6T Yv2K96FfR0vSvlal0sVViOmHT4Ykh3cK/YTpxWinnQjYMfMYFfhmH5qzeQpx0kM0D5Tn OdQ0TrmZehD+sFkpOV3zWprZDiSnFMpK+38Qtu4nddytEz5E4vYvfdYUiSNf3murflwf rm8OHXkeavQ2xeCYipUQrhLO3z8ZV+7nkk3ax/KurTpvXMSBlEM8F/yf8FUKCguwGqqa ZCKg== 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 w19-20020a1709061f1300b0073114e50880si6404660ejj.573.2022.08.08.07.50.30; Mon, 08 Aug 2022 07:50:30 -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 8C53168B734; Mon, 8 Aug 2022 17:50:27 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from vie01a-dmta-at03-2.mx.upcmail.net (vie01a-dmta-at03-2.mx.upcmail.net [62.179.121.152]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id BEE6868B6B0 for ; Mon, 8 Aug 2022 17:50:20 +0300 (EEST) Received: from [172.31.216.235] (helo=vie01a-pemc-psmtp-pe12.mail.upcmail.net) by vie01a-dmta-at03.mx.upcmail.net with esmtp (Exim 4.92) (envelope-from ) id 1oL45D-003Izk-Nj for ffmpeg-devel@ffmpeg.org; Mon, 08 Aug 2022 16:50:19 +0200 Received: from ren-mail-psmtp-mg01. ([80.109.253.241]) by vie01a-pemc-psmtp-pe12.mail.upcmail.net with ESMTP id L45Co14xt8s8UL45Do990n; Mon, 08 Aug 2022 16:50:19 +0200 Received: from localhost ([213.47.68.29]) by ren-mail-psmtp-mg01. with ESMTP id L45DoqD9mOPqFL45DoA5BF; Mon, 08 Aug 2022 16:50:19 +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=62f122ab 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: Mon, 8 Aug 2022 16:50:08 +0200 Message-Id: <20220808145008.26162-3-michael@niedermayer.cc> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20220808145008.26162-1-michael@niedermayer.cc> References: <20220808145008.26162-1-michael@niedermayer.cc> X-CMAE-Envelope: MS4wfKTI9/I+SduuWNObvGarVz5DumGfm4VZGWH/5rxGy2d/TEn2jy9TNUBQIB8ka9ho9LB/or7WoNtDYnNVBUKuaqrgWthntH/+MAHSKA2ivynJx+707/dv APqCUo8jQGWm+TkfC8h5eH1CSinlDHQY113DbwHOC2TxVtD7BBQmy10qUcX2kQWhIctE5dG87KbB9Q== Subject: [FFmpeg-devel] [PATCH 2/2] 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: xNikgH+QFYK3 From: Michael Niedermayer --- doc/git-howto.texi | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/doc/git-howto.texi b/doc/git-howto.texi index 874afabbbc..9c74199495 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,18 @@ 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. + @chapter Pre-push checklist Once you have a set of commits that you feel are ready for pushing,