chiark / gitweb /
copyright dates
[disorder] / CHANGES.html
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2 <html>
3 <head>
4 <title>DisOrder Change History</title>
5 <style type="text/css">
6 body {
7   color: black;
8   background-color: white;
9   font-family: times,serif;
10   font-weight: normal;
11   font-size: 12pt;
12   font-variant: normal
13 }
14
15 div.section {
16   margin-left:1em
17 }
18
19 h1 {
20   background-color: #e0ffe0;
21   font-family: helvetica,sans-serif;
22   padding: 0.2em
23 }
24
25 h2 {
26   background-color: #e0ffe0;
27   font-family: helvetica,sans-serif;
28   padding: 0.2em
29 }
30
31 h3 {
32   background-color: #f0f0f0;
33   font-family: helvetica,sans-serif;
34   padding: 0.2em
35 }
36
37 h4 {
38   font-family: helvetica,sans-serif
39 }
40
41 table.bugs {
42   width: 100%;
43   font-size: 12pt;
44   border-collapse: collapse;
45   border:1px
46 }
47
48 table.bugs th {
49   text-align: left;
50   border: 1px solid black;
51   background-color: black;
52   color: white
53 }
54
55 table.bugs td {
56   border: 1px solid
57 }
58
59 span.command {
60   font-family: monospace
61 }
62 </style>
63 </head>
64
65 <body>
66 <h1>DisOrder Change History</h1>
67
68 <p>This file documents recent user-visible changes to <a
69  href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
70
71 <h2>Changes up to version 5.0</h2>
72
73   <div class=section>
74   
75     <h3>Server</h3>
76  
77     <div class=section>
78
79       <p>The <tt>device</tt> configuration option now works under OS X.
80       Devices may
81       be specified either by UID or name.  Fixes <a
82        href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
83       27</a>.</p>
84
85       <p>Gapless play should be more reliable, and playback latency over RTP
86       should be a bit lower.  Note though that all the sound output code has
87       been reorganized and in some cases completely rewritten, so it's possible
88       that bugs may have been (re-)introduced.  Decoding of scratches is also
89       initiated ahead of time, giving more reliable playback.</p>
90       
91       <p>The <tt>command</tt> backend now (optionally) sends silence instead
92       of suspending writes when a pause occurs or no track is playing.</p>
93
94       <p>If <a href="http://www.mega-nerd.com/SRC/">libsamplerate</a> is
95       available at build time then that will be used instead of invoking
96       <a href="http://sox.sourceforge.net/">SoX</a>.  SoX support will be
97       removed in a future version.</p>
98
99       <p>The libao plugin has been removed, because the plugin API is not
100       usable in libao 1.0.0.</p>
101
102       <p>Playlists are now supported.  These allow a collection of tracks to be
103       prepared offline and played as a unit.</p>
104
105     </div>
106       
107     <h3>Disobedience</h3>
108
109     <div class=section>
110
111       <p>Multiple tracks can now be dragged in the queue in a single operation.
112       Furthermore, it is now possible to drag tracks from the
113       &ldquo;Recent&rdquo;, &ldquo;Added&rdquo; and &ldquo;Choose&rdquo; tabs
114       to the queue.</p>
115
116       <p>Disobedience now supports playlist editing and has a compact mode,
117       available from the <b>Control</b> menu.</p>
118
119       <p>Disobedience has a <a href="disobedience/manual/index.html">new
120       manual</a>.</p>
121
122     </div>
123
124     <h3>Web Interface</h3>
125  
126     <div class=section>
127
128       <p>Confirmation URLs should be cleaner (and in particular not end
129       with punctuation).  (Please see <a
130       href="README.upgrades">README.upgrades</a> for more about this.)</p>
131
132     </div>
133       
134     <h3>RTP Player</h3>
135   
136     <div class=section>
137
138       <p>There is a new <tt>--command</tt> option which allows the RTP player
139       to send audio data to a user-chosen command instead of an audio API. See
140       the man page for details.</p>
141       
142       <p>The <tt>--device</tt> option to <tt>disorder-playrtp</tt> now works
143       under OS X (as above).</p>
144         
145     </div>
146       
147     <h3>General</h3>
148
149     <div class=section>
150
151       <p>IPv6 should now work.  Network address specifications
152       (<tt>listen</tt>, <tt>connect</tt> etc) can now be prefixed with
153       <tt>-4</tt> or <tt>-6</tt> to force use
154       of IPv4 or IPv6, though normally this should not be needed.</p>
155
156       <p>Unicode support has been upgraded to <a
157       href="http://www.unicode.org/versions/Unicode5.1.0/">Unicode
158       5.1.0</a>.</p>
159
160       <p>Various elements of the source code have been
161       rationalized.</p>
162       
163     </div>
164     
165     <h3>Bugs fixed</h3>
166   
167     <div class=section>
168
169       <table class=bugs>
170         <tr>
171           <th>ID</th>
172           <th>Description</th>
173         </tr>
174
175         <tr>
176           <td><a href="http://code.google.com/p/disorder/issues/detail?id=22">#22</a></td>
177           <td>Background decoders interact badly with server reload</td>
178         </tr>
179
180         <tr>
181           <td><a href="http://code.google.com/p/disorder/issues/detail?id=27">#27</a></td>
182           <td>Mac DisOrder uses wrong sound device</td>
183         </tr>
184
185         <tr>
186           <td><a href="http://code.google.com/p/disorder/issues/detail?id=30">#30</a></d>
187           <td>mini disobedience interface</td>
188         </tr>
189
190         <tr>
191           <td><a href="http://code.google.com/p/disorder/issues/detail?id=32">#32</a></d>
192           <td>Excessively verbose log chatter on shutdown</td>
193         </tr>
194
195         <tr>
196           <td><a href="http://code.google.com/p/disorder/issues/detail?id=33">#33</a></d>
197           <td>(Some) plugins need -lm.</td>
198         </tr>
199
200         <tr>
201           <td><a href="http://code.google.com/p/disorder/issues/detail?id=39">#39</a></d>
202           <td>Double bind() non-multicast AF_INET</td>
203         </tr>
204
205         <tr>
206           <td><a href="http://code.google.com/p/disorder/issues/detail?id=40">#40</a></d>
207           <td>Missing stub function</td>
208         </tr>
209
210         <tr>
211           <td><a href="http://code.google.com/p/disorder/issues/detail?id=41">#41</a></d>
212           <td>Missing includes for timeval</td>
213         </tr>
214
215         <tr>
216           <td><a href="http://code.google.com/p/disorder/issues/detail?id=42">#42</a></d>
217           <td>syntax error in empeg_host section</td>
218         </tr>
219
220         <tr>
221           <td><a href="http://code.google.com/p/disorder/issues/detail?id=43">#43</a></d>
222           <td>decoder segfault with FLAC 1.2.1</td>
223         </tr>
224
225         <tr>
226           <td><a href="http://code.google.com/p/disorder/issues/detail?id=44">#44</a></d>
227           <td>gcc 4.3.2-1ubuntu12 SUYB patch</td>
228         </tr>
229
230         <tr>
231           <td><a href="http://code.google.com/p/disorder/issues/detail?id=45">#45</a></d>
232           <td>disobedience doesn't configure its back end</td>
233         </tr>
234
235         <tr>
236           <td><a href="http://code.google.com/p/disorder/issues/detail?id=46">#46</a></d>
237           <td>Sort search results in web interface</td>
238         </tr>
239
240         <tr>
241           <td><a href="http://code.google.com/p/disorder/issues/detail?id=48">#48</a></d>
242           <td>build-time dependency on <tt>oggdec</tt> removed</td>
243         </tr>
244
245         <tr>
246           <td><a href="http://code.google.com/p/disorder/issues/detail?id=49">#49</a></d>
247           <td>Disobedience's 'When' column gets out of date</td>
248         </tr>
249
250         <tr>
251           <td><a href="http://code.google.com/p/disorder/issues/detail?id=51">#51</a></td>
252           <td>Improved speaker process robustness</td>
253         </tr>
254
255         <tr>
256           <td>(none)</td>
257           <td>&ldquo;found track in no collection&rdquo; messages for scratches
258           are now suppressed</td>
259         </tr>
260
261         <tr>
262           <td>(none)</td>
263           <td>Disobedience would sometimes fail to notice when a track
264           started, leading to its display getting out of date.</td>
265         </tr>
266
267       </table>
268     </div>
269   </div>
270
271 <h2>Changes up to version 4.3</h2>
272
273   <div class=section>
274
275     <h3>Disobedience</h3>
276
277       <div class=section>
278
279         <p>A bug was fixed in the calculation of how much of the track had
280         played.  This would lead to the counter showing incorrect values in
281         various situations.</p>
282
283         <p>Disobedience's icons have been changed to larger, more colorful
284         ones.  The SVG source is included if you want to fiddle with them.</p>
285
286         <p>&ldquo;Select all&rdquo; is now no longer available in the choose
287         tab.  Instead there is a new &ldquo;Select children&rdquo; option which
288         selects the file children of a single subdirectory.</p>
289
290       </div>
291
292     <h3>Server</h3>
293
294       <div class=section>
295
296         <p>The selection bias for newly added tracks was reduced by half.  You
297         can put it back to the old very neophilic value with
298         &ldquo;<tt>new_bias 900000</tt>&rdquo; in the config file.</p>
299
300         <p>It is now possible to &lsquo;adopt&rsquo; randomly picked tracks.
301         Disobedience and the command-line client support this but the web
302         interface does not.</p>
303
304         <p>The default track name parsing was modified to handle filenames
305         generated by iTunes.</p>
306         
307       </div>
308
309     <h3>Miscellaneous</h3>
310
311       <div class=section>
312
313         <p><tt>disorderfm</tt> now preserves directory permissions.</p>
314
315         <p>DisOrder is now licensed under <a
316          href="http://www.gnu.org/licenses/gpl-3.0.html">GPL v3</a>.  The main
317         goal is to prohibit <a
318          href="http://en.wikipedia.org/wiki/Tivoization">Tivoization</a>.</p>
319
320         <p>The build system will now automatically cope with Fink's broken GTK+
321         packages.  There are a number of improvements to the Debian
322         packaging.</p>
323
324         <p>DisOrder now builds on 64-bit Linux systems.</p>
325
326         <p>There are various minor fixes.</p>
327
328       </div>
329
330   <h3>Bugs fixed</h3>
331   
332     <div class=section>
333
334       <table class=bugs>
335         <tr>
336           <th>ID</th>
337           <th>Description</th>
338         </tr>
339         
340         <tr>
341           <td><a href="http://code.google.com/p/disorder/issues/detail?id=24">#24</a></td>
342           <td>Fails to build on ubuntu 8.10</td>
343         </tr>
344         <tr>
345           <td><a href="http://code.google.com/p/disorder/issues/detail?id=26">#26</a></td>
346           <td>Disobedience shows wrong track elapsed time after a pause</td>
347         </tr>
348       </table>
349       
350     </div>
351   </div>
352
353 <h2>Changes up to version 4.2</h2>
354
355 <div class=section>
356
357   <h3>Disobedience</h3>
358   
359     <div class=section>
360
361       <p>The login window now has a 'remote' switch.  If this is turned off
362       then Disobedience will connect to a local server.  Formerly it would
363       always use TCP/IP.</p>
364
365       <p>The Delete and backspace keys will now remove tracks from the queue.
366       Escape will now dismiss the properties, users or login windows and return
367       now works in the login and properties windows.</p>
368       
369     </div>
370
371   <h3>Documentation</h3>
372   
373     <div class=section>
374
375       <p>Track and global preferences are now described in a new
376       <b>disorder_preferences</b>(5) man page.</p>
377       
378     </div>
379
380   <h3>Bugs fixed</h3>
381   
382     <div class=section>
383
384       <table class=bugs>
385         <tr>
386           <th>ID</th>
387           <th>Description</th>
388         </tr>
389         
390         <tr>
391           <td><a href="http://code.google.com/p/disorder/issues/detail?id=21">#21</a></td>
392           <td>CGI should use PATH_INFO more sensibly</td>
393         </tr>
394       </table>
395       
396     </div>
397 </div>
398
399
400 <h2>Changes up to version 4.1.1</h2>
401
402 <div class=section>
403
404   <p>Disobedience's &ldquo;Login&rdquo; window now works when you are logged
405   in.</p>
406   
407 </div>
408
409 <h2>Changes up to version 4.1</h2>
410
411 <div class=section>
412
413   <h3>Disobedience</h3>
414   
415     <div class=section>
416   
417       <p>Disobedience has been largely rewritten:</p>
418
419       <ul>
420         
421         <li>All the tabs now use native GTK+ list/tree widgets, resulting in
422         greater speed in some cases and more consistency with other GTK+
423         applications.</li>
424
425         <li>You can now use type-ahead find in the choose tab.  The initiation
426         of a search is delayed slightly to avoid lots of updates when you're
427         half way through entering search terms.</li>
428
429         <li>The choose tab now shows track lengths.</li>
430     
431         <li>Many buttons are now more reliably made insensitive when they can't
432         be used.</li>
433
434         <li>You can now play tracks off the recent tab.</li>
435         
436       </ul>
437       
438       <p>Disobedience attempts to cope with servers from older versions, up to
439       a point, but this is not well tested and it's best to keep the server
440       fully up to date.</p>
441
442     </div>
443      
444   <h3>Server</h3>
445   
446     <div class=section>
447
448       <p>When a track shares a directory with its alias, the real track name is
449       now returned instead of the alias (the opposite way round to the previous
450       behaviour).</p>
451       
452     </div>
453 </div>
454
455 <h2>Changes up to version 4.0.2</h2>
456
457 <div class=section>
458
459   <p>Corrected web browser linked from Disobedience.</p>
460   
461 </div>
462
463 <h2>Changes up to version 4.0.1</h2>
464
465 <div class=section>
466
467   <p>Libtool and Automake now install the CGI correctly.  As part of this,
468   <tt>cgidir</tt> has been renamed to <tt>cgiexecdir</tt>.  The configure
469   script will report an error if you try to use the old name.</p>
470   
471 </div>
472
473 <h2>Changes up to version 4.0</h2>
474
475 <div class=section>
476
477   <h3>Server</h3>
478
479 <div class=section>
480   
481   <p>The <tt>gap</tt> directive will no longer work.  It could be
482   restored if there is real demand.</p>
483   
484   <h4>Event Scheduling</h4>
485
486 <div class=section>
487
488   <p>It is now possible to schedule events to occur in the future.
489   Currently the supported actions are playing a specific track, and
490   changing a global preference (thus allowing e.g. random play to be
491   turned on or off).  See the <tt>schedule-*</tt>
492   commands described in disorder(1).</p>
493
494 </div>
495
496 <h4>Random Track Choice</h4>
497
498 <div class=section>
499
500   <p>This has been completely rewritten to support new features:</p>
501
502   <ul>
503
504     <li>tracks in the recently-played list or in the queue are no longer
505     eligible for random choice.</li>
506
507     <li>there is a new <tt>weight</tt> track preference allowing for
508     non-uniform track selection.  See disorder(1) for details.</li>
509
510     <li>there is a new configuration item <tt>replay_min</tt> defining
511     the minimum time before a played track can be picked at random.
512     The default is 8 hours (which matches the earlier behaviour).</li>
513
514     <li>recently added tracks are biased up; see <tt>new_bias</tt> and
515     <tt>new_bias_age</tt> in disorder_config(5).</li>
516
517   </ul>
518
519 </div>
520
521 <h4>Web Interface</h4>
522
523 <div class=section>
524
525   <p>This has been largely rewritten.  The most immediate benefits are:</p>
526
527   <ul>
528     
529     <li>the search page is integrated into the choose page, and
530     includes links to parent directories.</li>
531     
532     <li>if you try to do something you have insufficient rights for,
533     instead of getting an error page or nothing happening, you are
534     redirected to the login page.</li>
535
536   </ul>
537
538   <p>Customizers should find their lives easier: the syntax is less onerous, it
539   is possible to define macros to avoid repetition, and the documentation is
540   less monolithic (see disorder.cgi(8) as a starting point).</p>
541
542   <p>Mail is now sent via the system sendmail program, though it remains
543   possible to use TCP to connect to an SMTP server.  See <tt>sendmail</tt> and
544   <tt>smtp_server</tt> in disorder_config(5).</p>
545
546   <p>The web interface is now installed automatically.  If you don't want it,
547   use <tt>./configure --without-cgi</tt>.  If you want it in a non-default
548   location, or no location for it is detected, set <tt>cgidir</tt>
549   and <tt>httpdir</tt> on the <tt>./configure</tt> command line.</p>
550   
551 </div>
552
553 </div>
554
555 <h3>Disobedience</h3>
556
557 <div class=section>
558
559   <p>There is now a new user management window.  From here you can add and
560   remove users or modify their settings.</p>
561
562   <p>Relatedly, the server will only allow remote user management if you set
563   <tt>remote_userman</tt> to <tt>yes</tt>.</p>
564
565 </div>
566
567 <h3>Miscellaneous</h3>
568
569 <div class=section>
570
571   <p><tt>scripts/setup</tt> now honors command line options, and can
572   set up network play as well as the local default sound device.</p>
573
574 </div>
575
576 <h3>Bugs Fixed</h3>
577
578 <div class=section>
579
580   <table class=bugs>
581     <tr>
582       <th>ID</th>
583       <th>Description</th>
584     </tr>
585
586     <tr>
587       <td><a href="http://code.google.com/p/disorder/issues/detail?id=2">#2</a></td>
588       <td>Search results should link to directories</td>
589     </tr>
590
591     <tr>
592       <td><a href="http://code.google.com/p/disorder/issues/detail?id=6">#6</a></td>
593       <td>Schedule tracks for a particular time</td>
594     </tr>
595
596     <tr>
597       <td><a href="http://code.google.com/p/disorder/issues/detail?id=10">#10</a></td>
598       <td>Non-uniform track selection</td>
599     </tr>
600
601     <tr>
602       <td><a href="http://code.google.com/p/disorder/issues/detail?id=11">#11</a></td>
603       <td>Bias random selection to newly added tracks</td>
604     </tr>
605
606     <tr>
607       <td><a href="http://code.google.com/p/disorder/issues/detail?id=13">#13</a></td>
608       <td>Default encoding for debian setup scripts</td>
609     </tr>
610
611     <tr>
612       <td><a href="http://code.google.com/p/disorder/issues/detail?id=16">#16</a></td>
613       <td>Cookie expiry causes user to be silently logged out and not
614       subsequently redirected to login page</td>
615     </tr>
616     
617     <tr>
618       <td><a href="http://code.google.com/p/disorder/issues/detail?id=20">#20</a></td>
619       <td>Broken aliasing rules</td>
620     </tr>
621     
622   </table>
623
624 </div>
625
626 </div>
627
628 <h2>Changes up to version 3.0.2</h2>
629
630 <div class=section>
631
632   <p>Builds <tt>--without-server</tt> should work again.</p>
633
634   <p>The web interface is a bit more liberal in the cookie value
635   syntax it will accept.</p>
636
637   <p>Clients fail more gracefully if no password is available.</p>
638
639 </div>
640
641 <h2>Changes up to version 3.0.1</h2>
642
643 <div class=section>
644   
645   <p>Debian upgrades from 2.0.x should now work better.</p>
646   
647 </div>
648
649 <h2>Changes up to version 3.0</h2>
650
651 <div class=section>
652   
653   <p><b>Important</b>!  See <a
654   href="README.upgrades">README.upgrades</a> when upgrading.</p>
655   
656   <h3>Platforms And Installation</h3>
657   
658 <div class=section>
659   
660   <p>Mac OS X and FreeBSD are somewhat supported.  There is now a bash
661   script in <tt>scripts/setup</tt> which will automate the setup after
662   <tt>make install</tt>.</p>
663   
664 </div>
665
666 <h3>Server</h3>
667
668 <div class=section>
669   
670   <p>Users are now stored in the database rather than a configuration
671   file.</p>
672   
673   <p>The server now has a built-in list of stopwords and players, so
674   only additions to these need be mentioned in the configuration file.</p>
675   
676   <p>The default inter-track gap is now 0s.</p>
677   
678   <p>How sound is played is now controlled via the new <tt>api</tt>
679   configuration command.  This also controls how the volume is set,
680   which now works with ALSA as well as OSS.</p>
681   
682   <p>A bug in the MP3 decoder was fixed (also in 2.0.4).</p>
683   
684 </div>
685
686 <h3>Web Interface</h3>
687
688 <div class=section>
689   
690   <p>The web interface now uses cookies to remember user identity, and
691   allows online registration of new users.  Also it is no longer
692   necessary to manually specify the URL of the web interface (but you
693   can override it if you don't like the value it figures out).</p>
694   
695   <p>It is possible to allow users to register via the web interface.</p>
696   
697   <p>The web interface's browser support has been improved.  It has
698   been tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer
699   7 and Opera 9.</p>
700   
701 </div>
702
703 <h3>Disobedience</h3>
704
705 <div class=section>
706
707   <p>A bug which would cause a crash if you attempt to rearrange the
708   queue while no track was playing has been fixed.  There is a new
709   'deselect all tracks' option, mirroring 'select all tracks.</p>
710   
711 </div>
712
713 </div>
714
715 <!--
716 Local Variables:
717 fill-column:79
718 indent-tabs-mode:nil
719 End:
720 -->