Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
doc: use sections instead of rubric
authorMartin Quinson <martin.quinson@ens-rennes.fr>
Sun, 10 Nov 2019 18:09:00 +0000 (19:09 +0100)
committerMartin Quinson <martin.quinson@ens-rennes.fr>
Sun, 10 Nov 2019 18:09:06 +0000 (19:09 +0100)
docs/source/app_s4u.rst

index 9375cbd..74fb609 100644 (file)
@@ -405,162 +405,143 @@ class Actor
 
 .. autodoxyclass:: simgrid::s4u::Actor
 
-   .. rubric:: Table of contents
+Creating actors
+---------------
 
-   - :ref:`API_s4u_Actor_create`
-   - :ref:`API_s4u_Actor_search`
-   - :ref:`API_s4u_Actor_query`
-   - :ref:`API_s4u_Actor_suspend`
-   - :ref:`API_s4u_Actor_kill`
-   - :ref:`API_s4u_Actor_ending`
-   - :ref:`API_s4u_Actor_signals`
+.. tabs::
 
-   |hr|
+   .. group-tab:: C++
 
-   .. _API_s4u_Actor_create:
+      .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::function< void()> &code)
+      .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code)
+      .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code, Args... args)
+      .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::string &function, std::vector< std::string > args)
 
-   .. rubric:: Creating actors :ref:`(back to top) <API_s4u_Actor>`
+      .. autodoxymethod:: simgrid::s4u::Actor::init(const std::string &name, s4u::Host *host)
+      .. autodoxymethod:: simgrid::s4u::Actor::start(const std::function< void()> &code)
 
-   .. tabs::
+   .. group-tab:: Python
 
-      .. group-tab:: C++
+      .. automethod:: simgrid.Actor.create
 
-         .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::function< void()> &code)
-         .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code)
-         .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code, Args... args)
-         .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::string &function, std::vector< std::string > args)
+Searching specific actors
+-------------------------
 
-         .. autodoxymethod:: simgrid::s4u::Actor::init(const std::string &name, s4u::Host *host)
-         .. autodoxymethod:: simgrid::s4u::Actor::start(const std::function< void()> &code)
+.. tabs::
 
-      .. group-tab:: Python
+   .. group-tab:: C++
 
-         .. automethod:: simgrid.Actor.create
+      .. autodoxymethod:: simgrid::s4u::Actor::by_pid(aid_t pid)
+      .. autodoxymethod:: simgrid::s4u::Actor::self()
 
-   .. _API_s4u_Actor_search:
+   .. group-tab:: Python
 
-   .. rubric:: Searching specific actors :ref:`(back to top) <API_s4u_Actor>`
+      .. automethod:: simgrid.Actor.by_pid
+      .. automethod:: simgrid.Actor.self
 
-   .. tabs::
+Querying info about actors
+--------------------------
 
-      .. group-tab:: C++
+.. tabs::
 
-         .. autodoxymethod:: simgrid::s4u::Actor::by_pid(aid_t pid)
-         .. autodoxymethod:: simgrid::s4u::Actor::self()
+   .. group-tab:: C++
 
-      .. group-tab:: Python
+      .. autodoxymethod:: simgrid::s4u::Actor::get_cname
+      .. autodoxymethod:: simgrid::s4u::Actor::get_name
+      .. autodoxymethod:: simgrid::s4u::Actor::get_pid
+      .. autodoxymethod:: simgrid::s4u::Actor::get_ppid
+      .. autodoxymethod:: simgrid::s4u::Actor::get_properties() const
+      .. autodoxymethod:: simgrid::s4u::Actor::get_property(const std::string &key) const
+      .. autodoxymethod:: simgrid::s4u::Actor::set_property(const std::string &key, const std::string &value) 
 
-         .. automethod:: simgrid.Actor.by_pid
-         .. automethod:: simgrid.Actor.self
+      .. autodoxymethod:: simgrid::s4u::Actor::get_host
+      .. autodoxymethod:: simgrid::s4u::Actor::migrate
 
