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: [ELPA] New package c-intro-and-ref -- was Re: Proposal: Include C Manual from RMS in Emacs git, and/or release Date: Tue, 03 Dec 2024 23:03:42 +0000 Message-ID: <87bjxsbc8h.fsf@jeremybryant.net> References: <87ser8c230.fsf@jeremybryant.net> <86ser87rut.fsf@gnu.org> <86cyia4503.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30320"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, emacs-devel@gnu.org, Philip Kaludercic To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 04 00:04:52 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 1tIbwp-0007jS-F7 for ged-emacs-devel@m.gmane-mx.org; Wed, 04 Dec 2024 00:04:52 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tIbvv-0008B2-IV; Tue, 03 Dec 2024 18:03:55 -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 1tIbvt-0008Ah-S3 for emacs-devel@gnu.org; Tue, 03 Dec 2024 18:03:53 -0500 Original-Received: from out-170.mta0.migadu.com ([91.218.175.170]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tIbvr-0006Sf-Ca; Tue, 03 Dec 2024 18:03:53 -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=1733267024; 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=rVk+/AlGc6M2LTsDldzH0hl652VaHtE4U0deCeswmiM=; b=GzIZpJHRhKer4YynLVqdY4vfUS0WsY7vQct/qk4UoWTdJr9uiCdQBAZlc0Q0Ov2LdLBNtq VMl+tU6GDY5ANmkB2/tZHDjwHr4+NS7iWZXV9twd+T8pUncidNkZ5ipAvMav9iJlphwnlM rfP52+Y9EyZwPDoojaGJuHZaojUmF52ujnxrjzXCyoSJcyYHQf0oTMDO243PVm/aTpyOHd jhZhORIXho0WlBfDf88eJt/1x02DEM3dCIS0Zom7jhT4jwejSK/Yv+qCyMo6L/CtOfdyFd BcXy5tXuV06JXX6ejf5eaWycakoEgfhrCOsQkDCHKF4xU+92W7WZNRkBFGm7RA== In-Reply-To: <86cyia4503.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 02 Dec 2024 14:57:16 +0200") X-Migadu-Flow: FLOW_OUT Received-SPF: pass client-ip=91.218.175.170; envelope-from=jb@jeremybryant.net; helo=out-170.mta0.migadu.com X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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:326009 Archived-At: --=-=-= Content-Type: text/plain Eli Zaretskii writes: >> From: Richard Stallman >> Cc: jb@jeremybryant.net, emacs-devel@gnu.org >> Date: Sun, 01 Dec 2024 23:10:09 -0500 >> >> > FWIW, I don't think this (IMO very useful and installed on my >> > machines) manual belongs to Emacs. It should be a separate manual. >> >> As a general design principle, it doesn't seem to make sense to >> include all GNU manuals in the Emacs distribution merely because they >> are useful manuals. The idea was to relese them separately and have >> them installed separately into a combined info tree. >> >> Why is that not working? What needs to be changed in some GNU/Linux >> distros? > > It does work in general. However, some manuals, which don't belong to > any project in particular, are largely unknown to exist. The two > prominent examples I have are for some reason both related to the C > language: gnu-c-manual.info and c.info. The latter is not even > mentioned in dir-example file that the Texinfo project distributes. Understood. I have created a prototype ELPA package, comments welcome? upstream url: https://github.com/jeremy-bryant/c-intro-and-ref As some manuals are available in GNU/Linux distros but not this one, it would provide a distribution mechanism for c.info I also include a PDF output. Current Package name, proposed for ELPA: c-intro-and-ref This matches the existing manual distribution. Perhaps a name such as: gnu-c-manual would be easier to find, however on gnu.org this points to another, maybe a predecessor manual. (https://www.gnu.org/software/gnu-c-manual/gnu-c-manual.html) Main file: c-intro-and-ref.el This is simply a placeholder for the c.texi and other files --=-=-= Content-Type: application/emacs-lisp Content-Disposition: attachment; filename=c-intro-and-ref.el Content-Transfer-Encoding: quoted-printable ;;; c-intro-and-ref.el --- GNU C Language Introduction and Reference Manual= -*- lexical-binding: t; -*- ;; Copyright (C) 2024 Jeremy Bryant ;; Author: Jeremy Bryant ;; Maintainer: Jeremy Bryant ;; Version: 20241201 ;; Website: https://www.gnu.org/software/c-intro-and-ref/ ;; Savannah: https://savannah.gnu.org/projects/c-intro-and-ref/ ;; Keywords: docs ;; This program is free software; you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation, either version 3 of the License, or ;; (at your option) any later version. ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License ;; along with this program. If not, see . ;;; Commentary: ;; This package is a distribution of ;; `The GNU C Language Introduction and Reference manual', ;; written by Richard Stallman, et al. ;; The original manual c.texi, included is in the TeXinfo format. ;; This package installs the info manual for reference within Emacs. ;; Upon installation, it is available under C-h i. ;; This package also contains PDF version. ;; An excerpt from the beginning of the manual is below ;; GNU C Manual ;; ************ ;; This manual explains the C language for use with the GNU Compiler ;; Collection (GCC) on the GNU/Linux operating system and other systems. ;; We refer to this dialect as GNU C. If you already know C, you can use ;; this as a reference manual. ;; If you understand basic concepts of programming but know nothing ;; about C, you can read this manual sequentially from the beginning to ;; learn the C language. ;; License of the Manual ;; GNU C Language Introduction and Reference Manual is free documentation; = you can redistribute it and/or modify it under the terms of the GNU Free Do= cumentation License as published by the Free Software Foundation; either ve= rsion 1.3 of the License, or (at your option) any later version published b= y the Free Software Foundation; with with the Invariant Sections being =E2= =80=9CGNU General Public License,=E2=80=9D with the Front-Cover Texts being= =E2=80=9CA GNU Manual,=E2=80=9D and with the Back-Cover Texts as in (a) be= low. A copy of the license is included in the section entitled =E2=80=9CGN= U Free Documentation License.=E2=80=9D ;; (a) The FSF's Back-Cover Text is: =E2=80=9CYou have the freedom to copy = and ;; modify this GNU manual.=E2=80=9D ;; Please report errors and suggestions to c-manual@@gnu.org. ;;; Code: ;;; c-intro-and-ref.el ends here --=-=-=--