<div dir="ltr"><div dir="ltr"><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small"><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Feb 21, 2019 at 8:23 AM Robert Goldman <<a href="mailto:rpgoldman@sift.info">rpgoldman@sift.info</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"><u></u>




<div>
<div style="font-family:sans-serif"><div style="white-space:normal">
<p dir="auto">On 20 Feb 2019, at 22:14, Faré wrote:</p>

</div>
<div style="white-space:normal"><blockquote style="border-left:2px solid rgb(119,119,119);color:rgb(119,119,119);margin:0px 0px 5px;padding-left:5px"><p dir="auto">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.</p>
</blockquote></div>
<div style="white-space:normal">

<p dir="auto">Let me see if I understand clearly:</p>

<ol>
<li value="1"><p dir="auto">As before, if you put a string in here, you get the string itself as the value of <code style="background-color:rgb(247,247,247);border-radius:3px;margin:0px;padding:0px 0.4em" bgcolor="#F7F7F7">:long-description</code>.</p></li>
<li value="2"><p dir="auto">If there is a pathname literal in here you get the contents of that file as the value of <code style="background-color:rgb(247,247,247);border-radius:3px;margin:0px;padding:0px 0.4em" bgcolor="#F7F7F7">:long-description</code>.</p></li>
</ol>

<p dir="auto">Is this correct?</p><br></div></div></div></blockquote><div><span class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small">I find option 2 kind of strange.  What if I really just wanted the pathname as the description?  Having it produce the contents of the file seems really odd.  I think it's up to the developer/user to decide whether to display the file or not.</span></div><div><span class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small"><br></span></div><div><span class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small">My 2 cents, as someone who doesn't really use asdf all that much (because the projects are pretty much done and working.)</span> </div></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div></div>Ray<br></div></div></div>