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