chiark / gitweb /
Merge various clang-inspired fixes
[disorder] / CHANGES.html
CommitLineData
b0a578cb
RK
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html>
3<head>
4<title>DisOrder Change History</title>
5<style type="text/css">
6body {
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
15div.section {
16 margin-left:1em
17}
18
19h1 {
20 background-color: #e0ffe0;
21 font-family: helvetica,sans-serif;
22 padding: 0.2em
23}
24
25h2 {
26 background-color: #e0ffe0;
27 font-family: helvetica,sans-serif;
28 padding: 0.2em
29}
30
31h3 {
32 background-color: #f0f0f0;
33 font-family: helvetica,sans-serif;
34 padding: 0.2em
35}
36
37h4 {
38 font-family: helvetica,sans-serif
39}
40
41table.bugs {
37e94d5c
RK
42 width: 100%;
43 font-size: 12pt;
44 border-collapse: collapse;
45 border:1px
b0a578cb
RK
46}
47
48table.bugs th {
37e94d5c
RK
49 text-align: left;
50 border: 1px solid black;
51 background-color: black;
52 color: white
53}
54
55table.bugs td {
56 border: 1px solid
b0a578cb
RK
57}
58
59span.command {
60 font-family: monospace
61}
62</style>
63</head>
64
65<body>
66<h1>DisOrder Change History</h1>
67
d8b95785
RK
68<p>This file documents recent user-visible changes to <a
69 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
70
5bb003c8
RK
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
8488cf7d
RK
80 mounted or unmounted. (Use the <tt>mount_rescan</tt> option if you want to
81 suppress this behavior.)</p>
5bb003c8
RK
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
64360021 91<h2>Changes up to version 5.0</h2>
f5fd9a6b
RK
92
93 <div class=section>
94
f207f710
RK
95 <h3>Server</h3>
96
f5fd9a6b
RK
97 <div class=section>
98
fe33cfc0 99 <p>The <tt>device</tt> configuration option now works under OS X.
7cd4dd21 100 Devices may
f207f710 101 be specified either by UID or name. Fixes <a
f5fd9a6b
RK
102 href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
103 27</a>.</p>
f207f710 104
f71fc3ab 105 <p>Gapless play should be more reliable, and playback latency over RTP
6762ac8a 106 should be a bit lower. Note though that all the sound output code has
f71fc3ab 107 been reorganized and in some cases completely rewritten, so it's possible
900fa0b8
RK
108 that bugs may have been (re-)introduced. Decoding of scratches is also
109 initiated ahead of time, giving more reliable playback.</p>
7cd4dd21
RK
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>
c3feb35b
RK
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
317dc3e8
RK
116 <a href="http://sox.sourceforge.net/">SoX</a>. SoX support will be
117 removed in a future version.</p>
c3feb35b 118
6a213ecb
RK
119 <p>The libao plugin has been removed, because the plugin API is not
120 usable in libao 1.0.0.</p>
86541f5a 121
79ab6bd2
RK
122 <p>Playlists are now supported. These allow a collection of tracks to be
123 prepared offline and played as a unit.</p>
124
7cd4dd21
RK
125 </div>
126
6a7eb118
RK
127 <h3>Disobedience</h3>
128
129 <div class=section>
130
69c456f3
RK
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>
6a7eb118 135
c2f51940
RK
136 <p>Disobedience now supports playlist editing and has a compact mode,
137 available from the <b>Control</b> menu.</p>
79ab6bd2 138
67b1beae
RK
139 <p>Disobedience has a <a href="disobedience/manual/index.html">new
140 manual</a>.</p>
141
6a7eb118
RK
142 </div>
143
7cd4dd21
RK
144 <h3>Web Interface</h3>
145
146 <div class=section>
53710d44 147
7cd4dd21
RK
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>
533272be 151
f207f710
RK
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>
f5fd9a6b
RK
164
165 </div>
7cd4dd21
RK
166
167 <h3>General</h3>
f5fd9a6b 168
7cd4dd21
RK
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
2cb9bc5f
RK
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
7cd4dd21
RK
180 <p>Various elements of the source code have been
181 rationalized.</p>
182
183 </div>
184
f5fd9a6b
RK
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>
417ef7de
RK
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
f5fd9a6b
RK
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
7cd4dd21 205 <tr>
548c9cba
RK
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>
bbaed9ec
RK
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>
7cd4dd21
RK
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>
6762ac8a
RK
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>
93379b3d
RK
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>
6762ac8a
RK
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>
fa667301
RK
254
255 <tr>
d53ef367
RK
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>
fa667301
RK
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
e03df0a5
RK
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
900fa0b8 270 <tr>
de38ab9b
RK
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>
900fa0b8
RK
276 <td>(none)</td>
277 <td>&ldquo;found track in no collection&rdquo; messages for scratches
278 are now suppressed</td>
279 </tr>
280
37e94d5c
RK
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
f5fd9a6b 287 </table>
f5fd9a6b
RK
288 </div>
289 </div>
290
a0e78d96 291<h2>Changes up to version 4.3</h2>
d8b95785
RK
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
e02f9807
RK
300 played. This would lead to the counter showing incorrect values in
301 various situations.</p>
d8b95785
RK
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
a0e78d96
RK
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
d8b95785
RK
310 </div>
311
6151ae7e
RK
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
ff45af7c
RK
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
e02f9807
RK
324 <p>The default track name parsing was modified to handle filenames
325 generated by iTunes.</p>
326
6151ae7e
RK
327 </div>
328
10a6c925 329 <h3>Miscellaneous</h3>
d8b95785
RK
330
331 <div class=section>
332
10a6c925
RK
333 <p><tt>disorderfm</tt> now preserves directory permissions.</p>
334
e7eb3a27
RK
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
d8b95785 340 <p>The build system will now automatically cope with Fink's broken GTK+
e02f9807
RK
341 packages. There are a number of improvements to the Debian
342 packaging.</p>
d8b95785 343
74cfbeaa
RK
344 <p>DisOrder now builds on 64-bit Linux systems.</p>
345
e02f9807 346 <p>There are various minor fixes.</p>
d8b95785
RK
347
348 </div>
349
e02f9807
RK
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>
d8b95785 371 </div>
b0a578cb 372
eb2a1fe9
RK
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>
cc5b0a8e
RK
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>
eb2a1fe9
RK
417</div>
418
419
68210888
RK
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
452ad6ba
RK
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>
30f2f8c9
RK
453
454 <li>You can now play tracks off the recent tab.</li>
455
452ad6ba
RK
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
32918782
RK
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
f03d4184
RK
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
0ba75c7f 493<h2>Changes up to version 4.0</h2>
b0a578cb
RK
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
2eee4b0c
RK
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>
4cbafe13 565
64ac73bb
RK
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>
2eee4b0c 570
b0a578cb
RK
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<!--
736Local Variables:
737fill-column:79
4cbafe13 738indent-tabs-mode:nil
b0a578cb
RK
739End:
740-->