unofficial mirror of help-gnu-emacs@gnu.org
 help / color / mirror / Atom feed
From: Philip Kaludercic <philipk@posteo.net>
To: Joseph Turner <joseph@breatheoutbreathe.in>
Cc: help-gnu-emacs@gnu.org,  Ruijie Yu <ruijie@netyu.xyz>
Subject: Re: package-vc-install fails to build docs
Date: Sun, 23 Apr 2023 18:36:59 +0000	[thread overview]
Message-ID: <87pm7u1m44.fsf@posteo.net> (raw)
In-Reply-To: <87pm7uedfa.fsf@breatheoutbreathe.in> (Joseph Turner's message of "Sun, 23 Apr 2023 09:54:19 -0700")

Joseph Turner <joseph@breatheoutbreathe.in> writes:

> What would be the first steps to support :make in package-vc?

If you are interested in working on this, I would take a look at
`package-vc--unpack-1' which would probably be the best place for that.

> Philip Kaludercic <philipk@posteo.net> writes:
>
>> Joseph Turner <joseph@breatheoutbreathe.in> writes:
>>
>>> Thank you Ruijie Yu and Philip Kaludercic for your help!
>>>
>>> Philip Kaludercic <philipk@posteo.net> writes:
>>>
>>>> Ruijie Yu via Users list for the GNU Emacs text editor
>>>> <help-gnu-emacs@gnu.org> writes:
>>>>> I'm looking at the package-vc source code, and it doesn't seem to try to
>>>>> autodetect any doc files at the moment.  Try adding `:doc` in your
>>>>> `package-vc-install' call and see if anything changes.
>>>
>>> Actually, it looks like extra plist elements like :doc are stripped away
>>> in package-vc--unpack. package-vc--unpack doesn't pass its pkg-spec arg
>>> along to package-vc--unpack-1. package-vc--unpack-1 then calls
>>> package-vc--desc->spec, which gets the spec anew from ELPA IIUC.
>>>
>>> Regardless, I believe the issue lies elsewhere, see below.
>
> How shall we pass :doc and :make values from package-vc-install down to
> package-vc--build-documentation?
>
> Do we want to refactor package-vc-unpack-1 so that it accepts a pkg-spec
> argument? Or maybe add :doc an :make keys to the pkg-desc plist?

:doc is passed via an argument, and :make would have to be handled
before.

>> You are right (and I totally missed the :make entry in the specification
>> above).  Package-vc did intentionally NOT add :make or :shell-command
>> support, for the sake of user safety.  It wouldn't be difficult to
>> implement this, if we could find a way to make it reasonably safe
>> (e.g. if the user has to opt-in or we trust package specifications if
>> they were delivered by a trusted package archive).
>
> How about yes-or-no-p by default, with an customization option to
> automatically trust specs from a trusted package archive?

The latter should work fine, but the first would only be possible in
interactive usage.

-- 
Philip Kaludercic



  reply	other threads:[~2023-04-23 18:36 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-04-22  5:34 package-vc-install fails to build docs Joseph Turner
2023-04-22  6:07 ` Ruijie Yu via Users list for the GNU Emacs text editor
2023-04-22  7:27   ` Philip Kaludercic
2023-04-22 22:56     ` Joseph Turner
2023-04-23 12:37       ` Philip Kaludercic
2023-04-23 16:54         ` Joseph Turner
2023-04-23 18:36           ` Philip Kaludercic [this message]
2023-04-23 20:20             ` Joseph Turner
2023-04-24  5:54               ` Philip Kaludercic
2023-04-28 19:42                 ` Joseph Turner
2023-04-28 21:17                   ` Philip Kaludercic

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87pm7u1m44.fsf@posteo.net \
    --to=philipk@posteo.net \
    --cc=help-gnu-emacs@gnu.org \
    --cc=joseph@breatheoutbreathe.in \
    --cc=ruijie@netyu.xyz \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).