DOC:Guide2 add to customize section in Kivybasics

doc/sources/guide2/basic.rst

@@ -156,13 +156,95 @@ To run the application, follow the instructions for your operating system:
 A window should open, showing a sole button (with the label 'Hello World') that
 covers the entire window's area. That's all there is to it.
 
-.. image:: ../guide/images/quickstart.jpg
+.. image:: ../guide2/images/quickstart.png
     :align: center
 
 
 Customize the application
 -------------------------
 
+Lets extend this Application a bit, say a simple UserName/Password page
+
+.. code-block:: python
+   :emphasize-lines: 2,4,7,9-17,23
+   :linenos:
+
+    from kivy.app import App
+    from kivy.uix.gridlayout import GridLayout
+    from kivy.uix.label import Label
+    from kivy.uix.textinput import TextInput
+    
+    
+    class LoginScreen(GridLayout):
+    
+        def __init__(self, **kwargs):
+            super(LoginScreen, self).__init__(**kwargs)
+            self.cols = 2
+            self.add_widget(Label(text='User Name'))
+            self.username = TextInput(multiline=False)
+            self.add_widget(self.username)
+            self.add_widget(Label(text='password'))
+            self.password = TextInput(password=True, multiline=False)
+            self.add_widget(self.password)
+    
+    
+    class MyApp(App):
+
+        def build(self):
+            return LoginScreen()
+    
+    
+    if __name__ == '__main__':
+        MyApp().run()
+
+At line 2 we import a :class:`~kivy.uix.gridlayout.Gridlayout`::
+
+    from kivy.uix.gridlayout import GridLayout
+
+This class is used as a Base for our Root Widget (LoginScreen) defined
+at line 7::
+
+    class LoginScreen(GridLayout):
+
+at line 9 in the class LoginScreen we overload the method
+:meth:`~kivy.widget.Widget.__init__` so as to add wdgets and to defines its
+behaviour::
+
+    def __init__(self, **kwargs):
+            super(LoginScreen, self).__init__(**kwargs)
+
+One must not forget to either call super or implement the functionality of the
+original function being overloaded. Also note that it is good practice not to
+omit the `**kwargs` while calling super, as they are used internally some times.
+
+Moving on to Line 12 onwards::
+
+    self.cols = 2
+    self.add_widget(Label(text='User Name'))
+    self.username = TextInput(multiline=False)
+    self.add_widget(self.username)
+    self.add_widget(Label(text='password'))
+    self.password = TextInput(password=True, multiline=False)
+    self.add_widget(self.password)
+
+We ask the Gridlayout to manage it's children in two columns and add a
+:class:`~kivy.uix.label.Label` and a :class:`~kivy.uix.textinput.TextInput` each
+for username and passowrd.
+
+Running the above code will give you a window that should look like this
+
+.. image:: ../guide2/images/guide2_customize_step1.png
+   :align: center
+
+Try re-sizing the window, you will see that the widgets on screen adjust
+themselves according to the size of the window without you having to do
+anything. This is because by default widgets use size hinting. 
+
+The code above doesn't handle the input from the user does no validation or
+anything else. We will delve deeper into this and :class:`~Widget` size and
+positioning when diving into `Your First Widget`.
+
+
 Platform specifics
 ------------------
 

doc/sources/guide2/lang.rst

@@ -214,10 +214,11 @@ Consider the code below in my.kv::
 
 myapp.py::
 
-    txt_inpt = ObjectProperty(None)
     ...
     class MyFirstWidget(BoxLayout):
     
+        txt_inpt = ObjectProperty(None)
+    
         def check_status(self, btn):
             print ('button state is: {state}'.format(state=btn.state))
             print ('text input text is: {txt}'.format(txt=self.txt_inpt))
@@ -228,13 +229,13 @@ to `None` inside the Class.::
 
     txt_inpt = ObjectProperty(None)
 
-At this point self.txt_input is `None`. In Kv lang this property is updated to
+At this point self.txt_inpt is `None`. In Kv lang this property is updated to
 hold the instance of the :class:`~kivy.uix.TextInput` referenced by the id
 `txt_inpt`.::
 
     txt_inpt: txt_inpt
 
-Thus; self.txt_input from this point onwards holds the instance to the widget
+Thus; self.txt_inpt from this point onwards holds the instance to the widget
 referenced by the id `txt_input` and can be used anywhere in the class like in
 the function `check_status`.