From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jeremy Bryant Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package c-intro-and-ref -- was Re: Proposal: Include C Manual from RMS in Emacs git, and/or release Date: Wed, 04 Dec 2024 22:58:44 +0000 Message-ID: <8734j3awd7.fsf@jeremybryant.net> References: <87ser8c230.fsf@jeremybryant.net> <86ser87rut.fsf@gnu.org> <86cyia4503.fsf@gnu.org> <87bjxsbc8h.fsf@jeremybryant.net> <86a5db1vc6.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16801"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, emacs-devel@gnu.org, philipk@posteo.net, Stefan Monnier To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 04 23:59:49 2024 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 1tIyLU-0004C6-Jh for ged-emacs-devel@m.gmane-mx.org; Wed, 04 Dec 2024 23:59:49 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tIyKg-0006Yx-1M; Wed, 04 Dec 2024 17:58:58 -0500 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 1tIyKa-0006Yb-Nu for emacs-devel@gnu.org; Wed, 04 Dec 2024 17:58:53 -0500 Original-Received: from out-180.mta0.migadu.com ([2001:41d0:1004:224b::b4]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tIyKY-0001nK-QV for emacs-devel@gnu.org; Wed, 04 Dec 2024 17:58:52 -0500 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jeremybryant.net; s=key1; t=1733353126; h=from:from: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; bh=I9HZxlZPfjrCNqUONV/YpXseGaquZlDvbc1JXKjvWAg=; b=emZtZjf6eHOdyCYya1OMhktMeXH9jpvbc8oAu1JSv90tScrddu9BNORvLSPKln4o5gNzP5 IlRsley6wDXHQ+lKRe5ern59yFb7gOUOPVSUZIdMD4NfKjXQ6cSaGjp4aClHXm76aMUvf8 AKx11uc415P2Qgjv/ut7RV0EyqJPtTksHEi8ZERawxP+GRbrVacgGTzOjKsoeHXpfCQExU Rm7K0YIMT6hORj5FM5dbG3Z8KwZ7dsTkzV1GWbSas4bwNa0L/0L/ECfQNnSTAYsSS6uavG 3AQK3rB7ocsx3HxlbarOkZtpKh3C0WnGprN1dbuFsMyVHAaLgtOSL3tkJIM/Bw== In-Reply-To: <86a5db1vc6.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 04 Dec 2024 14:33:29 +0200") X-Migadu-Flow: FLOW_OUT Received-SPF: pass client-ip=2001:41d0:1004:224b::b4; envelope-from=jb@jeremybryant.net; helo=out-180.mta0.migadu.com 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 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:326053 Archived-At: Eli Zaretskii writes: >> From: Jeremy Bryant >> Cc: rms@gnu.org, emacs-devel@gnu.org, Philip Kaludercic >> >> Date: Tue, 03 Dec 2024 23:03:42 +0000 >> >> I have created a prototype ELPA package, comments welcome? > > Are we providing packages that include only Info manuals, which > document stuff that is not specific to Emacs? Because I don't see how > it would be a good idea to have this as an ELPA package. I hear that maybe it's not a good idea, as this is not Emacs specific. >From a complementary point of view, reading this list it appears that there is a smaller number of C contributors to Emacs, compared to Lisp, and more C contributors are needed to work on Emacs. Can we facilitate C documentation? For example. The info-look.el subsystem already adds lookup facility for manuals such as (libc). Wouldn't it be useful to also have c.info similarly available and to aid in Emacs C development? That is part of the motivation. > > But if we do accept such packages on ELPA, then I have 2 additional > similar suggestions: > > . Git manual in Info format > . Python 3 manual in Info format Yes, I recently wrote about the second point for Python, so I would agree. (https://onlisp.co.uk/Creating-an-info-manual-for-Python.html) I may be able to volunteer towards a prototype, depending on time. > >> Current Package name, proposed for ELPA: c-intro-and-ref >> This matches the existing manual distribution. >> Perhaps a name such as: gnu-c-manual > > That'd be wrong, since this manual doesn't describe GNU C, it > describes the C language in general. (There's a separate GNU C > manual, btw.) Thanks for the perspective, I do find the several names overlapping, possibly for historical reasons. The c.texi file starts with a mention of GNU C @direntry * C: (c). GNU C Language Intro and Reference Manual @end direntry