[disorder] / CHANGES.html

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<title>DisOrder Change History</title>
<style type="text/css">
body {
  color: black;
  background-color: white;
  font-family: times,serif;
  font-weight: normal;
  font-size: 12pt;
  font-variant: normal
}

div.section {
  margin-left:1em
}

h1 {
  background-color: #e0ffe0;
  font-family: helvetica,sans-serif;
  padding: 0.2em
}

h2 {
  background-color: #e0ffe0;
  font-family: helvetica,sans-serif;
  padding: 0.2em
}

h3 {
  background-color: #f0f0f0;
  font-family: helvetica,sans-serif;
  padding: 0.2em
}

h4 {
  font-family: helvetica,sans-serif
}

table.bugs {
  width: 100%;
  font-size: 12pt;
  border-collapse: collapse;
  border:1px
}

table.bugs th {
  text-align: left;
  border: 1px solid black;
  background-color: black;
  color: white
}

table.bugs td {
  border: 1px solid
}

span.command {
  font-family: monospace
}
</style>
</head>

<body>
<h1>DisOrder Change History</h1>

<p>This file documents recent user-visible changes to <a
 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>

<h2>Changes up to version 5.0</h2>

  <div class=section>
  
    <h3>Server</h3>
 
    <div class=section>

      <p>The <tt>device</tt> configuration option now works under OS X.
      Devices may
      be specified either by UID or name.  Fixes <a
       href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
      27</a>.</p>

      <p>Gapless play should be more reliable, and playback latency over RTP
      should be a bit lower.  Note though that all the sound output code has
      been reorganized and in some cases completely rewritten, so it's possible
      that bugs may have been (re-)introduced.  Decoding of scratches is also
      initiated ahead of time, giving more reliable playback.</p>
      
      <p>The <tt>command</tt> backend now (optionally) sends silence instead
      of suspending writes when a pause occurs or no track is playing.</p>

      <p>If <a href="http://www.mega-nerd.com/SRC/">libsamplerate</a> is
      available at build time then that will be used instead of invoking
      <a href="http://sox.sourceforge.net/">SoX</a>.  SoX support will be
      removed in a future version.</p>

      <p>The libao plugin has been removed, because the plugin API is not
      usable in libao 1.0.0.</p>

      <p>Playlists are now supported.  These allow a collection of tracks to be
      prepared offline and played as a unit.</p>

    </div>
      
    <h3>Disobedience</h3>

    <div class=section>

      <p>Multiple tracks can now be dragged in the queue in a single operation.
      Furthermore, it is now possible to drag tracks from the
      &ldquo;Recent&rdquo;, &ldquo;Added&rdquo; and &ldquo;Choose&rdquo; tabs
      to the queue.</p>

      <p>Disobedience now supports playlist editing and has a compact mode,
      available from the <b>Control</b> menu.</p>

      <p>Disobedience has a <a href="disobedience/manual/index.html">new
      manual</a>.</p>

    </div>

    <h3>Web Interface</h3>
 
    <div class=section>

      <p>Confirmation URLs should be cleaner (and in particular not end
      with punctuation).  (Please see <a
      href="README.upgrades">README.upgrades</a> for more about this.)</p>

    </div>
      
    <h3>RTP Player</h3>
  
    <div class=section>

      <p>There is a new <tt>--command</tt> option which allows the RTP player
      to send audio data to a user-chosen command instead of an audio API. See
      the man page for details.</p>
      
      <p>The <tt>--device</tt> option to <tt>disorder-playrtp</tt> now works
      under OS X (as above).</p>
        
    </div>
      
    <h3>General</h3>

    <div class=section>

      <p>IPv6 should now work.  Network address specifications
      (<tt>listen</tt>, <tt>connect</tt> etc) can now be prefixed with
      <tt>-4</tt> or <tt>-6</tt> to force use
      of IPv4 or IPv6, though normally this should not be needed.</p>

      <p>Unicode support has been upgraded to <a
      href="http://www.unicode.org/versions/Unicode5.1.0/">Unicode
      5.1.0</a>.</p>

      <p>Various elements of the source code have been
      rationalized.</p>
      
    </div>
    
    <h3>Bugs fixed</h3>
  
    <div class=section>

      <table class=bugs>
        <tr>
          <th>ID</th>
          <th>Description</th>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=22">#22</a></td>
          <td>Background decoders interact badly with server reload</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=27">#27</a></td>
          <td>Mac DisOrder uses wrong sound device</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=30">#30</a></d>
          <td>mini disobedience interface</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=32">#32</a></d>
          <td>Excessively verbose log chatter on shutdown</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=33">#33</a></d>
          <td>(Some) plugins need -lm.</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=39">#39</a></d>
          <td>Double bind() non-multicast AF_INET</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=40">#40</a></d>
          <td>Missing stub function</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=41">#41</a></d>
          <td>Missing includes for timeval</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=42">#42</a></d>
          <td>syntax error in empeg_host section</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=43">#43</a></d>
          <td>decoder segfault with FLAC 1.2.1</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=44">#44</a></d>
          <td>gcc 4.3.2-1ubuntu12 SUYB patch</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=45">#45</a></d>
          <td>disobedience doesn't configure its back end</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=46">#46</a></d>
          <td>Sort search results in web interface</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=48">#48</a></d>
          <td>build-time dependency on <tt>oggdec</tt> removed</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=49">#49</a></d>
          <td>Disobedience's 'When' column gets out of date</td>
        </tr>

        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=51">#51</a></td>
          <td>Improved speaker process robustness</td>
        </tr>

        <tr>
          <td>(none)</td>
	  <td>&ldquo;found track in no collection&rdquo; messages for scratches
	  are now suppressed</td>
        </tr>

        <tr>
          <td>(none)</td>
          <td>Disobedience would sometimes fail to notice when a track
          started, leading to its display getting out of date.</td>
        </tr>

      </table>
    </div>
  </div>

