Repository: ckan/ckan

Issue:
Update documentation with the new CLI commands
Now that the all commands are available in the new `ckan` command we need to update the docs to replace usage of the paster based ones.

- [ ] The main CLI doc page is [this one](https://github.com/ckan/ckan/blob/master/doc/maintaining/paster.rst)
- [ ] Besides, we need to replace all `paster xxx` commands listed in the docs with its `ckan xxx` counterparts
- [ ] Include info on how to add commands from extensions after #5108 is done




Discussion:

Resolving patch:
diff --git a/ckan/cli/__init__.py b/ckan/cli/__init__.py
--- a/ckan/cli/__init__.py
+++ b/ckan/cli/__init__.py
@@ -74,6 +74,7 @@ def load_config(ini_path=None):
         filename = os.environ.get(u'CKAN_INI')
         config_source = u'$CKAN_INI'
     else:
+        # deprecated method since CKAN 2.9
         default_filename = u'development.ini'
         filename = os.path.join(os.getcwd(), default_filename)
         if not os.path.exists(filename):
diff --git a/doc/conf.py b/doc/conf.py
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -38,6 +38,7 @@
 .. |config_dir| replace:: |config_parent_dir|/default
 .. |production.ini| replace:: |config_dir|/production.ini
 .. |development.ini| replace:: |config_dir|/development.ini
+.. |ckan.ini| replace:: |config_dir|/ckan.ini
 .. |git_url| replace:: \https://github.com/ckan/ckan.git
 .. |raw_git_url| replace:: \https://raw.githubusercontent.com/ckan/ckan
 .. |postgres| replace:: PostgreSQL


Test patch:
diff --git a/doc/contributing/test.rst b/doc/contributing/test.rst
--- a/doc/contributing/test.rst
+++ b/doc/contributing/test.rst
@@ -27,7 +27,7 @@ Install additional dependencies
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Some additional dependencies are needed to run the tests. Make sure you've
-created a config file at |development.ini|, then activate your
+created a config file at |ckan.ini|, then activate your
 virtual environment:
 
 .. parsed-literal::
@@ -56,7 +56,7 @@ Create test databases:
 
 Set the permissions::
 
-    paster datastore set-permissions -c test-core.ini | sudo -u postgres psql
+    ckan -c |ckan.ini| datastore set-permissions | sudo -u postgres psql
 
 This database connection is specified in the ``test-core.ini`` file by the
 ``sqlalchemy.url`` parameter.
@@ -80,7 +80,7 @@ Each core will be within a child from the ``<lst name="status"`` element, and co
 
 You can also tell from your ckan config (assuming ckan is working)::
 
-    grep solr_url /etc/ckan/default/production.ini
+    grep solr_url |ckan.ini|
     # single-core: solr_url = http://127.0.0.1:8983/solr
     # multi-core:  solr_url = http://127.0.0.1:8983/solr/ckan
 
@@ -109,7 +109,7 @@ To enable multi-core:
 
        sudo service jetty restart
 
-6. Edit your main ckan config (e.g. |development.ini|) and adjust the solr_url to match::
+6. Edit your main ckan config (e.g. |ckan.ini|) and adjust the solr_url to match::
 
        solr_url = http://127.0.0.1:8983/solr/ckan
 
@@ -172,7 +172,7 @@ PhantomJS_. First you need to install the necessary packages::
 To run the tests, make sure that a test server is running::
 
     . /usr/lib/ckan/default/bin/activate
-    paster serve test-core.ini
+    ckan -c |ckan.ini| run
 
 Once the test server is running switch to another terminal and execute the
 tests::