From patchwork Sat Aug 7 20:29:16 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Soft Works X-Patchwork-Id: 29335 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a6b:6c0f:0:0:0:0:0 with SMTP id a15csp1590676ioh; Sat, 7 Aug 2021 13:29:30 -0700 (PDT) X-Google-Smtp-Source: ABdhPJw1tKOosdRc36NBAgrP4O9LM+NtPJbbRy/KglSm+NXojWEtV5BsLQQ4G9JahzMYN7zX1jQR X-Received: by 2002:a17:906:b0c5:: with SMTP id bk5mr15401650ejb.428.1628368170796; Sat, 07 Aug 2021 13:29:30 -0700 (PDT) Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id w5si12938318edl.176.2021.08.07.13.29.30; Sat, 07 Aug 2021 13:29: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; dkim=neutral (body hash did not verify) header.i=@hotmail.com header.s=selector1 header.b=nXzsMALT; arc=fail (body hash mismatch); 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=hotmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 7508A680986; Sat, 7 Aug 2021 23:29:26 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11olkn2020.outbound.protection.outlook.com [40.92.19.20]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id CA02B680986 for ; Sat, 7 Aug 2021 23:29:19 +0300 (EEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=a+BabYelhYk0I9Da86rWOWVhQrxDtLmnxRhwtEZZ9yn1RUJYww/e9NgXYs/Czo41tliRt1rKyrYjIg0oMr9WDACF/H0/4gKE2y6YcHgZOEdUW2iqul3l5JLZLnj6YuNfNEJ4RIuUZA7IjrGTkkigMnwnOXHP7lM2Sw7fO27dCjYbFPL7QA4Mi0JNHI8+gPKahh6Msg1Mo8fD+ud6RsmmQ/SusW2goZILTMThBqE8BHpQXni/2TGibEzK1cfMUe0bIuRvl/Tiyx1ugb1m1a6suKEUs18S5JxxVaMdEk4SA2q668ijJ0aNmJXoDwd6IKNWtkI4Rtecs9wwusUN7ttRuw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Y/zBrEm98Bz8V9G/Xre/HR2NyJLAxLbvk9YYaz5u12Q=; b=Ar50iLkZ5T4NvqlmSvHGhvx+fok7PX1Ysnb4A76/7H9DQVVCp9DXikUGIlYUMeRSu5ffnYgAHcExe4CkLcK+d3zlgor0Z/2NqDRY7jv0sRl2wMUruqFF+d4MVJi7x2sAZ0XxGIl/IymYwK/Be8LY24P/EtzgFukPWaLC3neTkoGUWPN08YLfQVSPFP2MNiWbMs4AwwzVc589WYdMjz8mW+04uQkf4i/hoymBg73v2D2kt9M4woM3bfJvLqwkOeULnqZ0lMRiynGYXZEd5HDLgFfSESEcF5cetMzAy9OsV4pOzzed1kfrGwQUcucFQ4pAr4yQ0KNlNEezWf/aRpe3Gg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hotmail.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Y/zBrEm98Bz8V9G/Xre/HR2NyJLAxLbvk9YYaz5u12Q=; b=nXzsMALTB/nBx0lEmJOA74WZfjt4dBt/I1d+rqDoSWQpwZZ5OAVMICY+jj7WMBk3lrPlqDMbrPZ9/L0v6XBhxodVTkRqk0GXgMQpVqWfAQtWUouJFcbGMO9nnJIBovgr7+WDWyo2KbZT6HRXhyFx77ZdSXO2GUIh5Ex7qnOjoU44O2NRuapoPFNhk6S8bVJYZAWT4zUS26k2uoIgWhfaBBArpWyuCdc1wJ1tp6QSftVxWZQ1ushgElBlRdFN36qQQ3QHJ/7ikfQ1o8+sRN1Qa2xrKoG36j+6N1U/KHPzHkA7ejWH+AA/NNxE0pM6xQhX3J2wDxGrxW7G4oFhBxxLHQ== Received: from MN2PR04MB5981.namprd04.prod.outlook.com (2603:10b6:208:da::10) by MN2PR04MB6205.namprd04.prod.outlook.com (2603:10b6:208:d5::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4394.18; Sat, 7 Aug 2021 20:29:17 +0000 Received: from MN2PR04MB5981.namprd04.prod.outlook.com ([fe80::5d83:1c26:c2b1:3a30]) by MN2PR04MB5981.namprd04.prod.outlook.com ([fe80::5d83:1c26:c2b1:3a30%6]) with mapi id 15.20.4394.021; Sat, 7 Aug 2021 20:29:17 +0000 From: Soft Works To: "ffmpeg-devel@ffmpeg.org" Thread-Topic: [PATCH v3] doc/developer: Add description about safely sending patches via E-Mail clients Thread-Index: AdeLR3kEDGz8o+hFRkOynr9/uJ8bbA== Date: Sat, 7 Aug 2021 20:29:16 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-exchange-messagesentrepresentingtype: 1 x-tmn: [Ec+RxdNgUGt8b55ePXk+EWytQrDU/prE] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: e81612a1-b282-4099-5f35-08d959e20768 x-ms-traffictypediagnostic: MN2PR04MB6205: x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: x9JwVde5LmwIinxFZiReykIeBS5hQx79ZrUSnHhgs4BT6taod6RiQYHEMqCR4RV2NvbFsymtEIctqbSSwVN2Dy36P7uY/BVyWbABetMu5DOpkLC/S65XbS04Mgz7doEKw371b3aG4bHNKQg/o2h+9JtO2Rsw7mHMHX9VgQo5vMacHyf6wRs5mk7YuBLOvOsDZNGZrg6iB/SyKWfTZQ1igFuhwN+0BNb+A8DX3mG0iQDZWT0t/fk3hPfKQHHVA4gvQ6n+MsLolLXLzfBPWa9hA7IjNJoebZRvmZYHsa3UN7OJfQhi2St5woxwkgVpau58DVXlGg7CLnyYHirJo5FQYsgx9CwGi66txf3FWkQ1QGSN9UGHX8QiyL2WXYj54pS36ynY9LqT/h47lRPgdmrZlP/sQY0Pb7kJ5zCL7smi45p22+UHz7XEDuTS6fexGdx4inUIBhFNnnYMtwfBS10k/rwobozhM7K/XA22QUgyjic= x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: I9DTL8PYghmf0A5VwfoukH7UkS4WQX8Xluj7copQsvak48rb/5Ku5bHrk/ds6/7gVrl0/5XAdBIg3GZvgT9BWqAQC08waDQmRd1Q3xC1QxavCNU0gOcq3JaQkr86lV+mR4F9S7pyQ1mgl1xol78VSA== x-ms-exchange-transport-forked: True MIME-Version: 1.0 X-OriginatorOrg: sct-15-20-3174-20-msonline-outlook-529c7.templateTenant X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MN2PR04MB5981.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-Network-Message-Id: e81612a1-b282-4099-5f35-08d959e20768 X-MS-Exchange-CrossTenant-originalarrivaltime: 07 Aug 2021 20:29:17.0727 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR04MB6205 Subject: [FFmpeg-devel] [PATCH v3] doc/developer: Add description about safely sending patches via E-Mail clients 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: wTyFsAiT3A4I Signed-off-by: softworkz --- v3: fixed typo doc/developer.texi | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/developer.texi b/doc/developer.texi index b33cab0fc7..86f63c49b3 100644 --- a/doc/developer.texi +++ b/doc/developer.texi @@ -494,6 +494,22 @@ patch is inline or attached per mail. You can check @url{https://patchwork.ffmpeg.org}, if your patch does not show up, its mime type likely was wrong. +@subheading Sending E-Mail Client - Example for MS Outlook. +Using @code{git send-email} might not be desirable for everyone. The +following trick allows to send patches via E-Mail clients in a safe +way. It has been tested with Outlook and Thunderbird (with X-Unsent +extension) and might work with other applications. + +Create your patch like this: + +@verbatim +git format-patch -s -o "outputfolder" --add-header "X-Unsent: 1" --suffix .eml --to ffmpeg-devel@ffmpeg.org -1 1a2b3c4d +@end verbatim + +Now you'll just need to open the eml file with the E-Mail application +and execute 'Send'. + +@subheading Reviews. Your patch will be reviewed on the mailing list. You will likely be asked to make some changes and are expected to send in an improved version that incorporates the requests from the review. This process may go through