<h2>Changes up to version 4.3</h2>

  <div class=section>

    <h3>Disobedience</h3>

      <div class=section>

        <p>A bug was fixed in the calculation of how much of the track had
        played.  This would lead to the counter showing incorrect values in
        various situations.</p>

        <p>Disobedience's icons have been changed to larger, more colorful
        ones.  The SVG source is included if you want to fiddle with them.</p>

        <p>&ldquo;Select all&rdquo; is now no longer available in the choose
        tab.  Instead there is a new &ldquo;Select children&rdquo; option which
        selects the file children of a single subdirectory.</p>

      </div>

    <h3>Server</h3>

      <div class=section>

        <p>The selection bias for newly added tracks was reduced by half.  You
        can put it back to the old very neophilic value with
        &ldquo;<tt>new_bias 900000</tt>&rdquo; in the config file.</p>

        <p>It is now possible to &lsquo;adopt&rsquo; randomly picked tracks.
        Disobedience and the command-line client support this but the web
        interface does not.</p>

        <p>The default track name parsing was modified to handle filenames
        generated by iTunes.</p>
        
      </div>

    <h3>Miscellaneous</h3>

      <div class=section>

        <p><tt>disorderfm</tt> now preserves directory permissions.</p>

        <p>DisOrder is now licensed under <a
         href="http://www.gnu.org/licenses/gpl-3.0.html">GPL v3</a>.  The main
        goal is to prohibit <a
         href="http://en.wikipedia.org/wiki/Tivoization">Tivoization</a>.</p>

        <p>The build system will now automatically cope with Fink's broken GTK+
        packages.  There are a number of improvements to the Debian
        packaging.</p>

        <p>DisOrder now builds on 64-bit Linux systems.</p>

        <p>There are various minor fixes.</p>

      </div>

  <h3>Bugs fixed</h3>
  
    <div class=section>

      <table class=bugs>
        <tr>
          <th>ID</th>
          <th>Description</th>
        </tr>
        
        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=24">#24</a></td>
          <td>Fails to build on ubuntu 8.10</td>
        </tr>
        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=26">#26</a></td>
          <td>Disobedience shows wrong track elapsed time after a pause</td>
        </tr>
      </table>
      
    </div>
  </div>

<h2>Changes up to version 4.2</h2>

