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