From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: contributing to Emacs Date: Sun, 18 Jun 2023 13:52:17 +0300 Message-ID: <83leghniu6.fsf@gnu.org> 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> <87wn01drad.fsf@web.de> <83r0q9nkzq.fsf@gnu.org> <87o7lddpcz.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4001"; mail-complaints-to="usenet@ciao.gmane.io" Cc: ams@gnu.org, hi-angel@yandex.ru, luangruo@yahoo.com, emacs-devel@gnu.org To: "Dr. Arne Babenhauserheide" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 18 12:52:54 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 1qAq1d-0000sJ-Cy for ged-emacs-devel@m.gmane-mx.org; Sun, 18 Jun 2023 12:52:53 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qAq17-0001nE-2q; Sun, 18 Jun 2023 06:52:21 -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 1qAq13-0001mm-RC for emacs-devel@gnu.org; Sun, 18 Jun 2023 06:52:18 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qAq12-0000tt-GD; Sun, 18 Jun 2023 06:52:16 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=13eQ6XHn1QvR+vwuJack6WpcdHrnL9RVgEtKSmPJ8Pc=; b=eX0rNyF4O8LZYACmFQ3A XIHLqsvirqvvQIuYiahJrOYsLkoj53IpkBZbSNIIYQ3gi+R5qHZ0Y1yyTzVHZre0JQ5KfCl7BwfNU fSqLMJg0UdOvuhA9P5mj0zGzMG8suFZBoMFVBdEWJVWonyBEpcaRN/0CUp746pZbuh+IiZnRWtzio RQ7mqUhElGICdV3/VH6Y1SVJtfzusCnmeqxpSlRag8t6TOOBJ0z0S74MOSySwLjTlFJOc+DvgPub8 WMUVh8tuKWEqtFhVQDhkZ+YkHdQhHe4uEOlNmveq5y5AMZpyHmValWTNKOR7XcgNVnJ0eAaneQLqY ui1R1V+gEKVdQg==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qAq11-0005uG-Ti; Sun, 18 Jun 2023 06:52:16 -0400 In-Reply-To: <87o7lddpcz.fsf@web.de> (arne_bab@web.de) 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:306960 Archived-At: > From: "Dr. Arne Babenhauserheide" > Cc: ams@gnu.org, hi-angel@yandex.ru, luangruo@yahoo.com, emacs-devel@gnu.org > Date: Sun, 18 Jun 2023 12:30:04 +0200 > > > This refers to other places, so if the reader needs to read them, the > > gain is largely an illusory one: you must read those referenced places > > as well. > > You don’t have to read those places. I took care to ensure that all the > essential parts for contributing a patch are in my shorter version. > > The reference to other places is there for people who think they have > special requirements or want to understand *why* the rules are as they > are. AFAICT, without reading all those places the instructions are incomplete. We might as well just said: send the patches to us, and omit all the rest. > Maybe the text should make that clear, so this should not be "for more > details", but "for explanations of these rules, please read > https://www.gnu.org/software/emacs/manual/html_node/emacs/Sending-Patches.html" Those are neither "more details" nor "explanations", they are what we expect from a perfect patch submit. I don't see how we can omit them, if we want to describe our conventions in full. Without such a full description, that whole section is unnecessary.