Documentation update for 0.11.0

git-svn-id: https://svn.musicpd.org/ncmpc/trunk@1745 09075e82-0dd4-0310-85a5-a0d7c8717e4f

7 files changed, 145 insertions, 35 deletions

diff --git a/ChangeLog b/ChangeLog
index 968b1ff06..0a1d27499 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,33 @@
+2004-06-29 Kalle Wallin <kaw@linux.se>
+	* command.h: added flags to command_definition_t.
+	* command.c: only save keys with a COMMAND_KEY_MODIFIED flag
+	  (dont write all key bindings when saving ~/.ncmpc/keys)
+	* screen_keydef.c: highlight conflicting key bindings
+	* libmpdclient: updated to r1513
+
+2004-06-24 Kalle Wallin <kaw@linux.se>
+	* Added configuraton option set-xterm-title xterm-title-format,
+	  the xterm title can now include song information
+
+2004-06-22 Kalle Wallin <kaw@linux.se>
+	* Added configuraton options audible-bell, visible-bell, wrap-around,
+	  find-wrap
+	* screen_utils.c: added screen_bell() for audible/visible bells
+	* list_window.c: add optional wrapped movement 
+	* ncmpc.h: Make shure the dummy debug macro survives the OSX 
+	  preprocessor
+	* command.c: Changed key bindings: Ctrl-K=move-up, Ctrl-J=move-down,
+	  Ctrl-L=update
+	* Made shure the screen is repainted on CMD_SCREEN_UPDATE
+	
+
+2004-06-17 Kalle Wallin <kaw@linux.se>
+	* screen_file.c: let mpd add directories (just send the path)
+	* main.c: only set xterm title if DEBUG is defined
+	* mpdclient.[c|h]: added _utf8 suffix to all functions that take utf8 
+	                   arguments.
+	* command.c: Support cursor/down with j and k
+	
 2004-06-17 Kalle Wallin <kaw@linux.se>
 	* screen_utils.c: fixed the display of completion lists
 	* wreadln.c: try to complete even if the line is empty
diff --git a/NEWS b/NEWS
index bb56a46cd..43ebcfb6c 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,36 @@
+ncmpc-0.11.0
+
+ + the default port is now 6600 (mpd-0.11.0)
+ + nls support (glib-2.4 required for nls)
+ + ncmpc now uses the terminal in raw mode (enabling key bindings to Ctrl-C...)
+ + changed key bindings:
+	o cursor movement up/down with j and k (used to be . and ,)
+	o the update/redraw command is now executed with Ctrl-L (used to be u) 
+ + new ncmpc commands:
+	o move a playlist entry up/down with Ctrl-K, Ctrl-J (playlist screen)
+	o add a song/url with a (playlist screen)
+	o support for MPD db updates with Ctrl-U 
+ + new command line options --config=FILE and --key-file=FILE
+ + configuration changes:
+	o replaced '_' with '-' in configuration field names
+	o the color support in ncmpc have been redesigned - more colors and 
+	  color fields
+	o the display of song names can now be customized (list-format, 
+	  status-format, xterm-title-format)
+	o ncmpc no longer changes the xterm title by default (set-xterm-title)
+	o new option for default find mode (find-wrap)
+	o new option for cplay like cursor movement (wrap-around)
+	o alert bells can be customized (audible-bell,visible-bell)
+	o the wide cursor is now enabled by default (wide-cursor)
+	o view the sample configuration file or the manual page for details 
+ + ncmpc now scrolls long song names on the status line
+ + ncmpc now have a new build in line editor with completion and history
+ + ncmpc now remembers the cursor position when changing directories
+ + ncmpc now offers to overwrite when saving playlists
+ + ncmpc now have an optional clock screen
+ + ncmpc now updates the local playlists via MPD's plchanges command...
+ 
+
 
 ncmpc-0.10.1 
 
diff --git a/README b/README
index 9a618c97f..afdaa3058 100644
--- a/README
+++ b/README
@@ -1,18 +1,66 @@
-ncmpc is a ncurses client for MPD, the Music Player Daemon with an
-interface is inspired by cplay (by Ulf Betlehem).  
 
