chiark / gitweb /
Merge from dmanual branch
[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 {
42 width: 100%
43}
44
45table.bugs th {
46 text-align: left
47}
48
49span.command {
50 font-family: monospace
51}
52</style>
53</head>
54
55<body>
56<h1>DisOrder Change History</h1>
57
d8b95785
RK
58<p>This file documents recent user-visible changes to <a
59 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
60
f5fd9a6b
RK
61<h2>Changes up to version 4.4</h2>
62
63 <div class=section>
64
f207f710
RK
65 <h3>Server</h3>
66
f5fd9a6b
RK
67 <div class=section>
68
fe33cfc0 69 <p>The <tt>device</tt> configuration option now works under OS X.
7cd4dd21 70 Devices may
f207f710 71 be specified either by UID or name. Fixes <a
f5fd9a6b
RK
72 href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
73 27</a>.</p>
f207f710 74
f71fc3ab 75 <p>Gapless play should be more reliable, and playback latency over RTP
6762ac8a 76 should be a bit lower. Note though that all the sound output code has
f71fc3ab
RK
77 been reorganized and in some cases completely rewritten, so it's possible
78 that bugs may have been (re-)introduced.</p>
7cd4dd21
RK
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>
c3feb35b
RK
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
317dc3e8
RK
85 <a href="http://sox.sourceforge.net/">SoX</a>. SoX support will be
86 removed in a future version.</p>
c3feb35b 87
79ab6bd2
RK
88 <p>Playlists are now supported. These allow a collection of tracks to be
89 prepared offline and played as a unit.</p>
90
7cd4dd21
RK
91 </div>
92
6a7eb118
RK
93 <h3>Disobedience</h3>
94
95 <div class=section>
96
69c456f3
RK
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>
6a7eb118 101
c2f51940
RK
102 <p>Disobedience now supports playlist editing and has a compact mode,
103 available from the <b>Control</b> menu.</p>
79ab6bd2 104
67b1beae
RK
105 <p>Disobedience has a <a href="disobedience/manual/index.html">new
106 manual</a>.</p>
107
6a7eb118
RK
108 </div>
109
7cd4dd21
RK
110 <h3>Web Interface</h3>
111
112 <div class=section>
53710d44 113
7cd4dd21
RK
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
f207f710
RK
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>
f5fd9a6b
RK
130
131 </div>
7cd4dd21
RK
132
133 <h3>General</h3>
f5fd9a6b 134
7cd4dd21
RK
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
2cb9bc5f
RK
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
7cd4dd21
RK
146 <p>Various elements of the source code have been
147 rationalized.</p>
148
149 </div>
150
f5fd9a6b
RK
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
7cd4dd21 166 <tr>
548c9cba
RK
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>
bbaed9ec
RK
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>
7cd4dd21
RK
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>
6762ac8a
RK
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>
93379b3d
RK
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>
6762ac8a
RK
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>
fa667301
RK
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
e03df0a5
RK
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
f5fd9a6b 226 </table>
f5fd9a6b
RK
227 </div>
228 </div>
229
a0e78d96 230<h2>Changes up to version 4.3</h2>
d8b95785
RK
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
e02f9807
RK
239 played. This would lead to the counter showing incorrect values in
240 various situations.</p>
d8b95785
RK
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
a0e78d96
RK
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
d8b95785
RK
249 </div>
250
6151ae7e
RK
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
ff45af7c
RK
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
e02f9807
RK
263 <p>The default track name parsing was modified to handle filenames
264 generated by iTunes.</p>
265
6151ae7e
RK
266 </div>
267
10a6c925 268 <h3>Miscellaneous</h3>
d8b95785
RK
269
270 <div class=section>
271
10a6c925
RK
272 <p><tt>disorderfm</tt> now preserves directory permissions.</p>
273
e7eb3a27
RK
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
d8b95785 279 <p>The build system will now automatically cope with Fink's broken GTK+
e02f9807
RK
280 packages. There are a number of improvements to the Debian
281 packaging.</p>
d8b95785 282
74cfbeaa
RK
283 <p>DisOrder now builds on 64-bit Linux systems.</p>
284
e02f9807 285 <p>There are various minor fixes.</p>
d8b95785
RK
286
287 </div>
288
e02f9807
RK
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>
d8b95785 310 </div>
b0a578cb 311
eb2a1fe9
RK
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>
cc5b0a8e
RK
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>
eb2a1fe9
RK
356</div>
357
358
68210888
RK
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
452ad6ba
RK
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>
30f2f8c9
RK
392
393 <li>You can now play tracks off the recent tab.</li>
394
452ad6ba
RK
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
32918782
RK
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
f03d4184
RK
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
0ba75c7f 432<h2>Changes up to version 4.0</h2>
b0a578cb
RK
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
2eee4b0c
RK
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>
4cbafe13 504
64ac73bb
RK
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>
2eee4b0c 509
b0a578cb
RK
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<!--
675Local Variables:
676fill-column:79
4cbafe13 677indent-tabs-mode:nil
b0a578cb
RK
678End:
679-->