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