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