Document appearance of weight in UIs

diff --git a/doc/disobedience.1.in b/doc/disobedience.1.in
index 2c7ee789c1e04157be99f1b259dc6b8e76776be2..6ac4202442246d0fbe5372ae4810c7189dfe9551 100644 (file)
--- 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 3a5511907cfc5b7630e9665b9f338d2c73236d0e..8e298efbbd387dc019aa65115bc67ccb819ebb47 100644 (file)
--- a/templates/help.html
+++ b/templates/help.html
@@ -212,14 +212,18 @@ USA
     rights, you may not be able to edit track preferences.</p>
     
     <p>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.</p>
 
     <p>Tags are separated by commas and can contain any other printing
     characters (including spaces).  Leading and trailing spaces are
     not significant.</p>
 
+    <p>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.</p>
+
     <p>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.</p>