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.  (Use the <tt>mount_rescan</tt> option if you want to
  81     suppress this behavior.)</p>
  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
  91 <h2>Changes up to version 5.0</h2>
  92
  93   <div class=section>
  94
  95     <h3>Server</h3>
  96
  97     <div class=section>
  98
  99       <p>The <tt>device</tt> configuration option now works under OS X.
 100       Devices may
 101       be specified either by UID or name.  Fixes <a
 102        href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
 103       27</a>.</p>
 104
 105       <p>Gapless play should be more reliable, and playback latency over RTP
 106       should be a bit lower.  Note though that all the sound output code has
 107       been reorganized and in some cases completely rewritten, so it's possible
 108       that bugs may have been (re-)introduced.  Decoding of scratches is also
 109       initiated ahead of time, giving more reliable playback.</p>
 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>
 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
 116       <a href="http://sox.sourceforge.net/">SoX</a>.  SoX support will be
 117       removed in a future version.</p>
 118
 119       <p>The libao plugin has been removed, because the plugin API is not
 120       usable in libao 1.0.0.</p>
 121
 122       <p>Playlists are now supported.  These allow a collection of tracks to be
 123       prepared offline and played as a unit.</p>
 124
 125     </div>
 126
 127     <h3>Disobedience</h3>
 128
 129     <div class=section>
 130
 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>
 135
 136       <p>Disobedience now supports playlist editing and has a compact mode,
 137       available from the <b>Control</b> menu.</p>
 138
 139       <p>Disobedience has a <a href="disobedience/manual/index.html">new
 140       manual</a>.</p>
 141
 142     </div>
 143
 144     <h3>Web Interface</h3>
 145
 146     <div class=section>
 147
 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>
 151
 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>
 164
 165     </div>
 166
 167     <h3>General</h3>
 168
 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
 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
 180       <p>Various elements of the source code have been
 181       rationalized.</p>
 182
 183     </div>
 184
 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>
 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
 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
 205         <tr>
 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>
 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>
 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>
 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>
 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>
 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>
 254
 255         <tr>
 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>
 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
 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
 270         <tr>
 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>
 276           <td>(none)</td>
 277           <td>&ldquo;found track in no collection&rdquo; messages for scratches
 278           are now suppressed</td>
 279         </tr>
 280
 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
 287       </table>
 288     </div>
 289   </div>
 290
 291 <h2>Changes up to version 4.3</h2>
 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
 300         played.  This would lead to the counter showing incorrect values in
 301         various situations.</p>
 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
 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
 310       </div>
 311
 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
 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
 324         <p>The default track name parsing was modified to handle filenames
 325         generated by iTunes.</p>
 326
 327       </div>
 328
 329     <h3>Miscellaneous</h3>
 330
 331       <div class=section>
 332
 333         <p><tt>disorderfm</tt> now preserves directory permissions.</p>
 334
 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
 340         <p>The build system will now automatically cope with Fink's broken GTK+
 341         packages.  There are a number of improvements to the Debian
 342         packaging.</p>
 343
 344         <p>DisOrder now builds on 64-bit Linux systems.</p>
 345
 346         <p>There are various minor fixes.</p>
 347
 348       </div>
 349
 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>
 371   </div>
 372
 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>
 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>
 417 </div>
 418
 419
 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
 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>
 453
 454         <li>You can now play tracks off the recent tab.</li>
 455
 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
 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
 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
 493 <h2>Changes up to version 4.0</h2>
 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
 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>
 565
 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>
 570
 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 <!--
 736 Local Variables:
 737 fill-column:79
 738 indent-tabs-mode:nil
 739 End:
 740 -->