From 5d7c93a3d167ebe2ae0a5c256d7f25cd76316c6d Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Wed, 27 Mar 2019 15:18:20 +1000 Subject: [PATCH] doc/api: improve readability of the API docs Still not great and probably makes any professional designer's eyes bleed, but at least it's more readable now. Changes: - spacing after param name so they don't cuddle up with the description - color changes and background image removals to drop the doxygen default look - font size changes to not make things overrun - font family change to make the function prototypes readable Signed-off-by: Peter Hutterer --- doc/api/style/libinputdoxygen.css | 53 +++++++++++++++++++++++++++++++++++++-- src/libinput.h | 2 +- 2 files changed, 52 insertions(+), 3 deletions(-) diff --git a/doc/api/style/libinputdoxygen.css b/doc/api/style/libinputdoxygen.css index b1e8bd7..0d04630 100644 --- a/doc/api/style/libinputdoxygen.css +++ b/doc/api/style/libinputdoxygen.css @@ -1,14 +1,23 @@ +@import url("https://fonts.googleapis.com/css?family=Roboto+Mono"); + dd { margin-left: 30px; } .title { - font-size: 400%; - font-weight: 200; + font-size: 200%; + font-weight: bold; +} + +.title .ingroups { + font-size: 200%; } h1 { font-size: 300%; + background-image: none; + background-color: #D6E5FF; + padding-left: 10px; } h2 { @@ -45,3 +54,43 @@ h2 { #main-menu li ul { display: none; } + +.paramname { + padding-right: 10px; +} + +.memtitle { + background-image: none; + background-color: #F0F0F0; +} + +.memproto { + background-color: #F0F0F0; +} + +.headertitle { + background-image: none; + background-color: #F0F0F0; +} + +td.fieldname { + font-family: 'Roboto Mono', monospace; +} + +.fieldtable th { + background-image: none; + background-color: #F0F0F0; +} + +body { + letter-spacing: 0px; +} + +.mdescLeft, .mdescRight, .memItemLeft, .memItemRight, .memTemplItemLeft, .memTemplItemRight, .memTemplParams { + background-color: #F0F0F0; +} + +a { + color: #2873b0; + +} diff --git a/src/libinput.h b/src/libinput.h index 74c3078..01cdf73 100644 --- a/src/libinput.h +++ b/src/libinput.h @@ -2400,7 +2400,7 @@ libinput_event_tablet_tool_get_time_usec(struct libinput_event_tablet_tool *even * mapped to an eraser-like virtual tool. * * If supported by the hardware, a more specific tool id is always - * available, see * libinput_tablet_tool_get_tool_id(). + * available, see libinput_tablet_tool_get_tool_id(). * * @param tool The libinput tool * @return The tool type for this tool object -- 2.7.4