more common way of handling example config files (like in ncmpc) + add a few

more functions to libmpdclient implementation

doc/ncmpcpp_keys

@@ -0,0 +1,107 @@
+#####################################################
+## this is example key configuration file, copy it ##
+## to ~/.ncmpcpp_keys and set up your preferences  ##
+#####################################################
+##
+## Tips:
+## - it's possible to bind maximum two keys to a command
+## - keys can be defined with a character or a decimal value
+## - a command can be disabled by binding it to 0
+##
+## Note: First bind of volume_up/down
+## will be used to switch between columns
+## on media library screen.
+##
+#
+#key_up = 259 'k'
+#
+#key_down = 258 'j'
+#
+#key_page_up = 339
+#
+#key_page_down = 338
+#
+#key_home = 262
+#
+#key_end = 360
+#
+#key_space = 32
+#
+#key_enter = 10
+#
+#key_delete = 330 'd'
+#
+#key_volume_up = 261 '+'
+#
+#key_volume_down = 260 '-'
+#
+#key_screen_switcher = 9
+#
+#key_help = '1' 265
+#
+#key_playlist = '2' 266
+#
+#key_browser = '3' 267
+#
+#key_search_engine = '4' 268
+#
+#key_media_library = '5' 269
+#
+#key_stop = 's'
+#
+#key_pause = 'P'
+#
+#key_next = '>'
+#
+#key_prev = '<'
+#
+#key_seek_forward = 'f'
+#
+#key_seek_backward = 'b'
+#
+#key_toggle_repeat = 'r'
+#
+#key_toggle_random = 'z'
+#
+#key_shuffle = 'Z'
+#
+#key_toggle_crossfade = 'x'
+#
+#key_set_crossfade = 'X'
+#
+#key_update_db = 'u'
+#
+#key_find_forward = '/'
+#
+#key_find_backward = '?'
+#
+#key_next_found_position = '.'
+#
+#key_prev_found_position = ','
+#
+#key_edit_tags = 'e'
+#
+#key_go_to_position = 'g'
+#
+#key_lyrics = 'l'
+#
+#key_clear = 'c'
+#
+#key_crop = 'C'
+#
+#key_move_song_up = 'm'
+#
+#key_move_song_down = 'n'
+#
+#key_add = 'a'
+#
+#key_save_playlist = 'S'
+#
+#key_go_to_now_playing = 'o'
+#
+#key_toggle_auto_center = 'U'
+#
+#key_go_to_parent_dir = 263 127
+#
+#key_quit = 'q' 'Q'
+#

doc/ncmpcpprc

@@ -0,0 +1,106 @@
+#################################################
+## this is example configuration file, copy it ##
+## to ~/.ncmpcpprc and set up your preferences ##
+#################################################
+#
+##### connection settings #####
+#
+## set it in order to make tag editor work
+#
+#mpd_music_dir = "/var/lib/mpd/music"
+#
+#mpd_connection_timeout = "5"
+#
+#mpd_crossfade_time = "5"
+#
+##### delays #####
+#
+## delay after playlist highlighting will be disabled (0 = don't disable)
+#
+#playlist_disable_highlight_delay = "5"
+#
+## defines how long various messages are supposed to be visible
+#
+#message_delay_time = "4"
+#
+##### song format #####
+##
+## for song format you can use:
+##
+## %l - length
+## %f - short filename
+## %F - full filename
+## %a - artist
+## %t - title
+## %b - album
+## %y - year
+## %n - track number
+## %g - genre
+## %c - composer
+## %p - performer
+## %d - disc
+## %C - comment
+##
+## you can also put them in { } and then it will be displayed
+## only if all requested values are available and/or define alternate
+## value with { }|{ } eg. {%a - %t}|{%f}
+##
+## text can also have different color than the main window has,
+## eg. if you want length to have other color, write [color]%t[/color]
+##
+## available colors:
+##
+## - black
+## - red
+## - green
+## - yellow
+## - blue
+## - magenta
+## - cyan
+## - white
+##
+#
+#song_list_format = "{[green](%l)[/green] }{%a - }{%t}|{[white]%f[/white]}"
+#
+#song_status_format = "{(%l) }{%a - }{%t}|{%f}"
+#
+#song_window_title_format = "{%a - }{%t}|{%f}"
+#
+#song_library_format = "{%n - }{%t}|{%f}"
+#
+#browser_playlist_prefix = "[red]playlist[/red] "
+#
+##### interface settings #####
+#
+#autocenter_mode = "no"
+#
+#header_visibility = "yes"
+#
+#statusbar_visibility = "yes"
+#
+#enable_window_title = "yes"
+#
+##### colors definitions #####
+#
+#colors_enabled = "yes"
+#
+#empty_tag_color = "cyan"
+#
+#header_window_color = "default"
+#
+#volume_color = "default"
+#
+#state_line_color = "default"
+#
+#state_flags_color = "default"
+#
+#main_window_color = "yellow"
+#
+#main_window_highlight_color = "yellow"
+#
+#progressbar_color = "default"
+#
+#statusbar_color = "default"
+#
+#library_active_column_color = "red"
+#