declt icon indicating copy to clipboard operation
declt copied to clipboard

ASDF doc-op?

Open snunez1 opened this issue 2 years ago • 3 comments

Is there a way to call declt:declt and makeinfo from ASDF via some kind of doc-op? It would be nice to be able to automate the documentation of multiple systems that are distributed together.

If not via ASDF, are there any other recommended ways to ease the task of documenting multiple system?

snunez1 avatar Jun 05 '22 03:06 snunez1

I just found the makefiles in this repo. I was thinking of doing the same thing, but somehow it feels like this should be part of ASDF.

snunez1 avatar Jun 05 '22 08:06 snunez1

A doc-op is an interesting idea, but I don't feel qualified enough on ASDF to provide a pertinent opinion. Maybe this is an idea to raise on asdf-devel ? Otherwise, yes, you found the Makefiles so it's good.

On top of that, I'm also planning on adding a script to the distribution so as to provide a declt pseudo-executable that you could call directly from the command-line.

didierverna avatar Jun 07 '22 09:06 didierverna

I'll raise this on ASDF dev. It's been discussed before, but wasn't implemented. I don't think it should be too difficult. See: https://github.com/bytecurry/bytecurry.asdf-ext. It looks like a dozen or so lines of code.

snunez1 avatar Jun 08 '22 00:06 snunez1