From 8ede1a2ecbb62577afd32996956c5feaf7ddf9b6 Mon Sep 17 00:00:00 2001
From: Derek Jones <derek.jones@ellislab.com>
Date: Wed, 5 Oct 2011 13:34:52 -0500
Subject: replacing the old HTML user guide with a Sphinx-managed user guide

---
 user_guide_src/source/general/cli.rst | 68 +++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 user_guide_src/source/general/cli.rst

(limited to 'user_guide_src/source/general/cli.rst')

diff --git a/user_guide_src/source/general/cli.rst b/user_guide_src/source/general/cli.rst
new file mode 100644
index 000000000..e6f812570
--- /dev/null
+++ b/user_guide_src/source/general/cli.rst
@@ -0,0 +1,68 @@
+###################
+Running via the CLI
+###################
+
+As well as calling an applications :doc:`Controllers <./controllers>`
+via the URL in a browser they can also be loaded via the command-line
+interface (CLI).
+
+-  `What is the CLI? <#what>`_
+-  `Why use this method? <#why>`_
+-  `How does it work? <#how>`_
+
+What is the CLI?
+================
+
+The command-line interface is a text-based method of interacting with
+computers. For more information, check the `Wikipedia
+article <http://en.wikipedia.org/wiki/Command-line_interface>`_.
+
+Why run via the command-line?
+=============================
+
+There are many reasons for running CodeIgniter from the command-line,
+but they are not always obvious.
+
+-  Run your cron-jobs without needing to use wget or curl
+-  Make your cron-jobs inaccessible from being loaded in the URL by
+   checking for ``$this->input->is_cli_request()``
+-  Make interactive "tasks" that can do things like set permissions,
+   prune cache folders, run backups, etc.
+-  Integrate with other applications in other languages. For example, a
+   random C++ script could call one command and run code in your models!
+
+Let's try it: Hello World!
+==========================
+
+Let's create a simple controller so you can see it in action. Using your
+text editor, create a file called tools.php, and put the following code
+in it:
+
+<?php class Tools extends CI_Controller { public function message($to =
+'World') { echo "Hello {$to}!".PHP_EOL; } } ?>
+Then save the file to your application/controllers/ folder.
+
+Now normally you would visit the your site using a URL similar to this::
+
+	example.com/index.php/tools/message/to
+
+Instead, we are going to open Terminal in Mac/Lunix or go to Run > "cmd"
+in Windows and navigate to our CodeIgniter project.
+
+	$ cd /path/to/project;
+	$ php index.php tools message
+
+If you did it right, you should see Hello World!.
+
+	$ php index.php tools message "John Smith"
+
+Here we are passing it a argument in the same way that URL parameters
+work. "John Smith" is passed as a argument and output is: Hello John
+Smith!.
+
+That's it!
+==========
+
+That, in a nutshell, is all there is to know about controllers on the
+command line. Remember that this is just a normal controller, so routing
+and _remap works fine.
-- 
cgit v1.2.3-24-g4f1b


From 46715e5ca1451de2faa32b5866c37a40c8051423 Mon Sep 17 00:00:00 2001
From: Derek Jones <derek.jones@ellislab.com>
Date: Wed, 5 Oct 2011 17:36:22 -0500
Subject: fixing code spacing in Common and CLI docs

---
 user_guide_src/source/general/cli.rst | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

(limited to 'user_guide_src/source/general/cli.rst')

diff --git a/user_guide_src/source/general/cli.rst b/user_guide_src/source/general/cli.rst
index e6f812570..8fcf31702 100644
--- a/user_guide_src/source/general/cli.rst
+++ b/user_guide_src/source/general/cli.rst
@@ -36,10 +36,18 @@ Let's try it: Hello World!
 
 Let's create a simple controller so you can see it in action. Using your
 text editor, create a file called tools.php, and put the following code
-in it:
+in it::
+
+	<?php
+	class Tools extends CI_Controller {
+
+		public function message($to = 'World')
+		{
+			echo "Hello {$to}!".PHP_EOL;
+		}
+	}
+	?>
 
-<?php class Tools extends CI_Controller { public function message($to =
-'World') { echo "Hello {$to}!".PHP_EOL; } } ?>
 Then save the file to your application/controllers/ folder.
 
 Now normally you would visit the your site using a URL similar to this::
@@ -49,11 +57,15 @@ Now normally you would visit the your site using a URL similar to this::
 Instead, we are going to open Terminal in Mac/Lunix or go to Run > "cmd"
 in Windows and navigate to our CodeIgniter project.
 
+.. code-block:: bash
+
 	$ cd /path/to/project;
 	$ php index.php tools message
 
 If you did it right, you should see Hello World!.
 
+.. code-block:: bash
+
 	$ php index.php tools message "John Smith"
 
 Here we are passing it a argument in the same way that URL parameters
-- 
cgit v1.2.3-24-g4f1b


From 5b3ea1ac070882c09eb6cb93f2ca6628ec42d64d Mon Sep 17 00:00:00 2001
From: Joseph Wensley <jwensley2@gmail.com>
Date: Thu, 6 Oct 2011 20:54:32 -0400
Subject: change hardcoded page docs to use generated ones escape "http://"
 that was getting linked formatting some tables

---
 user_guide_src/source/general/cli.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

(limited to 'user_guide_src/source/general/cli.rst')

diff --git a/user_guide_src/source/general/cli.rst b/user_guide_src/source/general/cli.rst
index 8fcf31702..7dc1ca319 100644
--- a/user_guide_src/source/general/cli.rst
+++ b/user_guide_src/source/general/cli.rst
@@ -6,9 +6,7 @@ As well as calling an applications :doc:`Controllers <./controllers>`
 via the URL in a browser they can also be loaded via the command-line
 interface (CLI).
 
--  `What is the CLI? <#what>`_
--  `Why use this method? <#why>`_
--  `How does it work? <#how>`_
+.. contents:: Page Contents
 
 What is the CLI?
 ================
-- 
cgit v1.2.3-24-g4f1b