Use libsamplerate in disorder-normalize, if available. If it's not

[disorder] / README.reload

diff --git a/README.reload b/README.reload
index 66d74a8e996cf51a9ee32eebc504eb155a70242c..f9fa4c7ad24a0e04089259e812fa2521f9189957 100644 (file)
--- a/README.reload
+++ b/README.reload
@@ -5,51 +5,59 @@ This is current rather vaguely defined and implemented.  This file
 will lay out what you can and cannot change over a reconfigure.  Any
 other changes will require a full server restart.
 
 will lay out what you can and cannot change over a reconfigure.  Any
 other changes will require a full server restart.
 

-I intend to improve the situation, but for now this is how it is.
+The situation is gradually improving; this file tracks the current
+state.

 
 * Options that might have to remain the same across restart
 
 Arguably if there is anything in this section then that's a serious
 bug!
 
 
 * Options that might have to remain the same across restart
 
 Arguably if there is anything in this section then that's a serious
 bug!
 

-** alias
+** alias (enforced at reload only)

 
 This defines how aliases are inserted into the track database.  Need
 to think about how changing it will affect things.
 
 
 This defines how aliases are inserted into the track database.  Need
 to think about how changing it will affect things.
 

-** namepart
+** namepart (enforced at reload only)

 
 Probably affects alias construction.
 
 
 Probably affects alias construction.
 

-** stopword
+** stopword (enforced at reload only)

 
 

-The search database will have to be rebuilt from scratch.  This is
-do-able but AFAIK we don't detect it.
+The search database will have to be rebuilt from scratch.

 
 

-** user
+** user (enforced at reload only)

 
 All the files will be owned by the wrong user!
 
 
 All the files will be owned by the wrong user!
 

+** Alias, search database, etc
+
+Rescan can regenerate aliases and the search and tag databases but we
+rather assume that they are either empty or good.  Therefore we need
+to store anything that can affect these values and erase them if they
+change.
+
+The solution is a global pref _dbparams which contains the hash of the
+alias, stopword and namepart data.
+

 * Options that must remain the same across reload
 
 Some things will just require a restart.  We should either enforce
 this (refusing to accept modified configurations that purport to
 change them) or explicitly ignore it.
 
 * Options that must remain the same across reload
 
 Some things will just require a restart.  We should either enforce
 this (refusing to accept modified configurations that purport to
 change them) or explicitly ignore it.
 

-** home
+** home (enforced at reload)

 
 

-We absolutely cannot accept changing our state directory.  If this is
-attempted it must be rejected.
+We absolutely cannot accept changing our state directory.

 
 

-** lock
+** lock (generates a deprecation warning)

 
 Liable to be removed anyway.
 
 
 Liable to be removed anyway.
 

-** nice_speaker
+** nice_speaker (generates a warning)

 
 

-Can't renice a running speaker to make it less nice (and we don't try
-to make it more nice).  We ought to issue an error message and
-otherwise ignore.
+You can't renice a running speaker to make it less nice (and we don't
+try to make it more nice).

 
 * Options that ought to be changable across reload but aren't
 
 
 * Options that ought to be changable across reload but aren't