<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/xhtml; charset=utf-8">
</head>
<body>
<div style="font-family:sans-serif"><div style="white-space:normal">
<p dir="auto">The more we discuss this, the more I think it's a solution in search of a problem. Just using the standard ASDF file-inclusion capabilities (that Faré shows in his email) seems sufficient to me, and also keeps a nice uniformity -- if you want the long description, you ask for it, and you know it's a string. It also imposes a cost in complexity with only a conjectural benefit (who would consume the new pathname designations, <strong>and</strong> which library authors and maintainers would supply it?). If users are offended by the excess number of bytes, the macro facility is available.</p>
<p dir="auto">I prefer not to give the yak any more facial hair! 😉</p>
<p dir="auto">On 25 Feb 2019, at 10:43, Raymond Toy wrote:</p>
</div>
<div style="white-space:normal"></div>
<blockquote style="border-left:2px solid #777; color:#777; margin:0 0 5px; padding-left:5px"><div id="CFE53F4B-C8D4-4EA6-A7A9-D40A67864154"><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></div></blockquote>
<div style="white-space:normal">
<blockquote style="border-left:2px solid #777; color:#777; margin:0 0 5px; padding-left:5px">
</blockquote></div>
<div style="white-space:normal">
</div>
</div>
</body>
</html>