-The client connects to a MPD running on a machine on the local network.
-By default,  ncmpc  connects  to  localhost:6600.   This  can  be
+Overview
+------------------------------------------------------------------------------
+ncmpc is a curses client for the Music Player Daemon (MPD). ncmpc connects to 
+a MPD running on a machine on the local network, and controls this with an 
+interface inspired by cplay. 
+
+Music Player Daemon (MPD) allows remote access for playing music (MP3, 
+Ogg Vorbis, FLAC, AAC, and wave files) and managing playlists. MPD is 
+designed for integrating a computer into a stereo system that provides 
+control for music playback over a local network. Read more at musicpd.org
+
+
+
+How to compile and install ncmpc
+-------------------------------------------------------------------------------
+Download the ncmpc source code, then:
+	$ tar zxvf ncmpc-x.y.z.tar.gz
+	$ cd ncmpc-x.y.z
+	$ ./configure
+	$  make
+	$  make install
+
+
+
+Upgrading to ncmpc-0.11.0 
+------------------------------------------------------------------------------
+The syntax for the configuration file (~/.ncmpc/config) has changed, view the
+manual page or the sample configuration file for details.
+
+The old key binding to the select command (space,a) will result in a 
+conflict as the a key is used for the new add command in 0.11.0. The easy 
+solution is to delete your old key bindings (~/.ncmpc/keys), but you can use 
+the built in key editor to solve any key conflicts.
+
+
+
+Usage
+-------------------------------------------------------------------------------
+ncmpc connects to a MPD running on a machine on the local network. 
+By default, ncmpc  connects  to  localhost:6600.   This  can  be
 changed  either  at  compile-time,  or  by  exporting  the MPD_HOST and
 MPD_PORT environment variables, or by the command line  options  --host
 and --port.
 
 	$ ncmpc --host=musicserver --port=44000
 
+For more information please view ncmpc's manual page.
+
+
+
+
+Web Page, Forums and Bug Reports
+-------------------------------------------------------------------------------
+	* Read more about ncmpc & MPD on http://www.musicpd.org
+	* a ncmpc forum exists at musicpd.org - http://www.musicpd.org/forum
+	* report bugs at musicpd.org - http://www.musicpd.org/mantis/
+
 
-Read more about MPD on http://www.musicpd.org
 
 
+-------------------------------------------------------------------------------
+$Id$
 
 
 
diff --git a/TODO b/TODO
index c0c3ae856..0d833b8b1 100644
--- a/TODO
+++ b/TODO
@@ -1,13 +1,12 @@
 
 Features:
+* remote playlists 
 * search screen
 * id3 browser
 
 Other:
 * Remove popt dependency
-* A cleanup would be nice
-
-*** Cleanup mpc.c !!!
+* Add libgpm support?
 
 
 
diff --git a/doc/ncmpc.lirc b/doc/ncmpc.lirc
index 409b95182..ee77a8f0a 100644
--- a/doc/ncmpc.lirc
+++ b/doc/ncmpc.lirc
@@ -1,5 +1,5 @@
 #
-# Sample .lirc file for usage with irpty and ncmcp
+# Sample .lirc file for usage with irpty and ncmpc
 # 
 # $ irpty ./ncmpc.lirc -- ncmcp 
 # 
@@ -94,7 +94,7 @@ begin
 	button = CD_2
 	prog   = irpty
 	repeat = 2
-	config = ,
+	config = k
 end
 
 # move: Down
@@ -103,7 +103,7 @@ begin
 	button = CD_8
 	prog   = irpty
 	repeat = 2
-	config = .
+	config = j
 end
 
 # move: Center (update)
diff --git a/po/ncmpc.pot b/po/ncmpc.pot
index 2ac84f474..fa65e3964 100644
--- a/po/ncmpc.pot
+++ b/po/ncmpc.pot
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2004-06-24 21:17+0200\n"
+"POT-Creation-Date: 2004-06-30 14:22+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -155,7 +155,7 @@ msgstr ""
 msgid "Replace %s [%s/%s] ? "
 msgstr ""
 
-#: src/screen_play.c:195 src/screen_file.c:317 src/screen_keydef.c:159
+#: src/screen_play.c:195 src/screen_file.c:317 src/screen_keydef.c:161
 msgid "Aborted!"
 msgstr ""
 
@@ -255,39 +255,39 @@ msgstr ""
 msgid "Deleted"
 msgstr ""
 
-#: src/screen_keydef.c:153
+#: src/screen_keydef.c:155
 #, c-format
 msgid "Enter new key for %s: "
 msgstr ""
 
-#: src/screen_keydef.c:165
+#: src/screen_keydef.c:167
 #, c-format
 msgid "Error: key %s is already used for %s"
 msgstr ""
 
-#: src/screen_keydef.c:172
+#: src/screen_keydef.c:176
 #, c-format
 msgid "Assigned %s to %s"
 msgstr ""
 
