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