add boilerplate to all testcases with documentation references

[i3/i3] / testcases / t / 156-fullscreen-focus.t

diff --git a/testcases/t/156-fullscreen-focus.t b/testcases/t/156-fullscreen-focus.t
index af205c45732ffa5a5b33ecae78136bd97103e095..29a410d2295c6aa61fe3115141431cb92a4b6048 100644 (file)
--- a/testcases/t/156-fullscreen-focus.t
+++ b/testcases/t/156-fullscreen-focus.t
@@ -1,6 +1,19 @@
 #!perl
 # vim:ts=4:sw=4:expandtab
 #
+# Please read the following documents before working on tests:
+# • http://build.i3wm.org/docs/testsuite.html
+#   (or docs/testsuite)
+#
+# • http://build.i3wm.org/docs/lib-i3test.html
+#   (alternatively: perldoc ./testcases/lib/i3test.pm)
+#
+# • http://build.i3wm.org/docs/ipc.html
+#   (or docs/ipc)
+#
+# • http://onyxneon.com/books/modern_perl/modern_perl_a4.pdf
+#   (unless you are already familiar with Perl)
+#
 # Test if new containers get focused when there is a fullscreen container at
 # the time of launching the new one. Also make sure that focusing containers
 # in other workspaces work even when there is a fullscreen container.
@@ -237,22 +250,59 @@ is($x->input_focus, $right22->id, 'focus did not leave parent container (4)');
 # Ensure that moving in a direction doesn't violate the focus restrictions.
 ################################################################################
 
-sub verify_move_prevented {
+sub verify_move {
+    my $num = shift;
     my $msg = shift;
     my $nodes = get_ws_content($tmp2);
     my $split = $nodes->[1];
     my $fs = $split->{nodes}->[1];
-    is(scalar @{$fs->{nodes}}, 2, $msg);
+    is(scalar @{$fs->{nodes}}, $num, $msg);
 }
 
 cmd 'move left';
-verify_move_prevented('prevented move left');
+verify_move(2, 'prevented move left');
 cmd 'move right';
-verify_move_prevented('prevented move right');
+verify_move(2, 'prevented move right');
 cmd 'move down';
-verify_move_prevented('prevented move down');
+verify_move(2, 'prevented move down');
 cmd 'move up';
 cmd 'move up';
-verify_move_prevented('prevented move up');
+verify_move(2, 'prevented move up');
+
+################################################################################
+# Moving to a different workspace is allowed with per-output fullscreen
+# containers.
+################################################################################
+
+cmd "move to workspace $tmp";
+verify_move(1, 'did not prevent move to workspace by name');
+
+cmd "workspace $tmp";
+cmd "move to workspace $tmp2";
+cmd "workspace $tmp2";
+
+cmd "move to workspace prev";
+verify_move(1, 'did not prevent move to workspace by position');
+
+################################################################################
+# Ensure that is not allowed with global fullscreen containers.
+################################################################################
+
+cmd "workspace $tmp";
+cmd "move to workspace $tmp2";
+cmd "workspace $tmp2";
+
+cmd 'focus parent';
+cmd 'fullscreen';
+cmd 'fullscreen global';
+cmd 'focus child';
+
+cmd "move to workspace $tmp";
+verify_move(2, 'prevented move to workspace by name');
+
+cmd "move to workspace prev";
+verify_move(2, 'prevented move to workspace by position');
+
+# TODO: Tests for "move to output" and "move workspace to output".
 
 done_testing;