summaryrefslogtreecommitdiff
path: root/doc/Makefile.am
blob: 5391f225cd1386ee12b43d8a573f74a02cd79133 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
EXTRA_DIST = \
	     middle-button-emulation.svg \
	     touchpad-tap-state-machine.svg \
	     touchpad-softbutton-state-machine.svg

header_files = \
	$(top_srcdir)/src/libinput.h \
	$(top_srcdir)/README.md \
	$(srcdir)/absolute-axes.dox \
	$(srcdir)/absolute-coordinate-ranges.dox \
	$(srcdir)/building.dox \
	$(srcdir)/clickpad-softbuttons.dox \
	$(srcdir)/contributing.dox \
	$(srcdir)/device-configuration-via-udev.dox \
	$(srcdir)/faqs.dox \
	$(srcdir)/gestures.dox \
	$(srcdir)/middle-button-emulation.dox \
	$(srcdir)/normalization-of-relative-motion.dox \
	$(srcdir)/palm-detection.dox \
	$(srcdir)/page-hierarchy.dox \
	$(srcdir)/pointer-acceleration.dox \
	$(srcdir)/reporting-bugs.dox \
	$(srcdir)/scrolling.dox \
	$(srcdir)/seats.dox \
	$(srcdir)/switches.dox \
	$(srcdir)/t440-support.dox \
	$(srcdir)/tablet-support.dox \
	$(srcdir)/tapping.dox \
	$(srcdir)/test-suite.dox \
	$(srcdir)/tools.dox \
	$(srcdir)/touchpad-jumping-cursors.dox \
	$(srcdir)/touchpad-pressure.dox \
	$(srcdir)/touchpads.dox \
	$(srcdir)/what-is-libinput.dox

diagram_files = \
	$(srcdir)/dot/seats-sketch.gv \
	$(srcdir)/dot/seats-sketch-libinput.gv \
	$(srcdir)/dot/libinput-stack-wayland.gv \
	$(srcdir)/dot/libinput-stack-xorg.gv \
	$(srcdir)/dot/libinput-stack-gnome.gv \
	$(srcdir)/dot/evemu.gv \
	$(srcdir)/svg/button-scrolling.svg \
	$(srcdir)/svg/clickfinger.svg \
	$(srcdir)/svg/clickfinger-distance.svg \
	$(srcdir)/svg/edge-scrolling.svg \
	$(srcdir)/svg/gesture-2fg-ambiguity.svg \
	$(srcdir)/svg/palm-detection.svg \
	$(srcdir)/svg/pinch-gestures.svg \
	$(srcdir)/svg/pinch-gestures-softbuttons.svg \
	$(srcdir)/svg/ptraccel-linear.svg \
	$(srcdir)/svg/ptraccel-low-dpi.svg \
	$(srcdir)/svg/ptraccel-touchpad.svg \
	$(srcdir)/svg/ptraccel-trackpoint.svg \
	$(srcdir)/svg/software-buttons.svg \
	$(srcdir)/svg/swipe-gestures.svg \
	$(srcdir)/svg/tablet-axes.svg \
	$(srcdir)/svg/tablet-cintiq24hd-modes.svg \
	$(srcdir)/svg/tablet-interfaces.svg \
	$(srcdir)/svg/tablet-intuos-modes.svg \
	$(srcdir)/svg/tablet-left-handed.svg \
	$(srcdir)/svg/tablet-out-of-bounds.svg \
	$(srcdir)/svg/tablet.svg \
	$(srcdir)/svg/tap-n-drag.svg \
	$(srcdir)/svg/thumb-detection.svg \
	$(srcdir)/svg/top-software-buttons.svg \
	$(srcdir)/svg/touchscreen-gestures.svg \
	$(srcdir)/svg/twofinger-scrolling.svg

style_files = \
	      style/header.html \
	      style/footer.html \
	      style/customdoxygen.css \
	      style/bootstrap.css \
	      style/libinputdoxygen.css

if BUILD_DOCS

noinst_DATA = html/index.html

html/index.html: libinput.doxygen $(header_files) $(diagram_files) $(style_files)
	$(AM_V_GEN)(cat $<; \
          echo "INPUT = $(header_files)"; \
          ) | $(DOXYGEN) -

clean-local:
	$(AM_V_at)rm -rf html

doc_src= $(shell find html -type f -printf "html/%P\n" 2>/dev/null)
EXTRA_DIST += $(builddir)/html/index.html \
	      $(doc_src)
endif

EXTRA_DIST += $(diagram_files) \
	      $(header_files) \
	      $(style_files)

local_svg = $(shell find $(srcdir)/svg -type f -printf "$(srcdir)/svg/%P\n" 2>/dev/null)
local_dotfiles = $(shell find $(srcdir)/dot -type f -printf "$(srcdir)/dot/%P\n" 2>/dev/null)

check:
	@files=`echo $(local_svg) $(local_dotfiles) $(diagram_files) | tr ' ' '\n' | sort | uniq -u` && \
		test -z "$$files" || (\
		echo "SVG/dotfiles files present but missing from the Makefile.am:" && \
		echo "$$files" && \
		test)

# make sure doc was built before running dist
dist-hook:
	@test -f $(distdir)/html/index.html || (\
		echo "******************************************************" && \
		echo "Couldn't find documentation files, refusing make dist." && \
		echo "Install doxygen to build documentation for the tarball." && \
		echo "******************************************************" && \
		test )