From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Dr. Arne Babenhauserheide" Newsgroups: gmane.emacs.devel Subject: Re: contributing to Emacs Date: Sun, 18 Jun 2023 11:26:37 +0200 Message-ID: <87wn01drad.fsf@web.de> References: <83v8fnslfz.fsf@gnu.org> <87v8fnh1h2.fsf@web.de> <83mt0zs9rc.fsf@gnu.org> <0a968a4e1b267c0f15dd237e6ea12a709fc06d5e.camel@yandex.ru> <838rcisj7o.fsf@gnu.org> <6537fa5fa5c1fe8437ed99ee0988e35895f5a54b.camel@yandex.ru> <8423a35750d8d8e0437c7708f6b4d0bbdfdb7fe0.camel@yandex.ru> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4385"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.10.2; emacs 29.0.90 Cc: Konstantin Kharlamov , eliz@gnu.org, luangruo@yahoo.com, emacs-devel@gnu.org To: "Alfred M. Szmidt" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 18 12:00:37 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qApD3-0000yF-BN for ged-emacs-devel@m.gmane-mx.org; Sun, 18 Jun 2023 12:00:37 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qApCV-0007cS-1j; Sun, 18 Jun 2023 06:00:03 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qApCT-0007c5-Bm for emacs-devel@gnu.org; Sun, 18 Jun 2023 06:00:01 -0400 Original-Received: from mout.web.de ([212.227.17.11]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qApCR-0007o1-AQ; Sun, 18 Jun 2023 06:00:01 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=s29768273; t=1687082395; x=1687687195; i=arne_bab@web.de; bh=D8Pj5FCLWuLoMOVIbItF7iZCSioV9Ow92cVoeIdjYF8=; h=X-UI-Sender-Class:References:From:To:Cc:Subject:Date:In-reply-to; b=ZXCI8lqjaquFLiWFY2XC7Trg98wcNik53FbhP5IAa9Z5LXqGI5QLeByk2uA0WUUn+C7Jh3K iodBRI18u5RET7Wiwu9pe4tYvN6HBae8VNU93WNvPpKWXKvHtWsa35rJ28EXJZx/IUx8MygLq fx1U8LvKXAJ4vqG1OBEVW4QwuFGhLh+nFdDBiJ4xcvPUBFhBoE5KAAcmEXzqwlK8QaaD9cdv8 qOOvokg2420l6dsTVV4C2+Fw4OfoMY4uIgp4FT7AIEPCQVsn5w9yO+Oi5q1N1q1xeL4NGFOIL KNGghoniGKrZTEP/IyIHkffUz8hatP+zTR3MTHyur2IrTuTdjurw== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Original-Received: from fluss ([84.165.25.222]) by smtp.web.de (mrweb105 [213.165.67.124]) with ESMTPSA (Nemesis) id 1Myf3v-1puNde0tzx-00z1k3; Sun, 18 Jun 2023 11:59:55 +0200 In-reply-to: X-Provags-ID: V03:K1:qSpC7Pg4K82pB+hmuNBZKy6+yxXJ+fCrl0iNRnoWmtRU2YRbGhK yvNHfDTGH7Qt+hUgXGNHd7skccjrUZcJZfvRJ9O/ssRnx9TznObAXJZK66jKNtMQVVvJKLK HHdG7Q9zu32wZw2SjqG/N4Arbk5N0vUhj8XIG9ODKz85YyAzAujXSrnjIL5FRQWyDpZA+K8 pX60fYe0B+l7FUSeMMHSQ== UI-OutboundReport: notjunk:1;M01:P0:L2gIFVMoO+w=;Pc/znG8rWjCaUfKnpnh8+80u4Me w45nIFBef0ljTIlUi5rkz7EXZCc39aGBmmR889W/L/oveXiemo/CugTB1K6grKFTdp0lUXJlX aWsDjfZ7VrNIiKClqF99/PnocmWKi0XtUbMe+9a0/usjGwPYcUUYC2g0EvrALg4U5UXi0c3/T MTvzTypPHLkSBUecvIuojuYdMDfIWlBUSLOapYnXDqkKpgrjx0BcQw6C8sD8RlQ7D/KYJ5tU4 cqpozUqYu5LeL8VRhHGJU/3qMCZqqt8N9Oc0JO8X6bWu49czXrEcq9WqSz+BonB7/Hqow8rol DRTLCzxpXkED4N2rlR2xu/sIMjf6gAkjG9N1IFYP6MY21+t3UsCCrFvopc3+1jVcsZ1dlRLPc NT7yeQPj0kknri0wmhr/otP/JWjcmpBl7lA1Y7SX1f6StFf2t+FwKAE+AvJlv1hwP9ezadq+T bCB/uhNrHvhDFWYMTpbIkqv1sp7HzEuwXkXhsIdivOe8IB+v9nLiJBhrSHtjv65U2Zhk69iVi qic9BBPYi+Ey7i0eDoDKLSZ5JogNK9ntnLh5S3wWYnUIedYo+E5o5puX7q0E6Q0o2biaSx/Ns jXDYUb4pWN3zAOsmJHm5DJX4i9kQMw37DPulqJL6kQW6uXlaOEpAI76r/LxWGm7IUyLV119BU 3AM3aHLVjiaKm7aoOouD5tXmijog0yjjZZMHWpufTfaymEQ4V1W/T1HNWmScJsqnEWC6S7Brn MqwNbn3tN46wnnJvwY+NzhN5DhBacnwJFdshjtsfOEyFBQRjBF7PnbpGaKvADomuzvxUnQLK Received-SPF: pass client-ip=212.227.17.11; envelope-from=arne_bab@web.de; helo=mout.web.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:306940 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable "Alfred M. Szmidt" writes: > So, yes, contributing to Emacs is hard. > > You might not _prefer_ the way it is done, but it is not hard as you > purport it to be. The chapter "Sending patches" is eight relativley > simple bullets, the CONTRIBUTING is also not a very hard document to > follow. I think here=E2=80=99s a misconception about writing: 8 bullet points is not simple. 4 bullet points are simple and can be grasped by humans directly. Anything more becomes complex. But let=E2=80=99s not discuss without the context at hand: =2D Sending Patches: https://www.gnu.org/software/emacs/manual/html_node/em= acs/Sending-Patches.html =2D CONTRIBUTE: https://www.gnu.org/software/emacs/CONTRIBUTE The starting point to contribute is usually the website:=20 https://www.gnu.org/software/emacs You can find Sending Patches if you click on Documentation & Support, then go into the manual and search for sending patches =E2=80=94 or check i= n the reporting bugs section. That=E2=80=99s at least 3 clicks if you know what y= ou=E2=80=99re doing. If you don=E2=80=99t =E2=80=94 good luck finding it. The Reporting bugs section in Documentation & Support only links the CONTRIBUTE file as plain text, even though it=E2=80=99s org-mode, so it cou= ld be linked as html (easier to read in the browser). That=E2=80=99s only two lin= ks to click =E2=80=94 again: if you know what you=E2=80=99re doing. As an aside: IRC is linked in "further information", not in "documentation and support" =E2=80=94 I=E2=80=99m not sure why that page ex= ists, because all the content seems to belong to Documentation & support. Maybe that could be replaced by a dedicated "Contributing" page with a shorter version of sending patches. To make this constructive: If this is intended to be easy, I=E2=80=99d have imagined something like this (using Sending Patches as base). =2D----- ------ ------ ------ ------ ------=20 To contribute patches please make them easy to use for maintainers: =2D patch format: Send patches with explanation in a single email as MIME attachment or inline. Create your patches with diff -u (with the old version as first version) or with ~git format-patch master~ (for commited changes) or ~git diff~ (for uncommited changes). =2D commit log: Include a commit log entry in the correct style. They are described in https://www.gnu.org/software/emacs/manual/html_node/emacs/Format-of-Chang= eLog.html Look at earlier commits for examples. =2D target address: Send unfinished patches for discussion to emacs-devel@gnu.org. Send fixes for an existing bug to the @debbugs.gnu.org address of the bug. Send new bug-reports with fix to bug-gnu-emacs@gnu.org. =2D patch content: Please send atomic changes: we=E2=80=99d rather get two = emails than one that mixes concerns. For new bugs, use ~M-x report-emacs-bug~ to include the information needed for bug-reports. For more details, please read at https://www.gnu.org/software/emacs/manual/html_node/emacs/Sending-Patches.h= tml =2D----- ------ ------ ------ ------ ------=20 I believe that this includes the essential information from https://www.gnu.org/software/emacs/manual/html_node/emacs/Sending-Patches.h= tml so someone following these 4 bullet points will already send patches in the required format. This should be much easier to parse for contributors. Best wishes, Arne =2D-=20 Unpolitisch sein hei=C3=9Ft politisch sein, ohne es zu merken. draketo.de --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJEBAEBCAAuFiEE801qEjXQSQPNItXAE++NRSQDw+sFAmSO1ZoQHGFybmVfYmFi QHdlYi5kZQAKCRAT741FJAPD68ydEAC1w1AAebmK3papiWyP8WuM5dG/XRnNsKQ8 QhzY10OraV5JG7c7gi08lho0i9A8z3JI4LqnC5SpEqA6fvNGQwV0vhbKJ6ptikp/ h90BYizhiL4Dwf5gMceoyFn/bN3R27yxQkiF9HTWVq4fHjUqeka4CLKM0N+qm0Hy oQeqI+QfDcJ8al7nzA2lyZKf9auWdj1chliMW9Nzav/w7qVFWiQetH1wlRKg/E+l 9TpCxKp7gPqhxcGEeL4yvAL8jD97DmHIjhn7ZQQlHmVpO55xhh3LcmDHIke5AL+u jb0aoz+P5kudgrMBh+OyS6OP9c9hNrDzkeMApQZN1DAYTX/FIjNLe51XBmTQOK53 8Q6FFBVtVqQWeq8byKv0yP2FgJRpk1Vo0JxjcPVt7tumfVfIwZtwpuZIBKj0zAUm bsJ6akZ/8sRokbcnZgGKV2TIYGt65GgEgijXwErkznG5G64U0kPwjI9LK6RboDgo B3SSaEKJc46ccDCGa1042TG6Ltw+aDCwHAKIcN+kQuKwNmOs8iZtGcp+xRhCNV36 /99gMZ4OSIp+eRrCKlJtCKWMVpHzkzRg+83Pa/fNH1PIAdutN5Bqxs1IFP2ISZeE HguaZrnHUorSm1ObjSnkvBbsB6bDz35MKnd6q2yqpgEnbMUGH91PBWHPfko6M7Rx ODdbmTc5kYjEBAEBCAAuFiEE3Si95tmHXKvOSosd3M8NswvBBUgFAmSO1ZoQHGFy bmVfYmFiQHdlYi5kZQAKCRDczw2zC8EFSER4A/9luxCHPE4KdJo3g3lgnd5gvzpV NdfVF7Jc42WbvFWHr225EAS4E66YZ9loLi0pg6bVqdjSjV1/AAGH+6+qlnghIQGk U7pLwpTKL8SwTU96g6b+EmDHMCJYWmW2Lm1+CPIh6xgcVsNj/9qJ5dz2EUO1OCtr x1AQRWwESgCWZmp9XQ== =MWEk -----END PGP SIGNATURE----- --=-=-=--