Re: [ELPA] New package c-intro-and-ref -- was Re: Proposal: Include C Manual from RMS in Emacs git, and/or release

[Jeremy Bryant]

Suhail Singh <suhailsingh247@gmail.com> writes:

> Jeremy Bryant <jb@jeremybryant.net> writes:
>
>>>> Main file: c-intro-and-ref.el
>>>> This is simply a placeholder for the c.texi and other files
>>>
>>> Thank you for packaging this in a repository to make it easily
>>> accessible via package-vc-install.
>>>
>>> It would help if the name of the texinfo file was the same as that of
>>> the package.  Currently, when using package-vc-install, the name of the
>>> checkout directory has to be specified as 'c (i.e., matching the name of
>>> the texinfo file, as opposed to the repository), since that name is used
>>> by package-vc when generating the info output from the texinfo source.
>>
>> The manual example ((emacs) Fetching Package Sources)
>> seems to allow a :doc keyword?
>
> This isn't about the :doc keyword.  It's a matter of consistency (or
> inconsistency).  I shall leave it up to you and others to decide whether
> the desire for consistency is foolish in this instance.
>
> As things currently stand, one needs to do something like the below:

Suhail, thanks for highlighting an inconsistency and providing example
code.  I'm currently closely following the actual upstream distribution,
with as little change as possible to the names c-intro-and-ref and
c.info, which are there.

In the meantime, I appreciate the detail and have updated the README as
follows so that users can start easily install this Manual when writing C code
in Emacs.

Installation instructions

(package-vc-install
 '(c-intro-and-ref :url "https://github.com/jeremy-bryant/c-intro-and-ref";
                   :branch "master"
                   :rev :newest
                   :doc "./c.texi"))

or

(use-package c-intro-and-ref :ensure nil
    :vc (c-intro-and-ref :url "https://github.com/jeremy-bryant/c-intro-and-ref";
           :branch "master"
           :rev :newest
           :doc "./c.texi"))