search

didierverna / declt

Reference manual generator for Common Lisp libraries
Other
38 stars 6 forks source link

ASDF doc-op? #15

Open snunez1 opened 2 years ago

snunez1 commented 2 years ago

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 commented 2 years ago

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.

didierverna commented 2 years ago

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.

snunez1 commented 2 years ago

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.