<div dir="ltr"><div dir="ltr"><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">Hi Faré,</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">Probably, I'm the first one who started the custom.</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">However, I suppose it's technically not widely used because of Quickdocs,</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">since it also searchs README file at the project root.</div><br><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">Perhaps, it may be because CL-Project, my project generator, has been adding the code to the new ASD file.<br><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><a href="https://github.com/fukamachi/cl-project/blob/master/cl-project.asd#L33-L35">https://github.com/fukamachi/cl-project/blob/master/cl-project.asd#L33-L35</a></div></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">I just thought it might be useful if it could be refer by calling 'asdf:system-long-description' from REPL,</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">or someone would make some utility tool using long-description in the future.</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">To be honest, I'm not a big fan of it anymore and I don't follow it in my recent products.<br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">I'm willing to delete the code from CL-Project, though I have nothing I can do for existing projects.<br></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Feb 21, 2019 at 1:15 PM Faré <<a href="mailto:fahree@gmail.com">fahree@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">I've seen the pattern of using<br>
  :long-description<br>
  #.(uiop:read-file-string<br>
     (uiop:subpathname *load-pathname* "README.md"))<br>
spread among CL libraries.<br>
<br>
I see it only as a waste of kilobytes of data (quadrupled on 32-bit<br>
unicode lisps such as SBCL).<br>
<br>
I'm told it's because Quickdocs likes it this way.<br>
<br>
Since there is not (yet?) any type enforcement on the value of that<br>
field, can we instead agree for an alternate format, wherein the field<br>
would instead contain the pathname of the long-description file,<br>
relative to the (asdf:system-source-directory) ? Thus you'd use:<br>
 :long-description #p"README.md"<br>
And Quickdocs and other documentation tools would do the right thing from there.<br>
<br>
Maybe I'm just an old-school code bummer but I'm always saddened by a<br>
waste of bytes.<br>
<br>
—♯ƒ • François-René ÐVB Rideau •Reflection&Cybernethics• <a href="http://fare.tunes.org" rel="noreferrer" target="_blank">http://fare.tunes.org</a><br>
I have never killed any one, but I have read some obituary notices with great<br>
satisfaction. — Clarence Darrow<br>
</blockquote></div>