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