-#: src/screen_keydef.c:208
+#: src/screen_keydef.c:219
 #, c-format
 msgid "%d. Add new key "
 msgstr ""
 
-#: src/screen_keydef.c:255
+#: src/screen_keydef.c:266
 msgid "Welcome to the key editor!"
 msgstr ""
 
-#: src/screen_keydef.c:271
+#: src/screen_keydef.c:282
 msgid "Note: Did you forget to 'Apply' your changes?"
 msgstr ""
 
-#: src/screen_keydef.c:278
+#: src/screen_keydef.c:289
 msgid "Edit key bindings"
 msgstr ""
 
-#: src/screen_keydef.c:280
+#: src/screen_keydef.c:291
 #, c-format
 msgid "Edit keys for %s"
 msgstr ""
@@ -572,12 +572,12 @@ msgstr ""
 msgid "Insert"
 msgstr ""
 
-#: src/command.c:427
+#: src/command.c:456
 #, c-format
 msgid "Key %s assigned to %s and %s (press %s for the key editor)"
 msgstr ""
 
-#: src/command.c:434 src/command.c:441
+#: src/command.c:463 src/command.c:470
 #, c-format
 msgid "Error: Key %s assigned to %s and %s !!!\n"
 msgstr ""
diff --git a/po/sv.po b/po/sv.po
index a211eeea6..bf4e12bba 100644
--- a/po/sv.po
+++ b/po/sv.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: ncmpc 0.11.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2004-06-24 21:17+0200\n"
+"POT-Creation-Date: 2004-06-30 14:22+0200\n"
 "PO-Revision-Date: 2004-06-05 18:16+0200\n"
 "Last-Translator: Kalle Wallin <kaw@linux.se>\n"
 "Language-Team: sv <sv@li.org>\n"
@@ -155,7 +155,7 @@ msgstr "Spara spellistan som: "
 msgid "Replace %s [%s/%s] ? "
 msgstr "Ersätt '%s' [%s/%s] ? "
 
-#: src/screen_play.c:195 src/screen_file.c:317 src/screen_keydef.c:159
+#: src/screen_play.c:195 src/screen_file.c:317 src/screen_keydef.c:161
 msgid "Aborted!"
 msgstr "Avbröt!"
 
@@ -255,39 +255,39 @@ msgstr "Sparade %s"
 msgid "Deleted"
 msgstr "Raderad"
 
-#: src/screen_keydef.c:153
+#: src/screen_keydef.c:155
 #, c-format
 msgid "Enter new key for %s: "
 msgstr "Ny tangent för %s: "
 
-#: src/screen_keydef.c:165
+#: src/screen_keydef.c:167
 #, c-format
 msgid "Error: key %s is already used for %s"
 msgstr "Tangenten %s används redan för %s"
 
-#: src/screen_keydef.c:172
+#: src/screen_keydef.c:176
 #, c-format
 msgid "Assigned %s to %s"
 msgstr "%s = %s"
 
-#: src/screen_keydef.c:208
+#: src/screen_keydef.c:219
 #, c-format
 msgid "%d. Add new key "
 msgstr "%d. Lägg till ny tangent"
 
-#: src/screen_keydef.c:255
+#: src/screen_keydef.c:266
 msgid "Welcome to the key editor!"
 msgstr "Här kan du ändra tangentdefinitioner"
 
-#: src/screen_keydef.c:271
+#: src/screen_keydef.c:282
 msgid "Note: Did you forget to 'Apply' your changes?"
 msgstr "OBS! Du glömde väl inte att Verkställa?"
 
-#: src/screen_keydef.c:278
+#: src/screen_keydef.c:289
 msgid "Edit key bindings"
 msgstr "Ändra tangentdefinitioner"
 
-#: src/screen_keydef.c:280
+#: src/screen_keydef.c:291
 #, c-format
 msgid "Edit keys for %s"
 msgstr "Ändra tangenter för kommandot '%s'"
@@ -572,12 +572,12 @@ msgstr ""
 msgid "Insert"
 msgstr "Ins"
 
-#: src/command.c:427
+#: src/command.c:456
 #, c-format
 msgid "Key %s assigned to %s and %s (press %s for the key editor)"
 msgstr "%s tilldelat kommandona %s och %s (tryck på %s och korrigera)"
 
-#: src/command.c:434 src/command.c:441
+#: src/command.c:463 src/command.c:470
 #, c-format
 msgid "Error: Key %s assigned to %s and %s !!!\n"
 msgstr "Fel: Tangenten %s är tilldelad både %s och %s !!!\n"