From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: pillule Newsgroups: gmane.emacs.help Subject: Re: Documentation Date: Tue, 08 Jun 2021 13:25:13 +0200 Message-ID: <8735tszic3.fsf@riseup.net> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20394"; mail-complaints-to="usenet@ciao.gmane.io" Cc: help-gnu-emacs@gnu.org To: Brandon Taylor Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jun 08 13:55:08 2021 Return-path: Envelope-to: geh-help-gnu-emacs@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 1lqaK3-00052n-MR for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 08 Jun 2021 13:55:08 +0200 Original-Received: from localhost ([::1]:34324 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lqaK2-0006lt-JA for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 08 Jun 2021 07:55:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50398) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lqaFN-00078q-Ui for help-gnu-emacs@gnu.org; Tue, 08 Jun 2021 07:50:17 -0400 Original-Received: from mx1.riseup.net ([198.252.153.129]:35652) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lqaFL-00076s-Q0 for help-gnu-emacs@gnu.org; Tue, 08 Jun 2021 07:50:17 -0400 Original-Received: from fews1.riseup.net (fews1-pn.riseup.net [10.0.1.83]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "Sectigo RSA Domain Validation Secure Server CA" (not verified)) by mx1.riseup.net (Postfix) with ESMTPS id 4FzpT23ctkzDqJt; Tue, 8 Jun 2021 04:50:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1623153014; bh=KuIa5TxObXEIclO001kFu+1EhYN333UeZlT6KwedgvU=; h=References:From:To:Cc:Subject:Date:In-reply-to:From; b=eOFfsh1dgoGX53adfzurw1AQmZhad2OA4TbfsTYBiwtUCYQXkhOJuNiarKlAB0Ecb u3lnVKehAB2pjDdcnsuIu4n7l/QEjxFYMGq8rgdoCyLxyRlnT+19VrLLDMIbBNxnGR Yp9RnY+kQdU6dI2AkTkni9Xfr4fsJemLgZaa/ra4= X-Riseup-User-ID: 80D7D2DDFC402366CBA8211E28376EF74F4D91E3F7E2FE75F9268819810C61B5 Original-Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews1.riseup.net (Postfix) with ESMTPSA id 4FzpT03Xt5z5vks; Tue, 8 Jun 2021 04:50:11 -0700 (PDT) In-reply-to: Received-SPF: pass client-ip=198.252.153.129; envelope-from=pillule@riseup.net; helo=mx1.riseup.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:130620 Archived-At: Brandon Taylor writes: > I=E2=80=99m currently working on a simple .texi file which talks about=20 > how end users, if they so desire, can > help patients in India who are struggling to recover from the=20 > current COVID-19 pandemic. Would it be > worthwhile to include such a document in Emacs=E2=80=99 help files, and=20 > if so, where in the repository would > be the best place to put it? > > Brandon Taylor > > Sent from Mail=20 > for Windows 10 Hi Brandon, Please don't take the following as an authoritative response, I am=20 not a core developer ; If I understand well, what you are referring by =E2=80=98help files=E2=80= =99 are=20 Info manuals. There are many Info manuals that are not directly=20 related to Emacs. On a debian OS you can search for them and=20 install them without Emacs. Eg one among many others, the package=20 jargon that is described as : Description: the definitive compendium of hacker slang This is the Jargon File, a comprehensive compendium of hacker=20 slang illuminating many aspects of hackish tradition, folklore, and=20 humor. The file is in info format, but includes an HTML page with links to the home site. Installing this package, does not even update the info directory=20 available from Emacs. Also Emacs does not have the monopoly of=20 Info manuals, there is a shell command `info' that can be used to=20 open a Info manual from a terminal (but it's better with emacs ;). Even useful Info manuals that are related to programming are not=20 in the Emacs repository (eg : the bash manual, the core-utils=20 manual). So to answer you question; no, I don't think that your .texi file=20 belong to the Emacs repository because it does not seems directly=20 related to Emacs. It can be distributed by many ways (on Internet,=20 on GNU/Linux packages repositories), and exported in also others=20 formats that an Info manual such as html etc. But I maybe wrong, and if you want to request this addition on the=20 emacs repository, the appropriate place to do so is to fill a bug=20 report with M-x report-emacs-bug or via the emacs-bug mailing=20 list. --