-   .. _API_s4u_Actor_query:
+      .. autodoxymethod:: simgrid::s4u::Actor::get_refcount()
+      .. autodoxymethod:: simgrid::s4u::Actor::get_impl()
 
-   .. rubric:: Querying info about actors :ref:`(back to top) <API_s4u_Actor>`
+   .. group-tab:: Python
+                  
+      .. autoattribute:: simgrid.Actor.name
+      .. autoattribute:: simgrid.Actor.host
+      .. autoattribute:: simgrid.Actor.pid
+      .. autoattribute:: simgrid.Actor.ppid
 
-   .. tabs::
+      .. automethod:: simgrid.Actor.migrate
 
-         .. group-tab:: C++
+Suspending and resuming actors
+------------------------------
 
-            .. autodoxymethod:: simgrid::s4u::Actor::get_cname
-            .. autodoxymethod:: simgrid::s4u::Actor::get_name
-            .. autodoxymethod:: simgrid::s4u::Actor::get_pid
-            .. autodoxymethod:: simgrid::s4u::Actor::get_ppid
-            .. autodoxymethod:: simgrid::s4u::Actor::get_properties() const
-            .. autodoxymethod:: simgrid::s4u::Actor::get_property(const std::string &key) const
-            .. autodoxymethod:: simgrid::s4u::Actor::set_property(const std::string &key, const std::string &value) 
+.. tabs::
 
-            .. autodoxymethod:: simgrid::s4u::Actor::get_host
-            .. autodoxymethod:: simgrid::s4u::Actor::migrate
+   .. group-tab:: C++
 
-            .. autodoxymethod:: simgrid::s4u::Actor::get_refcount()
-            .. autodoxymethod:: simgrid::s4u::Actor::get_impl()
+      .. autodoxymethod:: simgrid::s4u::Actor::suspend()
+      .. autodoxymethod:: simgrid::s4u::Actor::resume()
+      .. autodoxymethod:: simgrid::s4u::Actor::is_suspended()
 
-         .. group-tab:: Python
+   .. group-tab:: Python
 
-            .. autoattribute:: simgrid.Actor.name
-            .. autoattribute:: simgrid.Actor.host
-            .. autoattribute:: simgrid.Actor.pid
-            .. autoattribute:: simgrid.Actor.ppid
+      .. automethod:: simgrid.Actor.resume
+      .. automethod:: simgrid.Actor.suspend
+      .. automethod:: simgrid.Actor.is_suspended
 
-            .. automethod:: simgrid.Actor.migrate
+Killing actors
+--------------
 
-   .. _API_s4u_Actor_suspend:
+.. tabs::
 
-   .. rubric:: Suspending and resuming actors :ref:`(back to top) <API_s4u_Actor>`
+   .. group-tab:: C++
 
-   .. tabs::
+      .. autodoxymethod:: simgrid::s4u::Actor::kill()
+      .. autodoxymethod:: simgrid::s4u::Actor::kill_all()
+      .. autodoxymethod:: simgrid::s4u::Actor::set_kill_time(double time)
+      .. autodoxymethod:: simgrid::s4u::Actor::get_kill_time()
 
-      .. group-tab:: C++
+      .. autodoxymethod:: simgrid::s4u::Actor::restart()
+      .. autodoxymethod:: simgrid::s4u::Actor::daemonize()
+      .. autodoxymethod:: simgrid::s4u::Actor::is_daemon
 
-         .. autodoxymethod:: simgrid::s4u::Actor::suspend()
-         .. autodoxymethod:: simgrid::s4u::Actor::resume()
-         .. autodoxymethod:: simgrid::s4u::Actor::is_suspended()
+   .. group-tab:: Python
 
-      .. group-tab:: Python
+      .. automethod:: simgrid.Actor.kill
+      .. automethod:: simgrid.Actor.kill_all
 
-         .. automethod:: simgrid.Actor.resume
-         .. automethod:: simgrid.Actor.suspend
-         .. automethod:: simgrid.Actor.is_suspended
+      .. automethod:: simgrid.Actor.daemonize
+      .. automethod:: simgrid.Actor.is_daemon
 
