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