summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorlouiz’ <louiz@louiz.org>2018-09-22 16:59:13 +0200
committerlouiz’ <louiz@louiz.org>2018-09-22 16:59:13 +0200
commit1a194a292e12c1f752afabe5a0bdc3b76706ee06 (patch)
tree6ac6ac68c285cc966350a85917143842ec4bb335 /doc
parentbf97478b89b24bbf3a6a92c9137041cf2e987f02 (diff)
downloadbiboumi-1a194a292e12c1f752afabe5a0bdc3b76706ee06.tar.gz
biboumi-1a194a292e12c1f752afabe5a0bdc3b76706ee06.tar.bz2
biboumi-1a194a292e12c1f752afabe5a0bdc3b76706ee06.tar.xz
biboumi-1a194a292e12c1f752afabe5a0bdc3b76706ee06.zip
Diffstat (limited to 'doc')
-rw-r--r--doc/CMakeLists.txt37
-rw-r--r--doc/Makefile20
-rw-r--r--doc/admin.rst7
-rw-r--r--doc/conf.py.cmake (renamed from doc/conf.py)9
-rw-r--r--doc/contributing.rst2
-rw-r--r--doc/user.rst2
6 files changed, 48 insertions, 29 deletions
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
new file mode 100644
index 0000000..100550a
--- /dev/null
+++ b/doc/CMakeLists.txt
@@ -0,0 +1,37 @@
+cmake_minimum_required(VERSION 3.0)
+
+project(biboumi_doc NONE)
+
+include("../version.cmake")
+
+set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_CURRENT_SOURCE_DIR}/../cmake/Modules/")
+find_package(SPHINX)
+
+if(SPHINX_FOUND)
+ configure_file(conf.py.cmake conf.py)
+
+ set(SPHINX_BUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/_build")
+
+ set(HTML_OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR}/html)
+ set(MAN_OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR}/man)
+ set(MAN_OUTPUT ${MAN_OUTPUT_DIR}/biboumi.1 PARENT_SCOPE)
+ set(MAN_OUTPUT ${MAN_OUTPUT_DIR}/biboumi.1)
+ message("${CMAKE_CURRENT_BINARY_DIR}")
+ add_custom_command(OUTPUT ${HTML_OUTPUT_DIR}
+ COMMAND ${SPHINX_BIN}
+ -b html -q
+ -c ${CMAKE_CURRENT_BINARY_DIR}
+ ${CMAKE_CURRENT_SOURCE_DIR}
+ ${HTML_OUTPUT_DIR})
+ add_custom_command(OUTPUT ${MAN_OUTPUT}
+ WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+ COMMAND ${SPHINX_BIN}
+ -b man -q
+ -c ${CMAKE_CURRENT_BINARY_DIR}
+ ${CMAKE_CURRENT_SOURCE_DIR}
+ ${MAN_OUTPUT_DIR})
+ add_custom_target(doc ALL
+ DEPENDS ${HTML_OUTPUT_DIR} ${MAN_OUTPUT})
+else()
+ add_custom_target(doc COMMAND ${CMAKE_COMMAND} -E echo "sphinx-build is required to build the doc")
+endif()
diff --git a/doc/Makefile b/doc/Makefile
deleted file mode 100644
index 934bdf7..0000000
--- a/doc/Makefile
+++ /dev/null
@@ -1,20 +0,0 @@
-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS =
-SPHINXBUILD = sphinx-build
-SPHINXPROJ = biboumi
-SOURCEDIR = .
-BUILDDIR = _build
-
-# Put it first so that "make" without argument is like "make help".
-help:
- @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-.PHONY: help Makefile
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
- @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) \ No newline at end of file
diff --git a/doc/admin.rst b/doc/admin.rst
index a5850a7..b51e13b 100644
--- a/doc/admin.rst
+++ b/doc/admin.rst
@@ -10,7 +10,7 @@ background for as long as it is needed. Note that biboumi does not
daemonize itself, this task should be done by your init system (SysVinit,
systemd, upstart).
-When started, biboumi connects, without encryption (see :ref:`Security`), to the
+When started, biboumi connects, without encryption (see :ref:`security`), to the
local XMPP server on the port ``5347`` and authenticates with the provided
password. Biboumi then serves the configured ``hostname``: this means that
all XMPP stanza with a `to` JID on that domain will be forwarded to biboumi
@@ -34,7 +34,7 @@ Configuration happens in different places, with different purposes:
configuration, and this is described in the next section.
- A TLS configuration, also admin-only, that can be either global or
per-domain. See `TLS configuration`_ section.
-- Using the :ref:`ad-hoc commands`, each user can configure various
+- Using the :ref:`ad-hoc-commands`, each user can configure various
settings for themself
Daemon configuration
@@ -157,7 +157,7 @@ If it is set to false (the default value), all rooms are not persistent by
default.
Each room can be configured individually by each user, to override this
-default value. See :ref:`Ad-hoc commands`.
+default value. See :ref:`ad-hoc-commands`.
realname_customization
~~~~~~~~~~~~~~~~~~~~~~
@@ -277,6 +277,7 @@ the certificate validity at all. The default value is true.
By default, biboumi provides a few policy files, to work around some
issues found with a few well-known IRC servers.
+.. _security:
Security
========
diff --git a/doc/conf.py b/doc/conf.py.cmake
index e3f0e02..22707fe 100644
--- a/doc/conf.py
+++ b/doc/conf.py.cmake
@@ -24,9 +24,9 @@ copyright = '2018, Florent Le Coz'
author = 'Florent Le Coz'
# The short X.Y version
-version = '8.3'
+version = '${biboumi_VERSION_MAJOR}.${biboumi_VERSION_MINOR}'
# The full version, including alpha/beta/rc tags
-release = '8.3'
+release = version + '${biboumi_VERSION_TWEAK}'
# -- General configuration ---------------------------------------------------
@@ -40,7 +40,6 @@ release = '8.3'
# ones.
extensions = [
'sphinx.ext.coverage',
- 'sphinx.ext.autosectionlabel',
]
# Add any paths that contain templates here, relative to this directory.
@@ -87,7 +86,7 @@ html_theme = 'sphinx_rtd_theme'
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []
# Custom sidebar templates, must be a dictionary that maps document names
# to template names.
@@ -140,7 +139,7 @@ latex_documents = [
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
- (master_doc, 'biboumi', 'biboumi Documentation',
+ ('admin', 'biboumi', 'Administrator documentation',
[author], 1)
]
diff --git a/doc/contributing.rst b/doc/contributing.rst
index ee499fc..5d63b5d 100644
--- a/doc/contributing.rst
+++ b/doc/contributing.rst
@@ -91,7 +91,7 @@ Please try to follow the existing style:
- Use only spaces, not tabs.
- Curly brackets are on their own lines.
- Use this-> everywhere it’s possible.
-- Don’t start class attributes with “m_” or similar.
+- Don’t start class attributes with `m_` or similar.
- Type names are in PascalCase.
- Everything else is in snake_case.
diff --git a/doc/user.rst b/doc/user.rst
index 505e3b9..0405606 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -330,6 +330,8 @@ Affiliation set to ``admin``
Affiliation set to ``owner``
Sets mode to +a-q
+.. _ad-hoc-commands:
+
Ad-hoc commands
---------------