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