chiark - git - mdw - disorder/blob - CHANGES.html

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