X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=m4%2Flls%2Fserver_cmd.suite.m4;h=b113934164315741699cc3f119f122d0c34cb8c2;hp=0585b5e2acfd85ef6f61f710123cf6e283a51eb8;hb=f57f71019a272c7e5a29a10da55a8ef2bed5de71;hpb=1709cc8f8a54429441f8f83c38146e667133c727

diff --git a/m4/lls/server_cmd.suite.m4 b/m4/lls/server_cmd.suite.m4
index 0585b5e2..b1139341 100644
--- a/m4/lls/server_cmd.suite.m4
+++ b/m4/lls/server_cmd.suite.m4
@@ -13,6 +13,45 @@ aux_info_prefix = Permissions:
 	granted to the user.
 [/introduction]
 
+[subcommand add]
+	purpose = add or update audio files
+	non-opts-name = path...
+	aux_info = AFS_READ | AFS_WRITE
+	[description]
+		Each path must be absolute and refer to either an audio file or a
+		directory. In case of a directory, all audio files in that directory
+		are added recursively. Note that the given paths refer to files or
+		directories on the host on which para_server is running.
+	[/description]
+	[option all]
+		short_opt = a
+		summary = add all files
+		[help]
+			The default is to add only files ending in a known suffix for a
+			supported audio format.
+		[/help]
+	[option lazy]
+		short_opt = l
+		summary = add files lazily
+		[help]
+			If the path already exists in the database, skip this file. This
+			operation is really cheap. Useful to update large directories after
+			some files have been added.
+		[/help]
+	[option force]
+		short_opt = f
+		summary = force adding/updating
+		[help]
+			Recompute the audio format handler data even if a file with the same
+			path and the same hash value exists.
+		[/help]
+	[option verbose]
+		short_opt = v
+		summary = enable verbose mode
+		[help]
+			Print what is being done.
+		[/help]
+
 [subcommand ff]
 	purpose = jump N seconds forward or backward
 	synopsis = n[-]
@@ -48,6 +87,16 @@ aux_info_prefix = Permissions:
 		to the server process has the same effect as running this command.
 	[/description]
 
+[subcommand init]
+	purpose = initialize the database tables for the audio file selector
+	synopsis = [table_name...]
+	aux_info = AFS_READ | AFS_WRITE
+	[description]
+		When invoked without arguments, this command creates all
+		tables: audio_files, attributes, scores, moods, lyrics, images,
+		playlists. Otherwise only the given tables are created.
+	[/description]
+
 [subcommand jmp]
 	purpose = reposition the current stream
 	non-opts-name = n
@@ -58,6 +107,35 @@ aux_info_prefix = Permissions:
 		n <= 100.
 	[/description]
 
+[subcommand lsatt]
+	purpose = list attributes
+	aux_info = AFS_READ
+	[description]
+		Print the list of all defined attributes which match the given
+		pattern. If no pattern is given, the full list is printed.
+	[/description]
+
+	[option id-sort]
+		short_opt = i
+		summary = sort attributes by id
+		[help]
+			The default is to sort alphabetically by name.
+
+			Attributes are internally represented as an 64 bit array. The attribute
+			id is the bit number in this array.
+		[/help]
+	[option long]
+		short_opt = l
+		summary = print long listing
+		[help]
+			The long listing prints the attribute id in addition to the name of
+			the attribute. The id is printed as a decimal number and is separated
+			from the name by a tab character.
+		[/help]
+	[option reverse]
+		short_opt = r
+		summary = reverse sort order
+
 [subcommand next]
 	purpose = close the stream and start to stream the next audio file
 	aux_info = VSS_READ | VSS_WRITE
@@ -115,6 +193,20 @@ aux_info_prefix = Permissions:
 
 	[/description]
 
+[subcommand setatt]
+	purpose = set or unset attributes
+	synopsis = attribute{+|-}... pattern...
+	aux_info = AFS_READ | AFS_WRITE
+	[description]
+		Set ('+') or unset ('-') the given attributes for all audio files
+		matching the given pattern. Example:
+
+			setatt rock+ punk+ pop- '*foo.mp3'
+
+		sets the 'rock' and the 'punk' attribute and unsets the 'pop' attribute
+		of all files ending with 'foo.mp3'.
+	[/description]
+
 [subcommand si]
 	purpose = print server info
 	aux_info = NO_PERMISSION_REQUIRED