e.arrows at gmail.com
Thu Feb 21 05:20:15 UTC 2019
Probably, I'm the first one who started the custom.
However, I suppose it's technically not widely used because of Quickdocs,
since it also searchs README file at the project root.
Perhaps, it may be because CL-Project, my project generator, has been
adding the code to the new ASD file.
I just thought it might be useful if it could be refer by calling
'asdf:system-long-description' from REPL,
or someone would make some utility tool using long-description in the
To be honest, I'm not a big fan of it anymore and I don't follow it in my
I'm willing to delete the code from CL-Project, though I have nothing I can
do for existing projects.
On Thu, Feb 21, 2019 at 1:15 PM Faré <fahree at gmail.com> wrote:
> I've seen the pattern of using
> (uiop:subpathname *load-pathname* "README.md"))
> spread among CL libraries.
> I see it only as a waste of kilobytes of data (quadrupled on 32-bit
> unicode lisps such as SBCL).
> I'm told it's because Quickdocs likes it this way.
> Since there is not (yet?) any type enforcement on the value of that
> field, can we instead agree for an alternate format, wherein the field
> would instead contain the pathname of the long-description file,
> relative to the (asdf:system-source-directory) ? Thus you'd use:
> :long-description #p"README.md"
> And Quickdocs and other documentation tools would do the right thing from
> Maybe I'm just an old-school code bummer but I'm always saddened by a
> waste of bytes.
> —♯ƒ • François-René ÐVB Rideau •Reflection&Cybernethics•
> I have never killed any one, but I have read some obituary notices with
> satisfaction. — Clarence Darrow
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the asdf-devel