Skip to content
Snippets Groups Projects
Commit 16522dbc authored by André Anjos's avatar André Anjos :speech_balloon:
Browse files

Merge branch 'p1' into 'master'

[Automatic] update links and the ci mostly



See merge request !2
parents 5d702965 b4f326cf
Branches
Tags
1 merge request!2[Automatic] update links and the ci mostly
Pipeline #
...@@ -20,10 +20,10 @@ verbose = true ...@@ -20,10 +20,10 @@ verbose = true
newest = false newest = false
[sources] [sources]
bob.extension = git git@gitlab.idiap.ch:bob/bob.extension bob.extension = git https://gitlab.idiap.ch/bob/bob.extension
bob.blitz = git git@gitlab.idiap.ch:bob/bob.blitz bob.blitz = git https://gitlab.idiap.ch/bob/bob.blitz
bob.core = git git@gitlab.idiap.ch:bob/bob.core bob.core = git https://gitlab.idiap.ch/bob/bob.core
bob.io.base = git git@gitlab.idiap.ch:bob/bob.io.base bob.io.base = git https://gitlab.idiap.ch/bob/bob.io.base
[scripts] [scripts]
recipe = bob.buildout:scripts recipe = bob.buildout:scripts
...@@ -55,21 +55,22 @@ the import function: ...@@ -55,21 +55,22 @@ the import function:
Activation Functors Activation Functors
------------------- -------------------
.. cpp:type:: PyBobLearnActivationObject .. c:type:: PyBobLearnActivationObject
The pythonic object representation for a ``bob::machine::Activation`` The pythonic object representation for a
object. It is the base class of all activation functors available in ``bob::learn::activation::Activation`` object. It is the base class of all
|project|. In C/C++ code, we recommend you only manipulate objects like this activation functors available in |project|. In C/C++ code, we recommend you
to keep your code agnostic to the activation type being used. only manipulate objects like this to keep your code agnostic to the
activation type being used.
.. code-block:: cpp .. code-block:: cpp
typedef struct { typedef struct {
PyObject_HEAD PyObject_HEAD
bob::machine::Activation* base; bob::learn::activation::Activation* base;
} PyBobLearnActivationObject; } PyBobLearnActivationObject;
.. cpp:member:: bob::machine::Activation* base .. cpp:member:: bob::learn::activation::Activation* base
A pointer to the activation functor virtual implementation. A pointer to the activation functor virtual implementation.
...@@ -80,13 +81,14 @@ Activation Functors ...@@ -80,13 +81,14 @@ Activation Functors
Returns ``1`` if it is, and ``0`` otherwise. Returns ``1`` if it is, and ``0`` otherwise.
.. cpp:function:: PyObject* PyBobLearnActivation_NewFromActivation(boost::shared_ptr<bob::machine::Activation> a) .. cpp:function:: PyObject* PyBobLearnActivation_NewFromActivation(boost::shared_ptr<bob::learn::activation::Activation> a)
Constructs a new :c:type:`PyBobLearnActivationObject` starting from a shared Constructs a new :c:type:`PyBobLearnActivationObject` starting from a shared
pointer to a pre-allocated `bob::machine::Activation` instance. This API is pointer to a pre-allocated `bob::learn::activation::Activation` instance.
available so that return values from actuall C++ machines can be mapped into This API is available so that return values from actuall C++ machines can be
Python. It is the sole way to build an object of type :py:class:`Activation` mapped into Python. It is the sole way to build an object of type
without recurring to the derived classes. :py:class:`bob.learn.activation.Activation` without recurring to the derived
classes.
.. note:: .. note::
...@@ -100,7 +102,7 @@ Activation Functors ...@@ -100,7 +102,7 @@ Activation Functors
typedef struct { typedef struct {
PyBobLearnActivationObject parent; PyBobLearnActivationObject parent;
bob::machine::<Subtype>Activation* base; bob::learn::activation::<Subtype>Activation* base;
} PyBobLearn<Subtype>ActivationObject; } PyBobLearn<Subtype>ActivationObject;
Presently, ``<Subtype>`` can be one of: Presently, ``<Subtype>`` can be one of:
......
...@@ -30,9 +30,29 @@ extensions = [ ...@@ -30,9 +30,29 @@ extensions = [
import sphinx import sphinx
if sphinx.__version__ >= "1.4.1": if sphinx.__version__ >= "1.4.1":
extensions.append('sphinx.ext.imgmath') extensions.append('sphinx.ext.imgmath')
imgmath_image_format = 'svg'
else: else:
extensions.append('sphinx.ext.pngmath') extensions.append('sphinx.ext.pngmath')
# Be picky about warnings
nitpicky = True
# Ignores stuff we can't easily resolve on other project's sphinx manuals
nitpick_ignore = []
# Allows the user to override warnings from a separate file
if os.path.exists('nitpick-exceptions.txt'):
for line in open('nitpick-exceptions.txt'):
if line.strip() == "" or line.startswith("#"):
continue
dtype, target = line.split(None, 1)
target = target.strip()
try: # python 2.x
target = unicode(target)
except NameError:
pass
nitpick_ignore.append((dtype, target))
# Always includes todos # Always includes todos
todo_include_todos = True todo_include_todos = True
...@@ -216,8 +236,13 @@ autodoc_default_flags = [ ...@@ -216,8 +236,13 @@ autodoc_default_flags = [
] ]
# For inter-documentation mapping: # For inter-documentation mapping:
from bob.extension.utils import link_documentation from bob.extension.utils import link_documentation, load_requirements
intersphinx_mapping = link_documentation() sphinx_requirements = "extra-intersphinx.txt"
if os.path.exists(sphinx_requirements):
intersphinx_mapping = link_documentation(additional_packages=load_requirements(sphinx_requirements))
else:
intersphinx_mapping = link_documentation()
# We want to remove all private (i.e. _. or __.__) members # We want to remove all private (i.e. _. or __.__) members
# that are not in the list of accepted functions # that are not in the list of accepted functions
......
# No documentation exists for these c++ types
cpp:type bob
cpp:type bob::learn
cpp:type bob::learn::activation
cpp:type bob::learn::activation::Activation
cpp:type boost
cpp:type boost::shared_ptr
# These are not c++ types, but c - why Sphinx confuses those?
cpp:type PyObject
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment