From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id WE+pE78+BGMmUAEAbAwnHQ (envelope-from ) for ; Tue, 23 Aug 2022 04:43:11 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id kF6eE78+BGPGKgEAauVa8A (envelope-from ) for ; Tue, 23 Aug 2022 04:43:11 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id EE9CE2E6F2 for ; Tue, 23 Aug 2022 04:43:10 +0200 (CEST) Received: from localhost ([::1]:46408 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oQJsj-0007pv-8f for larch@yhetil.org; Mon, 22 Aug 2022 22:43:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40660) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oQJsA-0007pb-FE for emacs-orgmode@gnu.org; Mon, 22 Aug 2022 22:42:34 -0400 Received: from mail-pg1-x52d.google.com ([2607:f8b0:4864:20::52d]:40581) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oQJs8-0002rR-Ka for emacs-orgmode@gnu.org; Mon, 22 Aug 2022 22:42:34 -0400 Received: by mail-pg1-x52d.google.com with SMTP id w13so5995796pgq.7 for ; Mon, 22 Aug 2022 19:42:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:from:to:cc; bh=MKLVtRF/lWc1kzVol4cjAUzOtt4v0gDZc0HaIPfwtHQ=; b=Aiz4zlKpsOzS7GnKn5kEztcR+2qMd9SJe0DTQ7GXNkBltBb8o7Q1tT6YARoheAdvcv hEp/BcdBrZ9kiPFpxgGYpQCVqi/4hVVj/nr7xeI6mPFmiI9CMJn6Ao2F1XqjMVfsK1Kx mg7JOK40mWE+oAi2np5tTLO7vDPH9CeYn3P5TuCc4mK/tCdWcXtYCgkUdHpzBU0woio2 bbLb9SSZtpJcOpy3KnNXpmYmfNrBRnEBslm6VB2yjS54lsC0avRseDc6tXnKbRHW3IMg 597BW98j3dLV71I0b0ZH7kxtc8f/OK6xKzIoCsOuldv50VGso7E7T+mArhDEefuwjkvZ RaAg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc; bh=MKLVtRF/lWc1kzVol4cjAUzOtt4v0gDZc0HaIPfwtHQ=; b=ng+hk8aNek0RyStBqFTWyrFPKzNJOdz/9seIhESLChYV9Y0gtQseI698HMLgI9qBMG mW0kF1C7Qv+U98+v/lOl1/WxcVNsRO31HOxukiDv68jhBLj20ivX/iY+F4SUQmXf9gl5 Ibmd4dtEddS1y4legSCc5AOytPOX6YpMOFG0dmHUOA2jG63W+rJzl+82WJX5LB6uMMPs NXnb/5L8+bbDs5hliIaqzf/2ZHcDTkCem2jRmvIBtXLP4e4qUtQNIUAjWTFQj+1jbPUe IYIvkS3C9o8daNki7Y0iV3k6vBU/gf1MMSUmXcHYT4TiLFGlrVPH6rd6eORnYA12vzcb XYzA== X-Gm-Message-State: ACgBeo2huRZ5V6p6CYvNgQMClPCM79L+CkjLwyJHp3jocpeExwzcL/Zu R28xdLG0388od858r7SdyLA= X-Google-Smtp-Source: AA6agR4hrbnY6Cp+HghawRt5ZYOJcNLZXOBC6n3R9/E/B5rqY7NOGYgFp+Gyf5fJ0uNVsAhtqw2jnQ== X-Received: by 2002:a63:1e5f:0:b0:419:d6bf:b9d7 with SMTP id p31-20020a631e5f000000b00419d6bfb9d7mr19415513pgm.593.1661222550451; Mon, 22 Aug 2022 19:42:30 -0700 (PDT) Received: from localhost ([115.154.175.57]) by smtp.gmail.com with ESMTPSA id b1-20020aa78ec1000000b0053692028ec1sm3394497pfr.34.2022.08.22.19.42.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Aug 2022 19:42:29 -0700 (PDT) From: Ihor Radchenko To: Max Nikulin Cc: emacs-orgmode@gnu.org Subject: Re: applying patches In-Reply-To: References: <25334.19025.107017.390781@gargle.gargle.HOWL> <87tu6g7iul.fsf@localhost> <25343.32450.336604.84364@gargle.gargle.HOWL> <87a67znzxm.fsf@localhost> <25346.19351.105465.183755@gargle.gargle.HOWL> <87wnb0scos.fsf@localhost> Date: Tue, 23 Aug 2022 10:43:35 +0800 Message-ID: <87tu638yso.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::52d; envelope-from=yantar92@gmail.com; helo=mail-pg1-x52d.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1661222591; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=MKLVtRF/lWc1kzVol4cjAUzOtt4v0gDZc0HaIPfwtHQ=; b=Kt+Odh3s9jtbBfvoA1rzWVu1iL74zHDH/DSzqT7ezFZ+KxuENpnB8QBA7wL5MNnsMg6F5k zh3WZQAIVG90pk/M6V1zYFVcZukks+Jan0S4sfS4Le0iBv/LYN8JOvvNBPP2Ea+yXnjVzY MO9RnLxa8ZtCG4nbrAXknWPXFQOrU17zovqpslhlAM+joywkaMgZkcknqCAIaEAB/XBvFO HWeccKkV7CyJAzarvP4AFO9XHnOM0VSCXTTCupb4LwiQdTKseTlovcKdeb9K1zkM6HBydU 3JC7DoZXHtIfmsb9YOA0wBUvioX6HCOKyySLBxsVzKC+T5h/g/03BZLVHGwV5w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1661222591; a=rsa-sha256; cv=none; b=aYfhi7uy2b3NaUkvq7doQZGMhnxAg2No+X8fHD+kyvhD7j0ml/fqS6dc1J+ZmkB7+20bVf CBFo5jbw4GpKHbRr5BVZ67M6DiiLUpXO68/hfRv5srDyQySK6GH8IwzV4yIH1vds3/JmcH uT0xQVsgYaWoRNlLJtkgFyJPcewai/LPAO0llacHaTo87AzmyewW+sOQZtUgn9iNwNQq80 3xDjwfaTNEGKw575mux0qDapRi8wbaMlQs1g0bSxgnXWx1wTeniMwLYjSJ/u/8Hf5EkTaw tb/olW8cWTuNpZxfizJC+fv581vOt9252+6scNPj0jRkwUB6EWAbshgGYtIslQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Aiz4zlKp; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -1.80 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Aiz4zlKp; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: EE9CE2E6F2 X-Spam-Score: -1.80 X-Migadu-Scanner: scn0.migadu.com X-TUID: mwNG00SX2a9k Max Nikulin writes: >> It might. It is probably even useful. Would you mind writing several >> paragraphs for the manual about applying patches? > > It may be enough to add links to already written documents. I'd say that the purpose of describing patch or git apply in the manual is a quick reference for ordinary users who report a bug and want to test the proposed fix. More detailed instructions may be added to https://orgmode.org/worg/org-contribute.html > For those who are familiar with git: > > https://git-scm.com/book/en/v2/Distributed-Git-Maintaining-a-Project > > Perhaps I have seen better introduction how to use the "patch" command than > https://www.gnu.org/software/diffutils/manual/html_node/Merging-with-patch.html I'd better see these links in org-contribute. Possibly, we can add a new item to "Ways that do not involve programming": - Help to test the proposed patches: You can help checking the quality of existing patches submitted to the mailing list. Just apply the patch (see [[how to apply patches]]) and try using it with your Org setup. Then report any issues or rough edges. <> can then detail different ways to do it and provide the above links as further reading. -- Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92