Poke :downloads a bit. Add -sort flag, downloadsort option, :dlclear command. Closes issue #386.

--HG--
extra : rebase_source : 1ce7621d39e91f2779d1827975b44f00c7a1d00b

common/locale/en-US/gui.xml

@@ -68,6 +68,21 @@
             Show progress of current downloads. Here, downloads can
             be paused, resumed, and canceled.
         </p>
+
+        <p>Available options include:</p>
+
+        <dl>
+            <dt>-sort</dt> <dd>Sort order (see <o>downloadsort</o>) (short name: <em>-s</em>)</dd>
+        </dl>
+    </description>
+</item>
+
+<item>
+    <tags>:dlc :dlclear</tags>
+    <strut/>
+    <spec>:dlc<oa>lear</oa></spec>
+    <description>
+        <p>Clear completed downloads.</p>
     </description>
 </item>
 

common/locale/en-US/messages.properties

@@ -257,6 +257,9 @@ quickmark.added-2 = Added Quick Mark '%S': %S
 
 save.invalidDestination-1 = Invalid destination: %S
 
+sort.ascending  = ascending
+sort.descending = descending
+
 status.link-1 = Link: %S
 
 style.none = No style found

common/locale/en-US/options.xml

@@ -519,6 +519,32 @@
     </description>
 </item>
 
+<item>
+    <tags>'dls' 'dlsort' 'downloadsort'</tags>
+    <spec>'downloadsort'</spec>
+    <type>stringlist</type>
+    <default>-active,+filename</default>
+    <description>
+        <p>
+            <ex>:downloads</ex> sort order, in order of precedence.
+            Each element must be preceded by a <tt>+</tt> or
+            <tt>-</tt>, indicating ascending or descending sorting,
+            respectively. Valid sort orders are:
+        </p>
+
+        <dl>
+            <dt>active</dt>   <dd>Whether download is active</dd>
+            <dt>complete</dt> <dd>Percent complete</dd>
+            <dt>filename</dt> <dd>Target filename</dd>
+            <dt>size</dt>     <dd>File size</dd>
+            <dt>speed</dt>    <dd>Download speed</dd>
+            <dt>time</dt>     <dd>Time remaining</dd>
+            <dt>url</dt>      <dd>Source URL</dd>
+        </dl>
+    </description>
+</item>
+
+
 <item>
     <tags>'ds' 'defsearch'</tags>
     <spec>'defsearch' 'ds'</spec>