summaryrefslogtreecommitdiff
path: root/Version_Control
diff options
context:
space:
mode:
authorPrimal Pappachan2012-02-15 15:07:03 +0530
committerPrimal Pappachan2012-02-15 15:07:03 +0530
commit52d6bbfae385665200e63552917e77f74475df8b (patch)
tree0832357ffeb3d59042f4d639f545a0c59221a285 /Version_Control
parent9f98ca76fed87947ebe108b09d6703e11b59083f (diff)
downloadsdes-stscripts-52d6bbfae385665200e63552917e77f74475df8b.tar.gz
sdes-stscripts-52d6bbfae385665200e63552917e77f74475df8b.tar.bz2
sdes-stscripts-52d6bbfae385665200e63552917e77f74475df8b.zip
added missing exchanges
Diffstat (limited to 'Version_Control')
-rw-r--r--Version_Control/vcs1/vcs1.rst37
-rw-r--r--Version_Control/vcs1/vcs1_rec.rst54
2 files changed, 48 insertions, 43 deletions
diff --git a/Version_Control/vcs1/vcs1.rst b/Version_Control/vcs1/vcs1.rst
index 60e4647..c022513 100644
--- a/Version_Control/vcs1/vcs1.rst
+++ b/Version_Control/vcs1/vcs1.rst
@@ -37,7 +37,6 @@ At the end of this tutorial you will be able to
#. Identify the need for using Version Control
#. Install Mercurial and intialize a repository
-.. R3
First, let's understand what 'Version Control' is.
@@ -45,7 +44,7 @@ First, let's understand what 'Version Control' is.
*{{{Show the slide 'what is version control'}}*}
-.. R4
+.. R3
'Version control' is a way to track files over time and share them. This allows
access to earlier versions of a file(s) if and when required. It therefore
@@ -65,7 +64,7 @@ the scientific computing world, even when if they would be very useful.
*{{{Show the slide 'Home-brewed'}}}*
-.. R5
+.. R4
Let's look at an example of home-brewed Version Control system
@@ -78,7 +77,7 @@ organized and systematic way.
*{{{Show the slide 'Problems'}}}*
-.. R6
+.. R5
Let's look at the various problems associated with this set-up.
@@ -90,7 +89,7 @@ Let's look at the various problems associated with this set-up.
*{{{Show the slide 'The need for Version Control'}}}*
-.. R7
+.. R6
Having seen the problems of a home brewed setup, let's now move onto
identifying the needs for a 'Version Control System'.
@@ -105,7 +104,7 @@ identifying the needs for a 'Version Control System'.
*{{{Show the slide 'The need for Version Control'}}}*
-.. R8
+.. R7
We have seen that one of the main motivations to use a Version Control system
is the ability to go back to a working version of a file, when something goes
@@ -125,7 +124,7 @@ from a hard disk crash.
*{{{Show the slide 'How does it work? - Analogy}}}*
-.. R9
+.. R8
It is, in some ways, similar to playing a video game. We generally play games
in stages. While playing, we save the game at some instances as per our choice.
@@ -137,7 +136,7 @@ the game.
*{{{Show the slide 'Mercurial or hg'}}}*
-.. R10
+.. R9
Some of the Version Control tools available and used widely are:
@@ -146,7 +145,6 @@ Some of the Version Control tools available and used widely are:
#. hg(mercurial)
#. git
-.. R11
Each of these tools have their own merits and demerits. In this tutorial we
shall learn how to use mercurial or hg which is easy to learn and use and
@@ -160,7 +158,7 @@ type the following in command line terminal
``sudo apt-get install mercurial``
-.. R12
+.. R10
For Windows,
@@ -170,7 +168,7 @@ For Windows,
``http://hgbook.red-bean.com/read/a-tour-of-mercurial-the-basics.html``
-.. R 13
+.. R 11
For any other Operating system, please refer the hg book for installation
instruction -
@@ -181,7 +179,7 @@ Type 'hg' which lists out all the commands
``$hg``
-.. R14
+.. R12
and 'hg version' which gives the version number.
@@ -189,11 +187,10 @@ and 'hg version' which gives the version number.
``$hg version``
-.. L14
*{{{Show the 'summary' slide'}}}*
-.. R15
+.. R13
This brings us to the end of the tutorial. In this tutorial, we have
seen,
@@ -202,11 +199,11 @@ seen,
#. an analogy of version control with playing a video game
#. how to check if mercurial is installed, and it's version using hg version
-.. L15
+.. L14
*{{{Show self assessment questions slide}}}*
-.. R16
+.. R14
Here are some self assessment questions for you to solve
@@ -214,11 +211,11 @@ Here are some self assessment questions for you to solve
#. How can you verify whether Mercurial has been installed properly?
#. What is the command for accessing built-in help system of Mercurial?
-.. L16
+.. L15
*{{{Show the solutions slide to self assessment questions }}}*
-.. R17
+.. R15
And the answers,
@@ -227,11 +224,11 @@ And the answers,
#. $hg help command
-.. L17
+.. L16
*{{{Show the thank you slide}}}*
-.. R18
+.. R16
Hope you have enjoyed this tutorial and found it useful. Feel free to play
around with Mercurial and read the documentation given by hg help command. When
diff --git a/Version_Control/vcs1/vcs1_rec.rst b/Version_Control/vcs1/vcs1_rec.rst
index 4487136..01e264e 100644
--- a/Version_Control/vcs1/vcs1_rec.rst
+++ b/Version_Control/vcs1/vcs1_rec.rst
@@ -26,10 +26,11 @@ Spoken Tutorial Script
| | 1. Understand what is Version Control |
| | #. Identify the need for using Version Control |
| | #. Install Mercurial and intialize a repository |
+| | |
+| | |
+| | First, let's understand what 'Version Control' is. |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the slide 'what is version control'}}*} | First, let's understand what 'Version Control' is. |
-+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the slide 'Home-brewed'}}}* | 'Version control' is a way to track files over time and share them. This allows |
+| *{{{Show the slide 'what is version control'}}*} | 'Version control' is a way to track files over time and share them. This allows |
| | access to earlier versions of a file(s) if and when required. It therefore |
| | enables us to make changes to the content of a file, view it's change log and |
| | collaborate on a single piece of work with a team of people. |
@@ -43,14 +44,14 @@ Spoken Tutorial Script
| | such things, which are widely used in the programmer world, but not so much in |
| | the scientific computing world, even when if they would be very useful. |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the slide 'Problems'}}}* | Let's look at an example of home-brewed Version Control system |
+| *{{{Show the slide 'Home-brewed'}}}* | Let's look at an example of home-brewed Version Control system |
| | |
| | Version control is a way of backing up files, before making changes. Most |
| | people would have cooked up their own version control system, without |
| | realizing, there were tools built by others, that performs the task in a more |
| | organized and systematic way. |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the slide 'The need for Version Control'}}}* | Let's look at the various problems associated with this set-up. |
+| *{{{Show the slide 'Problems'}}}* | Let's look at the various problems associated with this set-up. |
| | |
| | 1. Name and changes made are not related or linked. |
| | #. Can't track sequence of changes made to a file |
@@ -65,7 +66,7 @@ Spoken Tutorial Script
| | #. To efficiently track down bugs and pin-point the |
| | #. changes that caused it |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the slide 'How does it work? - Analogy}}}* | We have seen that one of the main motivations to use a Version Control system |
+| *{{{Show the slide 'The need for Version Control'}}}* | We have seen that one of the main motivations to use a Version Control system |
| | is the ability to go back to a working version of a file, when something goes |
| | wrong. Below are a few more advantages of using an automated version control |
| | system. |
@@ -79,56 +80,63 @@ Spoken Tutorial Script
| | individual files etc. Hosting it on a remote server will protect your sanity |
| | from a hard disk crash. |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the slide 'Mercurial or hg'}}}* | It is, in some ways, similar to playing a video game. We generally play games |
+| *{{{Show the slide 'How does it work? - Analogy}}}* | It is, in some ways, similar to playing a video game. We generally play games |
| | in stages. While playing, we save the game at some instances as per our choice. |
| | We continue playing, but we could, if necessary, choose to go back to one of |
| | the saved states and start over. In this manner, we could change the course of |
| | the game. |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| ``sudo apt-get install mercurial`` | Some of the Version Control tools available and used widely are: |
+| *{{{Show the slide 'Mercurial or hg'}}}* | Some of the Version Control tools available and used widely are: |
| | |
| | 1. cvs(Concurrent Version Systems) |
| | #. svn(subversion) |
| | #. hg(mercurial) |
| | #. git |
-+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| ``http://mercurial.selenic.com/downloads/`` | Each of these tools have their own merits and demerits. In this tutorial we |
+| | |
+| | |
+| | Each of these tools have their own merits and demerits. In this tutorial we |
| | shall learn how to use mercurial or hg which is easy to learn and use and |
-| ``http://hgbook.red-bean.com/read/a-tour-of-mercurial-the-basics.html`` | comparatively light weight. Once you learn how to use hg, you can easily try |
+| | comparatively light weight. Once you learn how to use hg, you can easily try |
| | other tools and switch to one that you feel most comfortable with. |
-| .. R 13 | |
+| | |
| | Let's now get into Installation. For Linux distributions, Ubuntu and Debian |
-| For any other Operating system, please refer the hg book for installation | type the following in command line terminal |
+| | type the following in command line terminal |
++----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
+| ``sudo apt-get install mercurial`` | For Windows, |
++----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
+| ``http://mercurial.selenic.com/downloads/`` | |
+| | |
+| ``http://hgbook.red-bean.com/read/a-tour-of-mercurial-the-basics.html`` | |
+| | |
+| .. R 11 | |
+| | |
+| For any other Operating system, please refer the hg book for installation | |
| instruction - | |
| | |
| Type 'hg' which lists out all the commands | |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| ``$hg`` | For Windows, |
-+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| ``$hg version`` | |
-+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the 'summary' slide'}}}* | and 'hg version' which gives the version number. |
+| ``$hg`` | and 'hg version' which gives the version number. |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show self assessment questions slide}}}* | This brings us to the end of the tutorial. In this tutorial, we have |
+| ``$hg version`` | This brings us to the end of the tutorial. In this tutorial, we have |
| | seen, |
| | |
-| | 1. the motivation to use version control |
+| *{{{Show the 'summary' slide'}}}* | 1. the motivation to use version control |
| | #. an analogy of version control with playing a video game |
| | #. how to check if mercurial is installed, and it's version using hg version |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the solutions slide to self assessment questions }}}* | Here are some self assessment questions for you to solve |
+| *{{{Show self assessment questions slide}}}* | Here are some self assessment questions for you to solve |
| | |
| | 1. Is Mercurial a Centralized VCS or Distributed VCS? Justify your reasoning. |
| | #. How can you verify whether Mercurial has been installed properly? |
| | #. What is the command for accessing built-in help system of Mercurial? |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| *{{{Show the thank you slide}}}* | And the answers, |
+| *{{{Show the solutions slide to self assessment questions }}}* | And the answers, |
| | |
| | 1. Mercurial is a Centralized Version Control system. To read more go here, htt |
| | #. $hg version |
| | #. $hg help command |
+----------------------------------------------------------------------------------+----------------------------------------------------------------------------------+
-| | Hope you have enjoyed this tutorial and found it useful. Feel free to play |
+| *{{{Show the thank you slide}}}* | Hope you have enjoyed this tutorial and found it useful. Feel free to play |
| | around with Mercurial and read the documentation given by hg help command. When |
| | you are ready to move on, please proceed to the second tutorial on 'Version |
| | Control using Hg' |