From 220358aed00110bdefdfbcfde40d820a2b684b8b Mon Sep 17 00:00:00 2001 From: Derek Jones Date: Sun, 21 Jul 2013 13:34:09 -0700 Subject: Update Documentation instructions a bit --- user_guide_src/source/documentation/index.rst | 79 +++++++++++++++------------ 1 file changed, 43 insertions(+), 36 deletions(-) (limited to 'user_guide_src/source/documentation/index.rst') diff --git a/user_guide_src/source/documentation/index.rst b/user_guide_src/source/documentation/index.rst index e977566d2..43afe6fd3 100644 --- a/user_guide_src/source/documentation/index.rst +++ b/user_guide_src/source/documentation/index.rst @@ -8,12 +8,28 @@ Markdown or Textile, you will quickly grasp reStructuredText. The focus is on readability, user friendliness, and an "I've got your hand, baby" feel. While they can be quite technical, we always write for humans! -A table of contents should always be included like the one below. -It is created automatically by inserting the ``.. contents::`` -directive on a line by itself. +A local table of contents should always be included like the one below. +It is created automatically by inserting the the following: -.. contents:: Page Contents +:: + .. contents:: + :local: + + .. raw:: html + +
+ +.. contents:: + :local: + +.. raw:: html + +
+ +The
that is inserted as raw HTML is a hook for the documentation's +JavaScript to dynamically add links to any function and method definitions +contained in the current page. ************** Tools Required @@ -50,39 +66,39 @@ overlines. Other headings just use underlines, with the following hierarchy:: - for subsubsections ^ for subsubsubsections " for subsubsubsubsections (!) - + The :download:`TextMate ELDocs Bundle <./ELDocs.tmbundle.zip>` can help you create these with the following tab triggers:: title-> - + ########## Page Title ########## sec-> - + ************* Major Section ************* - + sub-> - + Subsection ========== - + sss-> - + SubSubSection ------------- - + ssss-> - + SubSubSubSection ^^^^^^^^^^^^^^^^ - + sssss-> - + SubSubSubSubSection (!) """"""""""""""""""""""" @@ -99,12 +115,9 @@ ReST: .. code-block:: rst - .. php:class:: Some_class - - some_method() - ============= + .. class:: Some_class - .. php:method:: some_method ( $foo [, $bar [, $bat]]) + .. method:: some_method ( $foo [, $bar [, $bat]]) This function will perform some action. The ``$bar`` array must contain a something and something else, and along with ``$bat`` is an optional @@ -115,7 +128,7 @@ ReST: :param bool $bat: whether or not to do something :returns: FALSE on failure, TRUE if successful :rtype: Boolean - + :: $this->load->library('some_class'); @@ -131,16 +144,14 @@ ReST: { show_error('An Error Occurred Doing Some Method'); } - + .. note:: Here is something that you should be aware of when using some_method(). For real. - + See also :php:meth:`Some_class::should_do_something` - should_do_something() - ===================== - .. php:method:: should_do_something() + .. method:: should_do_something() :returns: whether or something should be done or not :rtype: Boolean @@ -148,12 +159,10 @@ ReST: It creates the following display: -.. php:class:: Some_class +.. class:: Some_class -some_method() -============= - .. php:method:: some_method ( $foo [, $bar [, $bat]]) + .. method:: some_method ( $foo [, $bar [, $bat]]) This function will perform some action. The ``$bar`` array must contain a something and something else, and along with ``$bat`` is an optional @@ -164,7 +173,7 @@ some_method() :param bool $bat: whether or not to do something :returns: FALSE on failure, TRUE if successful :rtype: Boolean - + :: $this->load->library('some_class'); @@ -180,16 +189,14 @@ some_method() { show_error('An Error Occurred Doing Some Method'); } - + .. note:: Here is something that you should be aware of when using some_method(). For real. - + See also :php:meth:`Some_class::should_do_something` -should_do_something() -===================== - .. php:method:: should_do_something() + .. method:: should_do_something() :returns: whether or something should be done or not :rtype: Boolean -- cgit v1.2.3-24-g4f1b From 1e41136bdb4fad4d81ebf892240bb72bee73ef03 Mon Sep 17 00:00:00 2001 From: Andrey Andreev Date: Fri, 7 Feb 2014 15:53:02 +0200 Subject: [ci skip] Replace :php:func: usage with just :func: --- user_guide_src/source/documentation/index.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) (limited to 'user_guide_src/source/documentation/index.rst') diff --git a/user_guide_src/source/documentation/index.rst b/user_guide_src/source/documentation/index.rst index 43afe6fd3..b080c0efa 100644 --- a/user_guide_src/source/documentation/index.rst +++ b/user_guide_src/source/documentation/index.rst @@ -127,7 +127,7 @@ ReST: :param mixed $bar: A data array that must contain aa something and something else :param bool $bat: whether or not to do something :returns: FALSE on failure, TRUE if successful - :rtype: Boolean + :rtype: bool :: @@ -148,13 +148,13 @@ ReST: .. note:: Here is something that you should be aware of when using some_method(). For real. - See also :php:meth:`Some_class::should_do_something` + See also :meth:`Some_class::should_do_something` .. method:: should_do_something() - :returns: whether or something should be done or not - :rtype: Boolean + :returns: Whether or something should be done or not + :rtype: bool It creates the following display: @@ -172,7 +172,7 @@ It creates the following display: :param mixed $bar: A data array that must contain aa something and something else :param bool $bat: whether or not to do something :returns: FALSE on failure, TRUE if successful - :rtype: Boolean + :rtype: bool :: @@ -193,10 +193,10 @@ It creates the following display: .. note:: Here is something that you should be aware of when using some_method(). For real. - See also :php:meth:`Some_class::should_do_something` + See also :meth:`Some_class::should_do_something` .. method:: should_do_something() - :returns: whether or something should be done or not - :rtype: Boolean + :returns: Whether or something should be done or not + :rtype: bool \ No newline at end of file -- cgit v1.2.3-24-g4f1b