doc: Add artiq_session and artiq_ctlmgr to front-end tools

This commit is contained in:
architeuthidae 2024-07-29 11:31:37 +08:00 committed by Sébastien Bourdeauducq
parent a0fde00258
commit a324d77e37
2 changed files with 26 additions and 6 deletions

View File

@ -11,7 +11,7 @@ def get_argparser():
description="ARTIQ session manager. " description="ARTIQ session manager. "
"Automatically runs the master, dashboard and " "Automatically runs the master, dashboard and "
"local controller manager on the current machine. " "local controller manager on the current machine. "
"The latter requires the artiq-comtools package to " "The latter requires the ``artiq-comtools`` package to "
"be installed.") "be installed.")
parser.add_argument("--version", action="version", parser.add_argument("--version", action="version",
version="ARTIQ v{}".format(artiq_version), version="ARTIQ v{}".format(artiq_version),

View File

@ -6,7 +6,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
.. Note that ARTIQ frontend has no docstrings and the ..automodule directives display nothing; they are there to make :mod: references function correctly, since sphinx-argparse does not support links to ..argparse directives in the same way. .. Note that ARTIQ frontend has no docstrings and the ..automodule directives display nothing; they are there to make :mod: references function correctly, since sphinx-argparse does not support links to ..argparse directives in the same way.
:mod:`artiq.frontend.artiq_run` :mod:`artiq.frontend.artiq_run`
-------------------------------- -------------------------------
.. automodule:: artiq.frontend.artiq_run .. automodule:: artiq.frontend.artiq_run
.. argparse:: .. argparse::
@ -17,7 +17,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
.. _frontend-artiq-master: .. _frontend-artiq-master:
:mod:`artiq.frontend.artiq_master` :mod:`artiq.frontend.artiq_master`
----------------------------------- ----------------------------------
.. automodule:: artiq.frontend.artiq_master .. automodule:: artiq.frontend.artiq_master
.. argparse:: .. argparse::
@ -28,7 +28,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
.. _frontend-artiq-client: .. _frontend-artiq-client:
:mod:`artiq.frontend.artiq_client` :mod:`artiq.frontend.artiq_client`
----------------------------------- ----------------------------------
.. automodule:: artiq.frontend.artiq_client .. automodule:: artiq.frontend.artiq_client
.. argparse:: .. argparse::
:ref: artiq.frontend.artiq_client.get_argparser :ref: artiq.frontend.artiq_client.get_argparser
@ -47,11 +47,31 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
:nodefault: :nodefault:
:mod:`artiq.frontend.artiq_browser` :mod:`artiq.frontend.artiq_browser`
------------------------------------ -----------------------------------
.. automodule:: artiq.frontend.artiq_browser .. automodule:: artiq.frontend.artiq_browser
.. argparse:: .. argparse::
:ref: artiq.frontend.artiq_browser.get_argparser :ref: artiq.frontend.artiq_browser.get_argparser
:prog: artiq_browser :prog: artiq_browser
:nodefault: :nodefault:
:mod:`artiq.frontend.artiq_session`
-----------------------------------
.. automodule:: artiq.frontend.artiq_session
.. argparse::
:ref: artiq.frontend.artiq_session.get_argparser
:prog: artiq_session
:nodefault:
:mod:`artiq_comtools.artiq_ctlmgr`
----------------------------------
ARTIQ controller manager. Supplied in the separate package ``artiq-comtools``, which is included with a standard ARTIQ installation but can also be `installed standalone <https://github.com/m-labs/artiq-comtools>`_, with the intention of making it easier to run controllers and controller managers on machines where a full ARTIQ installation may not be necessary or convenient.
.. automodule:: artiq_comtools.artiq_ctlmgr
.. argparse::
:ref: artiq_comtools.artiq_ctlmgr.get_argparser
:prog: artiq_ctlmgr
:nodescription:
:nodefault: