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