Closed josephmturner closed 1 year ago
I attempted to solve this issue by renaming org-transclusion-manual.org
to org-transclusion.org
, but it didn't work. More details in this commit message.
Thanks. I'd like to take a deeper look, but:
make
For these two reasons, I am wondering if this issue should not be addressed via package-vc
rather than via individual packages.
In general, I have no problem adapting a way that would work for both package-vc
and ELPA. At this stage, I would like to wait for Emacs 29 to be officially released.
In addition... I have no idea what change is required to support the current state of package-vc
. Do you have suggestions? I don't understand why the build process cannot find fdl.texi
. It's in the same directory as org-transclusion-manual.org
and #+texinfo: @include fdl.texi
should be syntactically correct...
With emacs -Q
, (package-vc-install "https://github.com/nobiot/org-transclusion")
does not fail. However, the manual does not build. I have sent an email to the help-gnu-emacs mailing list, and I'll report back here with what I learn!
Thank you for asking in he mailing list. Quite excited about what we might discover.
Just as additional information... This is something I set it once and have forgotten since. But ELPA is configured this way as below. This means:
make org-transclusion.org
is used, which should generate org-transclusion.org
from docs/org-transclusion-manual.org
org-transclusion.org
is stored in default-directory
of the file, which should be docs
directory. Thusdocs/org-transclusion.org
gets generateddocs/org-transclusion.org
as the source to generate the Info dochttps://git.savannah.gnu.org/cgit/emacs/elpa.git/tree/elpa-packages#n491
(org-transclusion :url "https://github.com/nobiot/org-transclusion"
:make "org-transclusion.org"
:doc "docs/org-transclusion.org"
:readme "README.org")
Thank you, @nobiot! The issue is that package-vc
doesn't currently support the :make
package specification key.
I have submitted a patch to add support for :make
and :shell-command
spec args in package-vc
.
And also a separate patch for the issue where the build process could not find fdl.texi
.
Great. Anything I should do on my end?
Nope! The second patch is slated for Emacs 29, but the first is not, so it'll be a while before most users will be able to install the org-transclusion
manual with package-vc
.
package-vc
can still install org-transclusion
just fine though!
EDIT: typo
Okay, thank you!
To reproduce: On Emacs 29+, run
This successfully installs
org-transclusion
, but it does not install the manual.I think that
package-vc--build-documentation
expects the docs to be atdocs/org-transclusion.org
but instead they are located atdocs/org-transclusion-manual.org
.Perhaps there is a way to tell
package-vc
where the docs are actually located?