setLayout -> initLayout (#977)

docs/form.rst

@@ -605,7 +605,7 @@ well as display of labels and structure around the fields themselves is not done
 but another object - "Form Layout". This object is responsible for the field flow, presence
 of labels etc.
 
-.. php:method:: setLayout(FormLayout\Generic $layout)
+.. php:method:: initLayout(FormLayout\Generic $layout)
 
     Sets a custom FormLayout object for a form. If not specified then form will automatically
     use FormLayout\Generic.

docs/render.rst

@@ -53,7 +53,7 @@ Late initialization
 When you create an application and select a Layout, the layout is automatically initialized::
 
     $app = new \atk4\ui\App();
-    $app->setLayout('Centered');
+    $app->initLayout('Centered');
 
     echo $app->layout->name; // present, because layout is initialized!
 

docs/view.rst

@@ -85,7 +85,7 @@ is executed it will be impossible to determine each view's position inside rende
     // Still not sure if finished adding
 
     $app = new \atk4\ui\App('My App');
-    $app->setLayout($top);
+    $app->initLayout($top);
 
     // Calls init() for all elements recursively.
 
@@ -94,7 +94,7 @@ child elements. To make your execution more straightforward we recommend you to
 App class first and then continue with Layout initialization::
 
     $app = new \atk4\ui\App('My App');
-    $top = $app->setLayout(new \atk4\ui\View(['ui'=>'segments']));
+    $top = $app->initLayout(new \atk4\ui\View(['ui'=>'segments']));
 
     $middle = $top->add(new \atk4\ui\View(['ui'=>'segment', 'red']);
 
@@ -103,7 +103,7 @@ App class first and then continue with Layout initialization::
 Finally, if you prefer a more consise code, you can also use the following format::
 
     $app = new \atk4\ui\App('My App');
-    $top = $app->setLayout('View', ['ui'=>'segments']);
+    $top = $app->initLayout('View', ['ui'=>'segments']);
 
     $middle = $top->add('View', ['ui'=>'segment', 'red']);
 

src/App.php

@@ -475,7 +475,8 @@ public function normalizeClassNameApp($name, $prefix = ''): ?string
     public function add($seed, $region = null)
     {
         if (!$this->layout) {
-            throw new Exception(['If you use $app->add() you should first call $app->setLayout()']);
+            throw (new Exception('App layout is missing'))
+                    ->addSolution('If you use $app->add() you should first call $app->initLayout()');
         }
 
         return $this->layout->add($seed, $region);

src/Form.php

@@ -57,7 +57,7 @@ class Form extends View //implements \ArrayAccess - temporarily so that our buil
 
     /**
      * Will point to the Save button. If you don't want to have save button, then set this to false
-     * or destroy it. Initialized by setLayout().
+     * or destroy it. Initialized by initLayout().
      *
      * @var Button|array|false Button object, seed or false to not show button at all
      */