add a manpage for i3-migrate-config-to-v4

man/Makefile

@@ -1,6 +1,6 @@
 A2M:=a2x -f manpage --asciidoc-opts="-f asciidoc.conf"
 
-all: i3.1 i3-msg.1 i3-input.1 i3-nagbar.1 i3-wsbar.1 i3-config-wizard.1
+all: i3.1 i3-msg.1 i3-input.1 i3-nagbar.1 i3-wsbar.1 i3-config-wizard.1 i3-migrate-config-to-v4.1
 
 %.1: %.man asciidoc.conf
 	${A2M} $<
@@ -9,7 +9,7 @@ i3-wsbar.1: ../i3-wsbar
 	pod2man $^ > $@
 
 clean:
-	for file in $$(echo i3 i3-msg i3-input i3-nagbar i3-wsbar i3-config-wizard); \
+	for file in $$(echo i3 i3-msg i3-input i3-nagbar i3-wsbar i3-config-wizard i3-migrate-config-to-v4); \
 	do \
 		rm -f $${file}.1 $${file}.html $${file}.xml; \
 	done

man/i3-migrate-config-to-v4.man

@@ -0,0 +1,34 @@
+i3-migrate-config-to-v4(1)
+==========================
+Michael Stapelberg <michael+i3@stapelberg.de>
+v4.0, July 2011
+
+== NAME
+
+i3-migrate-config-to-v4 - migrates your i3 config file
+
+== SYNOPSIS
+
+-------------------------------------------------------
+mv ~/.i3/config ~/.i3/old.config
+i3-migrate-config-to-v4 ~/.i3/old.config > ~/.i3/config
+-------------------------------------------------------
+
+== DESCRIPTION
+
+i3-migrate-config-to-v4 is a Perl script which migrates your old (< version 4)
+configuration files to a version 4 config file. The most significant changes
+are the new commands (see the release notes).
+
+This script will automatically be run by i3 when it detects an old config file.
+Please migrate your config file as soon as possible. We plan to include this
+script in all i3 release until 2012-08-01. Afterwards, old config files will no
+longer be supported.
+
+== SEE ALSO
+
+i3(1)
+
+== AUTHOR
+
+Michael Stapelberg and contributors