From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS54825 147.75.80.0/22 X-Spam-Status: No, score=-3.7 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.6 Received: from am.mirrors.kernel.org (am.mirrors.kernel.org [147.75.80.249]) (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) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 5AC401F51A for ; Tue, 16 Apr 2024 23:02:19 +0000 (UTC) Authentication-Results: dcvr.yhbt.net; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20230601 header.b=eMv+mHRq; dkim-atps=neutral Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id BBD981F23D6F for ; Tue, 16 Apr 2024 23:02:17 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 8BD1413A869; Tue, 16 Apr 2024 23:02:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="eMv+mHRq" Received: from mail-wr1-f45.google.com (mail-wr1-f45.google.com [209.85.221.45]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CEB5A84E0B for ; Tue, 16 Apr 2024 23:02:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.45 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713308524; cv=none; b=pgG9gAWFsq58DmAMj11EC61VgjaPKABj09+DlcFJVJZ/06CZXN0KdVLf60QQSDcNVaSCMNMeyqnGe1CwY0RlZWU4AVOhjGNsZMQSZe2aJ4F8i1wofxDJcooAnbWzzPBHBy8OaHUZEE3wUwlcdmnR2dTp4kiGPaqnU4SoiUZUZzM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713308524; c=relaxed/simple; bh=qM7qk1SrHG4k7tqRZoG4ohaYTrUzYevJI8EiM0kbQ4s=; h=Message-Id:In-Reply-To:References:From:Date:Subject:Content-Type: MIME-Version:To:Cc; b=Yqtb5DXcr+zQYN9u/eXieNiSi85zEluQFbzqtr6D1FKcN1zMdCsuZPcUpyNQUVvlCFq2U2SkQH6xpu8iFMd8Bexd8JXojAkKACopx/DAHarkTyetVYRvT4xgDeTlc5TTX4AEAmt+F90WiGRz/tc7/3T7aAfqj8X8d3NIGHgdGDQ= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=eMv+mHRq; arc=none smtp.client-ip=209.85.221.45 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-wr1-f45.google.com with SMTP id ffacd0b85a97d-343b7c015a8so3980691f8f.1 for ; Tue, 16 Apr 2024 16:02:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1713308521; x=1713913321; darn=vger.kernel.org; h=cc:to:mime-version:content-transfer-encoding:fcc:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=6iXzajJXvNCHbN9kIrXvJadshJjhNqLOyZvoeEKSOmk=; b=eMv+mHRq6DUodyOrp6Dz3hItDurifjWr7hVJ4AQZS3lOfMGaCj6agv0yBmNOgkcwz4 JJMIkpUbEkTiRcN2Ngr6fyFn43WeKPb6Fbb66npSZl65B62KGc2PYap8wuR9REO9P7mh 6ycTnCqiWUomd6oyqQVHAghPJYFUpcydFq28KCwn2kW1/R3JINY5zkzdL+XiDUrIP4f1 dCI6gLoUOpECMglANoYnOyHO0sVIAq0XLEiC/o/lGwvSz2IIyJ08hk9uqcjlt53U1cUM 9s4cUyJ6q5B/eZYdXZ/UXgW9nSo33A9ggfLOjU6M3yGosvQoesHN3FdnOk9yo5oNjVxe awKg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1713308521; x=1713913321; h=cc:to:mime-version:content-transfer-encoding:fcc:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=6iXzajJXvNCHbN9kIrXvJadshJjhNqLOyZvoeEKSOmk=; b=VauQJeIybtX17pXQj+jkcz/SAICyEXsNZg3jCy62qPh0YFsST2kaQskDKkNF6Xbppp 3nKiH59KiVMliwxecTs+79vB6DuhadatvXatDq843mtX3C8yBPNi8mMpXF7Ewq3UP6NZ cm40PU8VsxaorKpq795HSaE3mNUbbr65OIMz7kIMozpjUm3n5QSKCQOMuVEGXiAJoKa/ 4naqdyy7liyBsAmEYok6C075h7xtpF/UIZDaa268GnE6wjj6BpbPyviZOF+lEHx15lFm jvaT7qbVQVXc3gMjFiuJG0i9ck8vS0gl7H7Ds8sh/CSWq6nSManX8tqHbZ7e70wstrwq BnuQ== X-Gm-Message-State: AOJu0YzibcAKc5vyVeELUaXz7c4rkgJSh4M4rY/GHuCorfi98P0LHPtY BNvqKkZd3bCTlF9FqS8rpiJuRkHrpXgi0M4Y1aw3sYjckHWOinsGM7taVA== X-Google-Smtp-Source: AGHT+IFRq4TChBv3V/gQxtKjUJi2PXk5XbrzB4pNN+aynPf1CG2ADyIC0X9MKK+tvf5YFVfnT4RIkA== X-Received: by 2002:a5d:4104:0:b0:346:9903:d10f with SMTP id l4-20020a5d4104000000b003469903d10fmr9618363wrp.12.1713308520551; Tue, 16 Apr 2024 16:02:00 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id a16-20020adfed10000000b00349ac818326sm646851wro.43.2024.04.16.16.02.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Apr 2024 16:02:00 -0700 (PDT) Message-Id: In-Reply-To: References: From: "Linus Arver via GitGitGadget" Date: Tue, 16 Apr 2024 23:01:50 +0000 Subject: [PATCH v5 1/8] MyFirstContribution: mention contrib/contacts/git-contacts Fcc: Sent Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 To: git@vger.kernel.org Cc: Junio C Hamano , Johannes Schindelin , Jonathan Tan , Emily Shaffer , Patrick Steinhardt , Matthieu Moy , Eric Sunshine , Kipras Melnikovas , Linus Arver , Linus Arver From: Linus Arver Although we've had this script since 4d06402b1b (contrib: add git-contacts helper, 2013-07-21), we don't mention it in our introductory docs. Do so now. Helped-by: Junio C Hamano Signed-off-by: Linus Arver --- Documentation/MyFirstContribution.txt | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt index f06563e9817..9665951aeb5 100644 --- a/Documentation/MyFirstContribution.txt +++ b/Documentation/MyFirstContribution.txt @@ -1116,6 +1116,16 @@ $ git send-email --to=target@example.com psuh/*.patch NOTE: Check `git help send-email` for some other options which you may find valuable, such as changing the Reply-to address or adding more CC and BCC lines. +:contrib-scripts: footnoteref:[contrib-scripts,Scripts under `contrib/` are + +not part of the core `git` binary and must be called directly. Clone the Git + +codebase and run `contrib/contacts/git-contacts` (you must have Perl installed + +in your system).] + +NOTE: If you're not sure whom to CC, running `contrib/contacts/git-contacts` can +list potential reviewers. In addition, you can do `git send-email +--cc-cmd='contrib/contacts/git-contacts' feature/*.patch`{contrib-scripts} to +automatically pass this list of emails to `send-email`. + NOTE: When you are sending a real patch, it will go to git@vger.kernel.org - but please don't send your patchset from the tutorial to the real mailing list! For now, you can send it to yourself, to make sure you understand how it will look. -- gitgitgadget