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