<div class=section>

  <h3>Disobedience</h3>
  
    <div class=section>

      <p>The login window now has a 'remote' switch.  If this is turned off
      then Disobedience will connect to a local server.  Formerly it would
      always use TCP/IP.</p>

      <p>The Delete and backspace keys will now remove tracks from the queue.
      Escape will now dismiss the properties, users or login windows and return
      now works in the login and properties windows.</p>
      
    </div>

  <h3>Documentation</h3>
  
    <div class=section>

      <p>Track and global preferences are now described in a new
      <b>disorder_preferences</b>(5) man page.</p>
      
    </div>

  <h3>Bugs fixed</h3>
  
    <div class=section>

      <table class=bugs>
        <tr>
          <th>ID</th>
          <th>Description</th>
        </tr>
        
        <tr>
          <td><a href="http://code.google.com/p/disorder/issues/detail?id=21">#21</a></td>
          <td>CGI should use PATH_INFO more sensibly</td>
        </tr>
      </table>
      
    </div>
</div>


<h2>Changes up to version 4.1.1</h2>

<div class=section>

  <p>Disobedience's &ldquo;Login&rdquo; window now works when you are logged
  in.</p>
  
</div>

<h2>Changes up to version 4.1</h2>

<div class=section>

  <h3>Disobedience</h3>
  
    <div class=section>
  
      <p>Disobedience has been largely rewritten:</p>

      <ul>
        
        <li>All the tabs now use native GTK+ list/tree widgets, resulting in
        greater speed in some cases and more consistency with other GTK+
        applications.</li>

        <li>You can now use type-ahead find in the choose tab.  The initiation
        of a search is delayed slightly to avoid lots of updates when you're
        half way through entering search terms.</li>

        <li>The choose tab now shows track lengths.</li>
    
        <li>Many buttons are now more reliably made insensitive when they can't
        be used.</li>

        <li>You can now play tracks off the recent tab.</li>
        
      </ul>
      
      <p>Disobedience attempts to cope with servers from older versions, up to
      a point, but this is not well tested and it's best to keep the server
      fully up to date.</p>

    </div>
     
  <h3>Server</h3>
  
    <div class=section>

      <p>When a track shares a directory with its alias, the real track name is
      now returned instead of the alias (the opposite way round to the previous
      behaviour).</p>
      
    </div>
</div>

<h2>Changes up to version 4.0.2</h2>

<div class=section>

  <p>Corrected web browser linked from Disobedience.</p>
  
</div>

<h2>Changes up to version 4.0.1</h2>

<div class=section>

  <p>Libtool and Automake now install the CGI correctly.  As part of this,
  <tt>cgidir</tt> has been renamed to <tt>cgiexecdir</tt>.  The configure
  script will report an error if you try to use the old name.</p>
  
</div>

<h2>Changes up to version 4.0</h2>

<div class=section>

  <h3>Server</h3>

<div class=section>
  
  <p>The <tt>gap</tt> directive will no longer work.  It could be
  restored if there is real demand.</p>
  
  <h4>Event Scheduling</h4>

<div class=section>

  <p>It is now possible to schedule events to occur in the future.
  Currently the supported actions are playing a specific track, and
  changing a global preference (thus allowing e.g. random play to be
  turned on or off).  See the <tt>schedule-*</tt>
  commands described in disorder(1).</p>

</div>

<h4>Random Track Choice</h4>

<div class=section>

  <p>This has been completely rewritten to support new features:</p>

  <ul>

    <li>tracks in the recently-played list or in the queue are no longer
    eligible for random choice.</li>

    <li>there is a new <tt>weight</tt> track preference allowing for
    non-uniform track selection.  See disorder(1) for details.</li>

    <li>there is a new configuration item <tt>replay_min</tt> defining
    the minimum time before a played track can be picked at random.
    The default is 8 hours (which matches the earlier behaviour).</li>

    <li>recently added tracks are biased up; see <tt>new_bias</tt> and
    <tt>new_bias_age</tt> in disorder_config(5).</li>

  </ul>

</div>

<h4>Web Interface</h4>

