From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lynn Winebarger Newsgroups: gmane.emacs.devel Subject: Re: How to install documentation in sub-directory with Package VC? Date: Sun, 9 Apr 2023 16:44:48 -0400 Message-ID: References: <87bkkvconh.fsf@posteo.net> <87o7oujqqp.fsf@posteo.net> <98f76116-4f5a-c225-3123-78c612ec64cb@protonmail.com> <875yb1gk55.fsf@posteo.net> <87cz4te31m.fsf@posteo.net> <877cun5psj.fsf@bernoul.li> <87mt3i93ex.fsf@posteo.net> <87lej0lx1j.fsf@bernoul.li> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="0000000000000b05fd05f8ed55fd" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1314"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Philip Kaludercic , Okamsn , emacs-devel To: Jonas Bernoulli Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Apr 09 22:45:44 2023 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 1plbuy-0000AV-8e for ged-emacs-devel@m.gmane-mx.org; Sun, 09 Apr 2023 22:45:44 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1plbuN-0007i9-By; Sun, 09 Apr 2023 16:45:07 -0400 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 1plbuL-0007hj-Ai for emacs-devel@gnu.org; Sun, 09 Apr 2023 16:45:05 -0400 Original-Received: from mail-pl1-x634.google.com ([2607:f8b0:4864:20::634]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1plbuJ-0005WP-5X for emacs-devel@gnu.org; Sun, 09 Apr 2023 16:45:05 -0400 Original-Received: by mail-pl1-x634.google.com with SMTP id kh6so1555112plb.0 for ; Sun, 09 Apr 2023 13:45:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1681073101; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=NLs+CPi94zhzjLQYnEw5+/Pq+sM/9WLvpa0quHlrx7Q=; b=XPfB8HKbenX7QX9HpMu/dle/V3kRg/USEe/ImKA9wo/DZQjfOC7WbN56KmYCGTVWMM 6Pz5SDkZ0M+wXcc+D6rtWWW/UiqAE9JT1cz9ytoFNRF+gKHwHcU2ME0MBD2KXAnzoQ0F OSb/PSg++Fzi1P07M7rms8L6dHuAnazjMnmZxt4W+j04Pw6lHtsSf3vkBjAT0931BEL3 wVVHMHl0o9fY2HgWo9DsJqzUE7ytUUqk2GcwRfKfUu6IxRnQWBqkoU7Je3aAmwiQN+DS tgRE/4L7QftGjJruV2dDPeJ06akwpl9Xiv9rIOQcZvBOrM25o9IbB1jZJdmyYTh3CazE 39bQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1681073101; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=NLs+CPi94zhzjLQYnEw5+/Pq+sM/9WLvpa0quHlrx7Q=; b=0suGo+PL1bzCvMmPJ91dU532xaetV/IG4jo2BM6RUPromy+QU0YepNggQnyC4yVvWz 9t8+hmsph4ZDROdvMtkzygXwnftIkQAXYkT5fYvhZ2DgiUJlf4qR4kh+hAuPNQt9pvHf 7vGZHeq45P6+dHHcdJKkM8vJwYpFh27MFq8raUx+DMraqUeVoqhCislqUAjlBDBpa2n6 ussYqmOTr8Y/S6Bj7SBgh7fxSV1DPqQBw2kO9FgKyMhthKTN63zY35xSmO0myVT8AomT mFJrD/h4qwutJ/5qdt+OUgMYqfO3GyHWMHYtJT79auoaXTXxx/Gk1vbaOMKL0d120VsR KG+Q== X-Gm-Message-State: AAQBX9cJFks39YvhYRSJp9Ni+xalOumirWcxyWL4b8EFOD12qVfYLIR7 iaxKv2YFY8FTi+UDJBAJZ7T/fhS1G8hkpafB8ac= X-Google-Smtp-Source: AKy350ZE6dHRxEd2ajYDUFi2THlnmAjRHMHZ9hlJXBs+x72VL6dheX1eZg1GZEeFlWTrTnDXHzZEThK89Iye4tvpAaA= X-Received: by 2002:a17:902:da91:b0:1a6:425a:4d21 with SMTP id j17-20020a170902da9100b001a6425a4d21mr144827plx.9.1681073101275; Sun, 09 Apr 2023 13:45:01 -0700 (PDT) In-Reply-To: <87lej0lx1j.fsf@bernoul.li> Received-SPF: pass client-ip=2607:f8b0:4864:20::634; envelope-from=owinebar@gmail.com; helo=mail-pl1-x634.google.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, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=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:305212 Archived-At: --0000000000000b05fd05f8ed55fd Content-Type: text/plain; charset="UTF-8" On Sun, Apr 9, 2023, 3:11 PM Jonas Bernoulli wrote: > Philip Kaludercic writes: > Why is :doc needed? I think package-install simply runs makeinfo on all > texi files, but of course it can rely on them being at the top-level. > It might end up trying (and failing) to directly process gpl.texi and > similar. But still, cannot package-vc simply do that too? > > The value of :doc can also be an org file and we cannot just blindly try > to transcode *all* org files to texi. Is there anything like the info top-level directory node for org files? My draft of unboxed (package management) has a provision for handling info files found in an unpacked package, and dealing with texi files when there is no info file is straightforward. I have no idea what to do with a random org file used for documenting a package to make it systematically accessible to the package's user. Lynn --0000000000000b05fd05f8ed55fd Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Sun, Apr 9, 2023, 3:11 PM Jonas Bernoulli <jonas@bernoul.li> wrote:
Philip Kaludercic <philipk@posteo.net> writes= :
Why is :doc needed?=C2=A0 I think package-install simply runs makeinfo= on all
texi files, but of course it can rely on them being at the top-level.
It might end up trying (and failing) to directly process gpl.texi and
similar.=C2=A0 But still, cannot package-vc simply do that too?

The value of :doc can also be an org file and we cannot just blindly try to transcode *all* org files to texi.=C2=A0

Is there anything like the info top-= level directory node for org files?

My draft of unboxed (package management) has a provision for ha= ndling info files found in an unpacked package, and dealing with texi files= when there is no info file is straightforward.=C2=A0 I have no idea what t= o do with a random org file used for documenting a package to make it syste= matically accessible to the package's user.

=
Lynn




--0000000000000b05fd05f8ed55fd--