-   .. _API_s4u_Actor_kill:
+Reacting to the end of actors
+-----------------------------
 
-   .. rubric:: Killing actors :ref:`(back to top) <API_s4u_Actor>`
+.. tabs::
 
-   .. tabs::
+   .. group-tab:: C++
 
-      .. group-tab:: C++
+      .. autodoxymethod:: simgrid::s4u::Actor::on_exit(const std::function< void(bool)> &fun)
+      .. autodoxymethod:: simgrid::s4u::Actor::join()
+      .. autodoxymethod:: simgrid::s4u::Actor::join(double timeout)
+      .. autodoxymethod:: simgrid::s4u::Actor::set_auto_restart(bool autorestart)
 
-         .. autodoxymethod:: simgrid::s4u::Actor::kill()
-         .. autodoxymethod:: simgrid::s4u::Actor::kill_all()
-         .. autodoxymethod:: simgrid::s4u::Actor::set_kill_time(double time)
-         .. autodoxymethod:: simgrid::s4u::Actor::get_kill_time()
+   .. group-tab:: Python
 
-         .. autodoxymethod:: simgrid::s4u::Actor::restart()
-         .. autodoxymethod:: simgrid::s4u::Actor::daemonize()
-         .. autodoxymethod:: simgrid::s4u::Actor::is_daemon
+      .. automethod:: simgrid.Actor.join
 
-      .. group-tab:: Python
+Signals
+-------
 
-         .. automethod:: simgrid.Actor.kill
-         .. automethod:: simgrid.Actor.kill_all
+.. tabs::
 
-         .. automethod:: simgrid.Actor.daemonize
-         .. automethod:: simgrid.Actor.is_daemon
+   .. group-tab:: C++
 
-   .. _API_s4u_Actor_ending:
-
-   .. rubric:: Reacting to the end of actors :ref:`(back to top) <API_s4u_Actor>`
-
-   .. tabs::
-
-      .. group-tab:: C++
-
-         .. autodoxymethod:: simgrid::s4u::Actor::on_exit(const std::function< void(bool)> &fun)
-         .. autodoxymethod:: simgrid::s4u::Actor::join()
-         .. autodoxymethod:: simgrid::s4u::Actor::join(double timeout)
-         .. autodoxymethod:: simgrid::s4u::Actor::set_auto_restart(bool autorestart)
-
-      .. group-tab:: Python
-
-         .. automethod:: simgrid.Actor.join
-
-   .. _API_s4u_Actor_signals:
-
-   .. rubric:: Signals :ref:`(back to top) <API_s4u_Actor>`
-
-   .. tabs::
-
-      .. group-tab:: C++
-
-         .. autodoxyvar:: simgrid::s4u::Actor::on_creation
-         .. autodoxyvar:: simgrid::s4u::Actor::on_suspend
-         .. autodoxyvar:: simgrid::s4u::Actor::on_resume
-         .. autodoxyvar:: simgrid::s4u::Actor::on_sleep
-         .. autodoxyvar:: simgrid::s4u::Actor::on_wake_up
-         .. autodoxyvar:: simgrid::s4u::Actor::on_migration_start
-         .. autodoxyvar:: simgrid::s4u::Actor::on_migration_end
-         .. autodoxyvar:: simgrid::s4u::Actor::on_termination
-         .. autodoxyvar:: simgrid::s4u::Actor::on_destruction
+      .. autodoxyvar:: simgrid::s4u::Actor::on_creation
+      .. autodoxyvar:: simgrid::s4u::Actor::on_suspend
+      .. autodoxyvar:: simgrid::s4u::Actor::on_resume
+      .. autodoxyvar:: simgrid::s4u::Actor::on_sleep
+      .. autodoxyvar:: simgrid::s4u::Actor::on_wake_up
+      .. autodoxyvar:: simgrid::s4u::Actor::on_migration_start
+      .. autodoxyvar:: simgrid::s4u::Actor::on_migration_end
+      .. autodoxyvar:: simgrid::s4u::Actor::on_termination
+      .. autodoxyvar:: simgrid::s4u::Actor::on_destruction
 
 .. _API_s4u_Barrier: