# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
-dochtml_DATA=index.html intro.html tabs.html window.html \
- disobedience.css \
+dochtml_DATA=index.html intro.html misc.html playlists.html \
+ properties.html tabs.html window.html disobedience.css \
arch-simple.png button-pause.png button-playing.png \
button-random.png button-rtp.png button-scratch.png \
choose-search.png choose.png disobedience-debian-menu.png \
disobedience-terminal.png disorder-email-confirm.png \
disorder-web-login.png login.png menu-control.png \
menu-edit.png menu-help.png menu-server.png queue-menu.png \
- queue.png queue2.png recent.png volume-slider.png
+ queue.png queue2.png recent.png track-properties.png \
+ volume-slider.png
<li>How to edit track properties.</li>
</ul>
+ <p class=chapter><a href="playlists.html">5. Playlists</a></p>
+
+ <ul>
+ <li>What playlists are.</li>
+ <li>Editing playlists.</li>
</ul>
+
+ <p class=chapter><a href="misc.html">Appendix</a></p>
+
+ <ul>
+ <li>Reporting bugs</li>
+ <li>Copyright notice</li>
+ </ul>
+
</body>
</html>
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!--
+This file is part of DisOrder.
+Copyright (C) 2009 Richard Kettlewell
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
+-->
+<html>
+ <head>
+ <title>Disobedience: Appendix</title>
+ <link rel=stylesheet
+ type="text/css"
+ href="disobedience.css">
+ </head>
+ <body>
+ <h1>Appendix</h1>
+
+ <h2><a name=bugs>Reporting Bugs</a></h2>
+
+ <p>Please report bugs using
+ DisOrder's <a href="http://code.google.com/p/disorder/issues/list">bug
+ tracker</a>.</p>
+
+ <h2><a name=copyright>Copyright Notice</a></h2>
+
+ <p>Copyright © 2003-2009 <a
+ href="http://www.greenend.org.uk/rjk/">Richard Kettlewell</a><br>
+
+ Portions copyright © 2007 <a
+ href="http://www.chiark.greenend.org.uk/~ryounger/">Ross
+ Younger</a><br>
+
+ Portions copyright © 2007, 2008 Mark Wooding<br>
+
+ Portions extracted from <a
+ href="http://mpg321.sourceforge.net/">MPG321</a>, Copyright © 2001 Joe
+ Drew, Copyright © 2000-2001 Robert Leslie<br>
+
+ Portions copyright © 1997-2006 <a
+ href="http://www.fsf.org/">Free Software Foundation, Inc</a><br>
+
+ Portions Copyright © 2000 <a href="http://www.redhat.com">Red Hat,
+ Inc.</a>, Jonathan Blandford <jrb@redhat.com></p>
+
+ <p>This program is free software: you can redistribute it and/or modify it
+ under the terms of the <a href="http://www.gnu.org/licenses/gpl-3.0.html">GNU
+ General Public License</a> as published by the Free Software Foundation,
+ either version 3 of the License, or (at your option) any later version.</p>
+
+ <p>This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ General Public License for more details.</p>
+
+ <p>You should have received a copy of the GNU General Public License along
+ with this program. If not, see <a
+ href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.</p>
+
+
+ </body>
+</html>
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<!--
+This file is part of DisOrder.
+Copyright (C) 2009 Richard Kettlewell
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
+-->
+<html>
+ <head>
+ <title>Disobedience: Playlists</title>
+ <link rel=stylesheet
+ type="text/css"
+ href="disobedience.css">
+ </head>
+ <body>
+ <h1>5. Playlists</h1>
+
+ <p>The chapter describes playlist and how to use them.</p>
+
+ <h2><a name=what>5.1 What are playlists?</a></h2>
+
+ <p>A playlist is a named list of tracks stored by the server. It
+ can be edit by either just its owner or, alternatively, by all
+ users. It can be played as a unit when required.</p>
+
+ <p>Playlists fall into three categories:</p>
+
+ <table>
+ <tr>
+ <td><b>Shared</b></td>
+ <td>Shared playlists have no owner and can be seen and edited
+ by anybody.</td>
+ </tr>
+
+ <tr>
+ <td><b>Public</b></td>
+ <td>Public playlist are owned by their creator and can be seen
+ by anybody. Only their creator can edit them, however.</td>
+ </tr>
+
+ <tr>
+ <td><b>Private</b></td>
+ <td>Private playlists are owned by their creator and can only
+ be seen or edited by their creator.</td>
+ </tr>
+
+ </table>
+
+ <p>To bring up the playlist window, select <b>Edit > Edit
+ Playlists</b> from the menu.</p>
+
+ <h2><a name=creating>5.2 Creating Playlists</a></h2>
+
+ <!-- TODO rewrite with screenshots -->
+
+ <p>To create a playlist, click the <b>Add</b> button in the
+ playlist editor. This will create a pop-up window where you can
+ enter the name of the new playlist and decide whether it is
+ shared, public or private.</p>
+
+ <p>Only Roman letters (without any accents) and digits are allowed
+ in playlist names.</p>
+
+ <h2><a name=editing>5.3 Editing Playlists</a></h2>
+
+ <!-- TODO rewrite with screenshots - might be worth waiting until
+ picker is a tree -->
+
+ <p>When a playlist is selected, you can edit in the right hand half
+ of the playlist window. The editor is very similar in structure
+ and function to the <a href="tabs.html#queue">queue</a>. You can
+ rearrange tracks within it by drag and drop and you can drag tracks
+ from the <b>Choose</b> tab into it.</p>
+
+ <h2><a name=playing>5.3 Playing Playlists</a></h2>
+
+ <p>There are three ways to play a playlist:</p>
+
+ <ol>
+
+ <li>Right clicking in the playlist editor will create a pop-up
+ menu. In addition to the familiar options there is an option to
+ play this playlist.</li>
+
+ <li>You can select all the tracks and drag them to the desired
+ point in the <b>Queue</b> tab.</li>
+
+ <li>You can use <b>Control > Activate Playlist</b> from the main
+ menu.</li>
+
+ </ol>
+
+ </body>
+</html>