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