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

[Suhail Singh]

Jeremy Bryant <jb@jeremybryant.net> writes:

> 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.

You're welcome.

> 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"))

The above two should be equivalent, though I have not tested it.  The
latter form, which I did test, is precisely the one that does _not_
work.  Apologies in case this wasn't clear from my last message (or if I
had a typo in my explanation).

When the name specified to package-vc-install is c-intro-and-ref , the
generated info file is named c-intro-and-ref.info.  The relevant code
(in Emacs 29.4) which sets the name of the generated info file is in the
function package-vc--build-documentation :

#+begin_src emacs-lisp
  (output (expand-file-name (format "%s.info" pkg-name)))
#+end_src

This is problematic with the shipped "dir" file in the repository which
references c.info.  In order to generate c.info , one has to use the
name "c" (even though the repository as well as the phantom elisp
package are named c-intro-and-ref).

Please let me know in case this is not what you observe on your machine.

-- 
Suhail