<div class=section>

  <p>This has been largely rewritten.  The most immediate benefits are:</p>

  <ul>
    
    <li>the search page is integrated into the choose page, and
    includes links to parent directories.</li>
    
    <li>if you try to do something you have insufficient rights for,
    instead of getting an error page or nothing happening, you are
    redirected to the login page.</li>

  </ul>

  <p>Customizers should find their lives easier: the syntax is less onerous, it
  is possible to define macros to avoid repetition, and the documentation is
  less monolithic (see disorder.cgi(8) as a starting point).</p>

  <p>Mail is now sent via the system sendmail program, though it remains
  possible to use TCP to connect to an SMTP server.  See <tt>sendmail</tt> and
  <tt>smtp_server</tt> in disorder_config(5).</p>

  <p>The web interface is now installed automatically.  If you don't want it,
  use <tt>./configure --without-cgi</tt>.  If you want it in a non-default
  location, or no location for it is detected, set <tt>cgidir</tt>
  and <tt>httpdir</tt> on the <tt>./configure</tt> command line.</p>
  
</div>

</div>

<h3>Disobedience</h3>

<div class=section>

  <p>There is now a new user management window.  From here you can add and
  remove users or modify their settings.</p>

  <p>Relatedly, the server will only allow remote user management if you set
  <tt>remote_userman</tt> to <tt>yes</tt>.</p>

</div>

<h3>Miscellaneous</h3>

<div class=section>

  <p><tt>scripts/setup</tt> now honors command line options, and can
  set up network play as well as the local default sound device.</p>

</div>

<h3>Bugs Fixed</h3>

<div class=section>

  <table class=bugs>
    <tr>
      <th>ID</th>
      <th>Description</th>
    </tr>

    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=2">#2</a></td>
      <td>Search results should link to directories</td>
    </tr>

    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=6">#6</a></td>
      <td>Schedule tracks for a particular time</td>
    </tr>

    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=10">#10</a></td>
      <td>Non-uniform track selection</td>
    </tr>

    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=11">#11</a></td>
      <td>Bias random selection to newly added tracks</td>
    </tr>

    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=13">#13</a></td>
      <td>Default encoding for debian setup scripts</td>
    </tr>

    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=16">#16</a></td>
      <td>Cookie expiry causes user to be silently logged out and not
      subsequently redirected to login page</td>
    </tr>
    
    <tr>
      <td><a href="http://code.google.com/p/disorder/issues/detail?id=20">#20</a></td>
      <td>Broken aliasing rules</td>
    </tr>
    
  </table>

</div>

</div>

<h2>Changes up to version 3.0.2</h2>

<div class=section>

  <p>Builds <tt>--without-server</tt> should work again.</p>

  <p>The web interface is a bit more liberal in the cookie value
  syntax it will accept.</p>

  <p>Clients fail more gracefully if no password is available.</p>

</div>

<h2>Changes up to version 3.0.1</h2>

<div class=section>
  
  <p>Debian upgrades from 2.0.x should now work better.</p>
  
</div>

<h2>Changes up to version 3.0</h2>

<div class=section>
  
  <p><b>Important</b>!  See <a
  href="README.upgrades">README.upgrades</a> when upgrading.</p>
  
  <h3>Platforms And Installation</h3>
  
<div class=section>
  
  <p>Mac OS X and FreeBSD are somewhat supported.  There is now a bash
  script in <tt>scripts/setup</tt> which will automate the setup after
  <tt>make install</tt>.</p>
  
</div>

<h3>Server</h3>

<div class=section>
  
  <p>Users are now stored in the database rather than a configuration
  file.</p>
  
  <p>The server now has a built-in list of stopwords and players, so
  only additions to these need be mentioned in the configuration file.</p>
  
  <p>The default inter-track gap is now 0s.</p>
  
  <p>How sound is played is now controlled via the new <tt>api</tt>
  configuration command.  This also controls how the volume is set,
  which now works with ALSA as well as OSS.</p>
  
  <p>A bug in the MP3 decoder was fixed (also in 2.0.4).</p>
  
</div>

<h3>Web Interface</h3>

<div class=section>
  
  <p>The web interface now uses cookies to remember user identity, and
  allows online registration of new users.  Also it is no longer
  necessary to manually specify the URL of the web interface (but you
  can override it if you don't like the value it figures out).</p>
  
  <p>It is possible to allow users to register via the web interface.</p>
  
  <p>The web interface's browser support has been improved.  It has
  been tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer
  7 and Opera 9.</p>
  
</div>

<h3>Disobedience</h3>

<div class=section>

  <p>A bug which would cause a crash if you attempt to rearrange the
  queue while no track was playing has been fixed.  There is a new
  'deselect all tracks' option, mirroring 'select all tracks.</p>
  
</div>

</div>

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