From patchwork Sat Aug 7 04:49:47 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Soft Works X-Patchwork-Id: 29329 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a6b:6c0f:0:0:0:0:0 with SMTP id a15csp1093846ioh; Fri, 6 Aug 2021 21:50:04 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwMx6abde7m9DOUf0luCOX35JozhwvyHlWk018yfLgpocBi5VtOEQDjywwd4upemPUqzzkT X-Received: by 2002:a17:906:c834:: with SMTP id dd20mr13038885ejb.371.1628311803895; Fri, 06 Aug 2021 21:50:03 -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 hr2si11091369ejc.132.2021.08.06.21.50.03; Fri, 06 Aug 2021 21:50:03 -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="tJ6//ftJ"; 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 EDD1968035C; Sat, 7 Aug 2021 07:49:58 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12olkn2092.outbound.protection.outlook.com [40.92.23.92]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id B19BF68035C for ; Sat, 7 Aug 2021 07:49:51 +0300 (EEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZWorHZJ/Iku60SSELDkXMcBE6aYvjayBY9iM/L+XObH0zDekMIm7iRrd99CS+JMwgrLVZFNyAAs7+uQwncmh8x6JXT6ASJ8MdtKFacQYOaWJNIvu7K6oD6BcbZKSnmkqeZl+gBqtq0ATM/asR0MpIoNYfztD2op5nDnQ9Lnhh+DvXM6r6unidODasf+Q1+2tvmzSYE68ZP4D8yrO3ahzv+r+hAQi9kU2HS6I+v7V0m92vDGeLbq5laYcf/pF6mXX0ZZKooNAltxLmR3kl/9LGRFkzsssLu1XFxmlLwBnxbVBuXUHC2NtdBMsh6FfIbaCrLSZ8sEVsy8qL1drVCbl1A== 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=SuqBa0pJvq/2+CYiHL5czX5hDQl2QUcsXmdPT8G0NiY=; b=ahmlzYpY31bQ2qvaGXgkq/eus7HMW8dD6ouSkAXFbM7o5JsUaZ6SHV8u9dqBTn9uyjHRrgDraAJexrdMzGgivIu4SZ17vwLP+QLg0WQDHZLMfgr79Ko+tQoAMycpxa4QrHoqIqKhSDBY3/Ns5qRiZVNei1eetTNe/p4BDsqKpCk+XPiq42C85Ijy7JBaqnOsuTOmN0oVpVKt9Q00YPJOeaoGmCLCOBgyxVh9D2DqSs1IhpeBHYguopH9qv9sL7D5Av5af9hQUZ/2F63MrgOu88ktnx5kLeIkDdNs/G68wloFvx66LCdrciqCrJycu9BG11JHZSPtp5wFKni8QWMSSw== 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=SuqBa0pJvq/2+CYiHL5czX5hDQl2QUcsXmdPT8G0NiY=; b=tJ6//ftJxJIEUfZDXivHIf3uHdntuNP/OcAb5YrrG3uHAAFczvp4H4pqxcNr/V60Y9aapC5fG0Rwx0NxHAquSq/upSyX7Z9Hh9EqCRR12lvNg80vtcUZ8ldvE/G8wXj9hzWGxXBqk+pG/A22DV0tPkLpqvbvgR8BwDJwCW54sZvIUNpALpjuHm+W+snii2YT+tuyD9kpWQWBh4V9DGTlHaKcuiS+nxDut42BgkDZLcbCGldBslRBo+gI8ASRY8D5hQfS2W36tg2q2WWvw5Mk4EJHZHNNQBFU/mZGWbdZTeTOWtO8nX2a5QslXIbYUaqH/JbkcWtq/8kXMW4j1F7BkA== Received: from MN2PR04MB5981.namprd04.prod.outlook.com (2603:10b6:208:da::10) by MN2PR04MB6174.namprd04.prod.outlook.com (2603:10b6:208:e5::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4394.16; Sat, 7 Aug 2021 04:49:48 +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 04:49:48 +0000 From: Soft Works To: "ffmpeg-devel@ffmpeg.org" Thread-Topic: [PATCH] doc/developer: Add description about safely sending patches via E-Mail clients Thread-Index: AdeLR3kE90Ky1o8USJSxFDuutlhndw== Date: Sat, 7 Aug 2021 04:49:47 +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: [//DYor/yrkijCB1Ivg2z/JIr6tRlZcPM] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: f413721b-65a5-48c8-6455-08d9595ec8cc x-ms-traffictypediagnostic: MN2PR04MB6174: x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: PPT8wLc9M4hqMWK5yxs9OmhC6Z7Rdb+S7+RcMns3hX644wAFXOqFPPBUkVlTMmCQwkMyR86U8fInPatSiKD5sTXdOWjlVe7/gIqroiXyWSkCPyvUcnKxj6Zegvdrt1NLA5BLrMl4fvZTKwRP+WXuWRHzMH4aGO2yqOmniLVcAloANUSf4a6YXKLr/LiA8YhTVupATdyI8rOupoQB/czxEt+dcrgaGfRdqTk1ILqqMx0nyKe96w+ocPwX0KR1UmJJTeskocbv5XYblnzLM34+piNYhgFzaWPoQ+F4n91VWhwr16zd2Gb2xRF+Ku0A9tbjftcYxv36kuCMqSPxd5qWZapnAQbOxZzwENdopEoEjMt2THZh8MmfUI7YJz54fcykUcr4Kps3mcTDRyc2A0vfdWTdzMIx9HR00y6PcAmhQtYaXFb3ljEu2IWZr5RPj4wH2xYFgYRBm9Hg1j8W/oX3+9GFaYpufKXDuf0dMIZLGjg= x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: AibC80FnNiLbI5CW0jiEQ/KnGgYmlp4J/YLFvlKoh5jy6VQrrD4sSTry7DdBKaV6jCUAEp3jyfs9V+8k9G4CGNnn32d40ou0doefXdyqdnekVJ5PPGEA/o6ZZDVrQOVbgQA0SR5sGSE6rfSNTFUDbQ== 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: f413721b-65a5-48c8-6455-08d9595ec8cc X-MS-Exchange-CrossTenant-originalarrivaltime: 07 Aug 2021 04:49:47.8942 (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: MN2PR04MB6174 Subject: [FFmpeg-devel] [PATCH] 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: VQlm+H2QdFtp Signed-off-by: softworkz --- doc/developer.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/developer.texi b/doc/developer.texi index b33cab0fc7..d909fa6ea5 100644 --- a/doc/developer.texi +++ b/doc/developer.texi @@ -494,6 +494,23 @@ 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: + +@example +git format-patch -s -o "outputfolder" --add-header "X-Unsent: 1" --suffix .eml --to ffmpeg-devel@ffmpeg.org -1 1a2b3c4d +@end example + +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