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
 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.
 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
     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>
 
     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>
     <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>