[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%
}

table.bugs th {
  text-align: left
}

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

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

<p>This file documents recent user-visible changes to DisOrder.</p>

<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 {
	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 DisOrder.</p>
	59
68210888 RK	60	<h2>Changes up to version 4.1.1</h2>
	61
	62	<div class=section>
	63
	64	<p>Disobedience's “Login” window now works when you are logged
	65	in.</p>
	66
	67	</div>
	68
452ad6ba RK	69	<h2>Changes up to version 4.1</h2>
	70
	71	<div class=section>
	72
	73	<h3>Disobedience</h3>
	74
	75	<div class=section>
	76
	77	<p>Disobedience has been largely rewritten:</p>
	78
	79	<ul>
	80
	81	<li>All the tabs now use native GTK+ list/tree widgets, resulting in
	82	greater speed in some cases and more consistency with other GTK+
	83	applications.</li>
	84
	85	<li>You can now use type-ahead find in the choose tab. The initiation
	86	of a search is delayed slightly to avoid lots of updates when you're
	87	half way through entering search terms.</li>
	88
	89	<li>The choose tab now shows track lengths.</li>
	90
	91	<li>Many buttons are now more reliably made insensitive when they can't
	92	be used.</li>
30f2f8c9 RK	93
	94	<li>You can now play tracks off the recent tab.</li>
	95
452ad6ba RK	96	</ul>
	97
	98	<p>Disobedience attempts to cope with servers from older versions, up to
	99	a point, but this is not well tested and it's best to keep the server
	100	fully up to date.</p>
	101
	102	</div>
	103
	104	<h3>Server</h3>
	105
	106	<div class=section>
	107
	108	<p>When a track shares a directory with its alias, the real track name is
	109	now returned instead of the alias (the opposite way round to the previous
	110	behaviour).</p>
	111
	112	</div>
	113	</div>
	114
32918782 RK	115	<h2>Changes up to version 4.0.2</h2>
	116
	117	<div class=section>
	118
	119	<p>Corrected web browser linked from Disobedience.</p>
	120
	121	</div>
	122
f03d4184 RK	123	<h2>Changes up to version 4.0.1</h2>
	124
	125	<div class=section>
	126
	127	<p>Libtool and Automake now install the CGI correctly. As part of this,
	128	<tt>cgidir</tt> has been renamed to <tt>cgiexecdir</tt>. The configure
	129	script will report an error if you try to use the old name.</p>
	130
	131	</div>
	132
0ba75c7f	133	<h2>Changes up to version 4.0</h2>
b0a578cb RK	134
	135	<div class=section>
	136
	137	<h3>Server</h3>
	138
	139	<div class=section>
	140
	141	<p>The <tt>gap</tt> directive will no longer work. It could be
	142	restored if there is real demand.</p>
	143
	144	<h4>Event Scheduling</h4>
	145
	146	<div class=section>
	147
	148	<p>It is now possible to schedule events to occur in the future.
	149	Currently the supported actions are playing a specific track, and
	150	changing a global preference (thus allowing e.g. random play to be
	151	turned on or off). See the <tt>schedule-*</tt>
	152	commands described in disorder(1).</p>
	153
	154	</div>
	155
	156	<h4>Random Track Choice</h4>
	157
	158	<div class=section>
	159
	160	<p>This has been completely rewritten to support new features:</p>
	161
	162	<ul>
	163
	164	<li>tracks in the recently-played list or in the queue are no longer
	165	eligible for random choice.</li>
	166
	167	<li>there is a new <tt>weight</tt> track preference allowing for
	168	non-uniform track selection. See disorder(1) for details.</li>
	169
	170	<li>there is a new configuration item <tt>replay_min</tt> defining
	171	the minimum time before a played track can be picked at random.
	172	The default is 8 hours (which matches the earlier behaviour).</li>
	173
	174	<li>recently added tracks are biased up; see <tt>new_bias</tt> and
	175	<tt>new_bias_age</tt> in disorder_config(5).</li>
	176
	177	</ul>
	178
	179	</div>
	180
	181	<h4>Web Interface</h4>
	182
	183	<div class=section>
	184
	185	<p>This has been largely rewritten. The most immediate benefits are:</p>
	186
	187	<ul>
	188
	189	<li>the search page is integrated into the choose page, and
	190	includes links to parent directories.</li>
	191
	192	<li>if you try to do something you have insufficient rights for,
	193	instead of getting an error page or nothing happening, you are
	194	redirected to the login page.</li>
	195
	196	</ul>
	197
198	<p>Customizers should find their lives easier: the syntax is less onerous, it
199	is possible to define macros to avoid repetition, and the documentation is
200	less monolithic (see disorder.cgi(8) as a starting point).</p>
201
2eee4b0c RK	202	<p>Mail is now sent via the system sendmail program, though it remains
	203	possible to use TCP to connect to an SMTP server. See <tt>sendmail</tt> and
	204	<tt>smtp_server</tt> in disorder_config(5).</p>
4cbafe13	205
64ac73bb RK	206	<p>The web interface is now installed automatically. If you don't want it,
	207	use <tt>./configure --without-cgi</tt>. If you want it in a non-default
	208	location, or no location for it is detected, set <tt>cgidir</tt>
	209	and <tt>httpdir</tt> on the <tt>./configure</tt> command line.</p>
2eee4b0c	210
b0a578cb RK	211	</div>
	212
	213	</div>
	214
	215	<h3>Disobedience</h3>
	216
	217	<div class=section>
	218
	219	<p>There is now a new user management window. From here you can add and
	220	remove users or modify their settings.</p>
	221
	222	<p>Relatedly, the server will only allow remote user management if you set
	223	<tt>remote_userman</tt> to <tt>yes</tt>.</p>
	224
	225	</div>
	226
	227	<h3>Miscellaneous</h3>
	228
	229	<div class=section>
	230
	231	<p><tt>scripts/setup</tt> now honors command line options, and can
	232	set up network play as well as the local default sound device.</p>
	233
	234	</div>
	235
	236	<h3>Bugs Fixed</h3>
	237
	238	<div class=section>
	239
	240	<table class=bugs>
	241	<tr>
	242	<th>ID</th>
	243	<th>Description</th>
	244	</tr>
	245
	246	<tr>
	247	<td><a href="http://code.google.com/p/disorder/issues/detail?id=2">#2</a></td>
	248	<td>Search results should link to directories</td>
	249	</tr>
	250
	251	<tr>
	252	<td><a href="http://code.google.com/p/disorder/issues/detail?id=6">#6</a></td>
	253	<td>Schedule tracks for a particular time</td>
	254	</tr>
	255
	256	<tr>
	257	<td><a href="http://code.google.com/p/disorder/issues/detail?id=10">#10</a></td>
	258	<td>Non-uniform track selection</td>
	259	</tr>
	260
	261	<tr>
	262	<td><a href="http://code.google.com/p/disorder/issues/detail?id=11">#11</a></td>
	263	<td>Bias random selection to newly added tracks</td>
	264	</tr>
	265
	266	<tr>
	267	<td><a href="http://code.google.com/p/disorder/issues/detail?id=13">#13</a></td>
	268	<td>Default encoding for debian setup scripts</td>
	269	</tr>
	270
	271	<tr>
	272	<td><a href="http://code.google.com/p/disorder/issues/detail?id=16">#16</a></td>
	273	<td>Cookie expiry causes user to be silently logged out and not
	274	subsequently redirected to login page</td>
275	</tr>
276
277	<tr>
278	<td><a href="http://code.google.com/p/disorder/issues/detail?id=20">#20</a></td>
279	<td>Broken aliasing rules</td>
280	</tr>
281
282	</table>
283
284	</div>
285
286	</div>
287
288	<h2>Changes up to version 3.0.2</h2>
289
290	<div class=section>
291
292	<p>Builds <tt>--without-server</tt> should work again.</p>
293
294	<p>The web interface is a bit more liberal in the cookie value
295	syntax it will accept.</p>
296
297	<p>Clients fail more gracefully if no password is available.</p>
298
299	</div>
300
301	<h2>Changes up to version 3.0.1</h2>
302
303	<div class=section>
304
305	<p>Debian upgrades from 2.0.x should now work better.</p>
306
307	</div>
308
309	<h2>Changes up to version 3.0</h2>
310
311	<div class=section>
312
313	<p><b>Important</b>! See <a
314	href="README.upgrades">README.upgrades</a> when upgrading.</p>
315
316	<h3>Platforms And Installation</h3>
317
318	<div class=section>
319
320	<p>Mac OS X and FreeBSD are somewhat supported. There is now a bash
321	script in <tt>scripts/setup</tt> which will automate the setup after
322	<tt>make install</tt>.</p>
323
324	</div>
325
326	<h3>Server</h3>
327
328	<div class=section>
329
330	<p>Users are now stored in the database rather than a configuration
331	file.</p>
332
333	<p>The server now has a built-in list of stopwords and players, so
334	only additions to these need be mentioned in the configuration file.</p>
335
336	<p>The default inter-track gap is now 0s.</p>
337
338	<p>How sound is played is now controlled via the new <tt>api</tt>
339	configuration command. This also controls how the volume is set,
340	which now works with ALSA as well as OSS.</p>
341
342	<p>A bug in the MP3 decoder was fixed (also in 2.0.4).</p>
343
344	</div>
345
346	<h3>Web Interface</h3>
347
348	<div class=section>
349
350	<p>The web interface now uses cookies to remember user identity, and
351	allows online registration of new users. Also it is no longer
352	necessary to manually specify the URL of the web interface (but you
353	can override it if you don't like the value it figures out).</p>
354
355	<p>It is possible to allow users to register via the web interface.</p>
356
357	<p>The web interface's browser support has been improved. It has
358	been tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer
359	7 and Opera 9.</p>
360
361	</div>
362
363	<h3>Disobedience</h3>
364
365	<div class=section>
366
367	<p>A bug which would cause a crash if you attempt to rearrange the
368	queue while no track was playing has been fixed. There is a new
369	'deselect all tracks' option, mirroring 'select all tracks.</p>
370
371	</div>
372
373	</div>
374
375	<!--
376	Local Variables:
377	fill-column:79
4cbafe13	378	indent-tabs-mode:nil
b0a578cb RK	379	End:
b0a578cb RK	380	-->