X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=README.afs;h=d77f6bfa39a84fdb35304f1f55d4344d7160ba86;hb=f03f1a8115c0b4dcb0a705d8a686ccf511648f60;hp=e627ca76b9ea7c6d748f38fe633c698e5b100241;hpb=e5e8648e4e4bd1edb1823dc932c96a7a271b27a4;p=paraslash.git
diff --git a/README.afs b/README.afs
index e627ca76..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
+<<
+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.
----------
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.
- name_like(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
-(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