X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=README.afs;h=d77f6bfa39a84fdb35304f1f55d4344d7160ba86;hp=e5c23a58cbc39787565cccd3f5084a1ac84daf76;hb=9ca92b91c68fb59989f317fea5e7c5e36cab7458;hpb=d36700894126811870ae0a0bcb5dbdb59588289c

diff --git a/README.afs b/README.afs
index e5c23a58..d77f6bfa 100644
--- a/README.afs
+++ b/README.afs
@@ -2,9 +2,13 @@ The audio file selector
 =======================
 
 Paraslash comes with a sophisticated audio file selector called afs.
-In the installation notes, only the "dummy" mode of afs was used which
-gets activated automatically if nothing else was specified. In this
-section the various features of afs are described.
+In the
+<<
+<a href="INSTALL.html">installation notes</a>,
+>>
+only the "dummy" mode of afs was used which gets activated automatically if
+nothing else was specified. In this section the various features of afs are
+described.
 
 ----------
 Attributes
@@ -146,21 +150,21 @@ special treatment:
 List of mood_methods
 ~~~~~~~~~~~~~~~~~~~~
 
-	no_attributes_set()
+	no_attributes_set
 
 Takes no arguments and matches an audio file if and only if no
 attributes are set.
 
-	played_rarely()
+	played_rarely
 
 Takes no arguments and matches all audio files where the number of
 times this audio file was selected is below the average.
 
-	is_set(attribute_name)
+	is_set attribute_name
 
 Takes the name of an attribute and matches iff that attribute is set.
 
-	path_matches(pattern)
+	path_matches pattern
 
 Takes a filename pattern and matches iff the path of the audio file
 matches the pattern.
@@ -219,12 +223,33 @@ songs is
 ---------
 Troubles?
 ---------
-If something went wrong, look at the output. If that does not give
-you a clue, use loglevel one (option -l 1 for most commands) to show
-debugging info. Almost all paraslash executables have a brief online
-help which is displayed by using the -h switch.
-
-Still not working? Mail the author Andre Noll <maan@systemlinux.org>
-(english, german, or spanish language). Please provide enough info
-such as the version of paraslash you are using and relevant parts of
-the logs.
+
+Use loglevel one (option -l 1 for most commands) to show debugging
+info. Almost all paraslash executables have a brief online help which
+is displayed by using the -h switch.
+
+para_fsck tries to fix your database. Use --force (even if your name
+isn't Luke), to clean up after a crash. However, first make sure
+para_server isn't running before executing para_fsck if para_fsck
+complains about busy (dirty) tables. para_fsck also contains an option
+to dump the contents of your the contents of the database to the file
+system.
+
+If you don't mind to recreate your database you can start
+from scratch by removing the entire database directory, i.e.
+
+	rm -rf ~/.paraslash/afs_database
+
+Note that this removes all tables, in particular attribute definitions
+and data, and all playlist and mood definitions.
+
+para_fsck operates on the osl-layer, i.e. it fixes inconsistencies
+in the database but doesn't know about the contents of the tables
+contained therein. Use
+
+	para_client check
+
+to print out bad entries, e.g.missing audio files or invalid mood
+definitions.
+
+Still having problems? mailto: Andre Noll <maan@systemlinux.org>