Merge pull request #3435 from vivien/i3-msg/subscribe

[i3/i3] / PACKAGE-MAINTAINER

diff --git a/PACKAGE-MAINTAINER b/PACKAGE-MAINTAINER
index 40222803800dd7c49eee1d475eeb9eb9b4b78949..953fac5390c7e02b68fd417d5d9076a2d9c6ed1a 100644 (file)
--- a/PACKAGE-MAINTAINER
+++ b/PACKAGE-MAINTAINER
@@ -10,22 +10,35 @@ packages for them.
 Please make sure the manpage for i3 will be properly created and installed
 in your package.
 
 Please make sure the manpage for i3 will be properly created and installed
 in your package.
 

-On debian, this looks like this:
-
-       # Compilation
-       $(MAKE)
-       $(MAKE) -C man
-
-       # Installation
-       $(MAKE) DESTDIR=$(CURDIR)/debian/i3-wm/ install
-       mkdir -p $(CURDIR)/debian/i3-wm/usr/share/man/man1
-       cp man/i3.1 $(CURDIR)/debian/i3-wm/usr/share/man/man1
+Please check the i3-sensible-{editor,pager,terminal} scripts and modify them if
+necessary. The former two provide fallbacks in case $PAGER or $EDITOR is not
+set (which might be more common than you think, because they have to be set in
+~/.xsession, not in the shell configuration!) while the latter tries to launch
+a terminal emulator. The scripts are most prominently used in i3-nagbar, which
+alerts the user when the configuration is broken for some reason. Also,
+i3-sensible-terminal is used in the default configuration.
+
+If your distribution has a mechanism to get the preferred terminal, such as the
+x-terminal-emulator symlink in Debian, please use it in i3-sensible-terminal.
+
+On debian, compilation and installing the manpages looks like this:
+
+       autoreconf -fi
+       mkdir -p build && cd build
+       ../configure
+       make -j8 install
+
+Please make sure that i3-migrate-config-to-v4 and i3-config-wizard are
+installed with i3. The Perl script is necessary to (automatically) convert v3
+configs to v4. The wizard provides the possibility to create a keysym-based
+config with the user’s preferred modifier and should be started on the first
+start of i3 (it will automatically exit if it finds a config file).

 
 If you have any questions, ideas, hints, problems or whatever, please do not
 hesitate to contact me. I will help you out. Just drop me an E-Mail (find the
 
 If you have any questions, ideas, hints, problems or whatever, please do not
 hesitate to contact me. I will help you out. Just drop me an E-Mail (find the

-address at http://michael.stapelberg.de/Kontakt, scroll down to bottom),
+address at https://michael.stapelberg.de/Impressum/, scroll down to bottom),

 contact me using the same address in jabber or ask on our IRC channel:
 contact me using the same address in jabber or ask on our IRC channel:

-(#i3 on irc.twice-irc.de).
+(#i3 on irc.freenode.net).

 
 Thanks again for your efforts,
 Michael
 
 Thanks again for your efforts,
 Michael