From: Richard Kettlewell
Date: Sat, 12 Apr 2008 14:00:19 +0000 (+0100)
Subject: Document appearance of weight in UIs
X-Git-Tag: 4.0~121
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/commitdiff_plain/68a1bff0084d623f3ba9ec3b2f56774b6c00d58b?ds=inline
Document appearance of weight in UIs
---
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.