doc/user: use extlink for a common commit links

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
This commit is contained in:
Peter Hutterer 2018-08-01 17:12:38 +10:00
parent f611076551
commit 43ed999a1f
3 changed files with 9 additions and 5 deletions

View file

@ -41,6 +41,7 @@ release = '@PROJECT_VERSION@'
extensions = [
'sphinx.ext.mathjax',
'sphinx.ext.graphviz',
'sphinx.ext.extlinks',
]
# Add any paths that contain templates here, relative to this directory.
@ -168,3 +169,8 @@ from recommonmark.parser import CommonMarkParser
source_parsers = {
'.md': CommonMarkParser,
}
extlinks = { 'commit' :
('https://gitlab.freedesktop.org/libinput/libinput/commit/%s',
'git commit ')
}

View file

@ -68,5 +68,4 @@ file for the full license information.
.....
About
.....
Documentation generated from git commit
`__GIT_VERSION__ <https://gitlab.freedesktop.org/libinput/libinput/commit/__GIT_VERSION__>`_
Documentation generated from :commit:`__GIT_VERSION__`.

View file

@ -21,9 +21,8 @@ even though some hardware can distinguish between that many fingers.
Tap-to-click default setting
------------------------------------------------------------------------------
Tapping is **disabled** by default on most devices, see [this
commit](https://gitlab.freedesktop.org/libinput/libinput/commit/2219c12c3aa45b80f235e761e87c17fb9ec70eae)
because:
Tapping is **disabled** by default on most devices, see
:commit:`2219c12c3` because:
- if you don't know that tapping is a thing (or enabled by default), you get
spurious button events that make the desktop feel buggy.