--- a/getting-started-with-lists/script.rst Thu Nov 11 17:39:26 2010 +0530
+++ b/getting-started-with-lists/script.rst Fri Nov 12 00:36:35 2010 +0530
@@ -22,6 +22,7 @@
.. Author : Amit
Internal Reviewer : Anoop Jacob Thomas <anoop@fossee.in>
External Reviewer :
+ Language Reviewer : Bhanukiran
Checklist OK? : <put date stamp here, if OK> [2010-10-05]
.. #[[Anoop: Slides contain only outline and summary
@@ -44,9 +45,9 @@
* Append elements to lists
* Delete elements from lists
-List is a compound data type, it can contain data of other data
-types. List is also a sequence data type, all the elements are in
-order and the order has a meaning.
+List is a compound data type, it can contain data of mutually
+different datatypes. List is also a sequence data type, all the
+elements are arranged in a given order.
.. #[[Anoop: "all the elements are in order and **there** order has a
meaning." - I guess something is wrong here, I am not able to
@@ -69,13 +70,13 @@
nonempty = ['spam', 'eggs', 100, 1.234]
Thus the simplest way of creating a list is typing out a sequence
-of comma-separated values (items) between square brackets.
-All the list items need not be of the same data type.
+of comma-separated values (or items) between two square brackets.
As we can see lists can contain different kinds of data. In the
-previous example 'spam' and 'eggs' are strings and 100 and 1.234 are
-integer and float. Thus we can put elements of heterogenous types in
-lists including list itself.
+previous example 'spam' and 'eggs' are strings whereas 100 and 1.234 are
+integer and float respectively. Thus we can put elements of different types in
+lists including lists itself. This property makes lists heterogeneous
+data structures.
.. #[[Anoop: the sentence "Thus list themselves can be one of the
element types possible in lists" is not clear, rephrase it.]]
@@ -84,9 +85,10 @@
listinlist=[[4,2,3,4],'and', 1, 2, 3, 4]
-We access list elements using the index. The index begins from 0. So
-for list nonempty, nonempty[0] gives the first element, nonempty[1]
-the second element and so on and nonempty[3] the last element. ::
+We access an element of a list using its corresponding index. Index of
+the first element of a list is 0. So for the list nonempty, nonempty[0]
+gives the first element, nonempty[1] the second element and so on and
+nonempty[3] the last element. ::
nonempty[0]
nonempty[1]
@@ -112,9 +114,9 @@
nonempty[-4]
-1 gives the last element which is the 4th element , -2 second to last
-and -4 gives the fourth from last element which is first element.
+and -4 gives the fourth from the last which, in this case, is the first element.
-We can append elements to the end of a list using append command. ::
+We can append elements to the end of a list using the method append. ::
nonempty.append('onemore')
nonempty
@@ -134,10 +136,10 @@
The solution is on your screen
-As we can see non empty appends 'onemore' and 6 at the end.
+As we can see nonempty is appended with 'onemore' and 6 at the end.
Using len function we can check the number of elements in the list
-nonempty. In this case it 6 ::
+nonempty. In this case it is 6 ::
len(nonempty)
@@ -175,11 +177,12 @@
nonempty
If we check now we will see that the first occurence 'spam' is removed
-thus remove removes the first occurence of the element in the sequence
+and therefore `remove` removes the first occurence of the element in the sequence
and leaves others untouched.
-One should remember this that while del removes by index number.
-Remove , removes on the basis of content being passed so if ::
+One should remember this that while del removes by index number,
+`remove` removes on the basis of content being passed on. For instance
+if ::
k = [1,2,1,3]
del([k[2])