From 68a1bff0084d623f3ba9ec3b2f56774b6c00d58b Mon Sep 17 00:00:00 2001
Message-Id: <68a1bff0084d623f3ba9ec3b2f56774b6c00d58b.1717684008.git.mdw@distorted.org.uk>
From: Mark Wooding
Date: Sat, 12 Apr 2008 15:00:19 +0100
Subject: [PATCH] Document appearance of weight in UIs
Organization: Straylight/Edgeware
From: Richard Kettlewell
---
doc/disobedience.1.in | 4 ++++
templates/help.html | 8 ++++++--
2 files changed, 10 insertions(+), 2 deletions(-)
diff --git a/doc/disobedience.1.in b/doc/disobedience.1.in
index 2c7ee78..6ac4202 100644
--- a/doc/disobedience.1.in
+++ b/doc/disobedience.1.in
@@ -258,6 +258,10 @@ The Tags field determine which tags apply to the track.
Tags are separated by commas and can contain any printing characters except
comma.
.PP
+The Weight field determines the track weight. Tracks with higher weights are
+proportionately more likely to be picked at random. The default weight is
+90000, and the maximum weight is 2147483647.
+.PP
The Random checkbox determines whether the track will be picked at random.
Random play is enabled for every track by default, but it can be turned off
here.
diff --git a/templates/help.html b/templates/help.html
index 3a55119..8e298ef 100644
--- a/templates/help.html
+++ b/templates/help.html
@@ -212,14 +212,18 @@ USA
rights, you may not be able to edit track preferences.
The form can be used to
- edit artist, album and title fields for the track as displayed, or
- to set the tags for a track, or to enable or disable random play
+ edit artist, album and title fields for the track as displayed; or
+ to set the tags or weight for a track; or to enable or disable random play
for the track.
Tags are separated by commas and can contain any other printing
characters (including spaces). Leading and trailing spaces are
not significant.
+ Weights determine how likely a track is to be picked at
+ random. Tracks with higher weights are more likely to be picked.
+ The default weight is 90000 and the maximum is 2147483647.
+
By default, any track can be picked for random play. The check
box at the bottom can be used to selectivel enable or disable it
for individual tracks.
--
[mdw]