From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Protesilaos Stavrou Newsgroups: gmane.emacs.devel Subject: Re: Improving documentation of Org Mode integration into Emacs. Date: Mon, 03 Jan 2022 14:06:02 +0200 Message-ID: <87zgodkor9.fsf@protesilaos.com> References: <87zgpgax7w.fsf@red-bean.com> <834k7n5zfu.fsf@gnu.org> <87fsq5tnni.fsf@red-bean.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21825"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Notmuch/0.34.2 (https://notmuchmail.org) Emacs/29.0.50 (x86_64-pc-linux-gnu) Cc: Karl Fogel To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jan 03 13:08:05 2022 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 1n4M8C-0005Wu-O1 for ged-emacs-devel@m.gmane-mx.org; Mon, 03 Jan 2022 13:08:04 +0100 Original-Received: from localhost ([::1]:34054 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n4M8B-0004Lf-Ns for ged-emacs-devel@m.gmane-mx.org; Mon, 03 Jan 2022 07:08:03 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:60300) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n4M6O-0002wp-45 for emacs-devel@gnu.org; Mon, 03 Jan 2022 07:06:14 -0500 Original-Received: from relay1-d.mail.gandi.net ([217.70.183.193]:56127) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n4M6L-0001Dg-7W for emacs-devel@gnu.org; Mon, 03 Jan 2022 07:06:11 -0500 Original-Received: (Authenticated sender: public@protesilaos.com) by relay1-d.mail.gandi.net (Postfix) with ESMTPSA id C8A21240008; Mon, 3 Jan 2022 12:06:03 +0000 (UTC) In-Reply-To: <87fsq5tnni.fsf@red-bean.com> Received-SPF: none client-ip=217.70.183.193; envelope-from=info@protesilaos.com; helo=relay1-d.mail.gandi.net X-Spam_score_int: -6 X-Spam_score: -0.7 X-Spam_bar: / X-Spam_report: (-0.7 / 5.0 requ) RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=unavailable 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" Xref: news.gmane.io gmane.emacs.devel:284026 Archived-At: On 2022-01-02, 23:05 -0600, Karl Fogel wrote: > +Each externally maintained package lives in its own subdirectory in > +the Emacs tree, and that subdirectory should have a "README" file that > +describes the upstream origin. For example, "lisp/org/README" says > +where the Org Mode project lives and how it's synchronized into Emacs. > + > +Note that not all the independently-maintained packages in Emacs have > +such a "README" yet. If you know of one that's missing its "README", > +please send in a patch or just let us know. The modus-themes are maintained externally. I sync them with emacs.git every month or so when I release a new version. Their .el files are in etc/themes/ while the manual is in doc/misc/. I am happy to provide a README, though neither of those two directories is specific to the modus-themes. Maybe I should include the relevant information in the themes' manual and/or the "Commentary:" of each .el file? -- Protesilaos Stavrou https://protesilaos.com