docs/src/Makefile

Sat, 28 Mar 2020 16:04:46 +0100

author
Mike Becker <universe@uap-core.de>
date
Sat, 28 Mar 2020 16:04:46 +0100
branch
feature/dav-edit
changeset 711
8d40b5ccc43e
parent 703
2e3a24b9896a
child 714
10a5d6ce0906
permissions
-rw-r--r--

adds check for encryption key (otherwise segfault when trying to create a fresh encrypted file without a key)

265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
1 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
2 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
3 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
4 # Copyright 2017 Olaf Wintermann. All rights reserved.
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
5 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
6 # Redistribution and use in source and binary forms, with or without
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
7 # modification, are permitted provided that the following conditions are met:
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
8 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
9 # 1. Redistributions of source code must retain the above copyright
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
10 # notice, this list of conditions and the following disclaimer.
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
11 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
12 # 2. Redistributions in binary form must reproduce the above copyright
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
13 # notice, this list of conditions and the following disclaimer in the
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
14 # documentation and/or other materials provided with the distribution.
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
15 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
16 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
17 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
18 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
19 # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
20 # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
21 # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
22 # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
23 # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
24 # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
25 # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
26 # POSSIBILITY OF SUCH DAMAGE.
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
27 #
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
28
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
29 PANDOC=pandoc
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
30 PFLAGS = -c davdoc.css -B header.html -A footer.html
562
78a25071ed88 adds missing make target dependencies for documentation
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
31 PDEPEND = header.html footer.html
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
32 PFLAGSMAN=-s -t man
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
33
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
34 SRC = getting-started.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
35 SRC += commands.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
36 SRC += list.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
37 SRC += get.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
38 SRC += put.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
39 SRC += mkdir.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
40 SRC += remove.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
41 SRC += copy.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
42 SRC += move.md
694
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
43 SRC += rename.md
407
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
44 SRC += export.md
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
45 SRC += import.md
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
46 SRC += get-property.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
47 SRC += set-property.md
320
12ed560c926c adds documentation for new features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 285
diff changeset
48 SRC += remove-property.md
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
49 SRC += lock.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
50 SRC += unlock.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
51 SRC += info.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
52 SRC += date.md
694
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
53 SRC += versioncontrol.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
54 SRC += list-versions.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
55 SRC += checkout.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
56 SRC += checkin.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
57 SRC += uncheckout.md
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
58 SRC += configuration.md
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
59 SRC += encryption.md
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
60 SRC += add-repository.md
407
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
61 SRC += remove-repository.md
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
62 SRC += list-repositories.md
694
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
63 SRC += repository-url.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
64 SRC += add-user.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
65 SRC += remove-user.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
66 SRC += edit-user.md
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
67 SRC += list-users.md
266
8c44c5919691 more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 265
diff changeset
68 SRC += check-config.md
273
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
69 SRC += introduction.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
70 SRC += sync-commands.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
71 SRC += pull.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
72 SRC += push.md
320
12ed560c926c adds documentation for new features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 285
diff changeset
73 SRC += archive.md
694
60edf3d679fd add empty documentation pages for all new commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 562
diff changeset
74 SRC += restore.md
562
78a25071ed88 adds missing make target dependencies for documentation
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
75 SRC += list-conflicts.md
273
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
76 SRC += resolve-conflicts.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
77 SRC += delete-conflicts.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
78 SRC += trash-info.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
79 SRC += empty-trash.md
407
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
80 SRC += add-tag.md
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
81 SRC += remove-tag.md
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
82 SRC += set-tags.md
9505224d2fd2 adds documentation for new dav features
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 320
diff changeset
83 SRC += list-tags.md
273
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
84 SRC += add-directory.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
85 SRC += list-directories.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
86 SRC += sync-check-config.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
87 SRC += check-repositories.md
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
88 SRC += sync-configuration.md
703
2e3a24b9896a update man pages
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 694
diff changeset
89 SRC += sync-list-versions.md
273
c743721d566f more documentation
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 266
diff changeset
90
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
91 SRCMAN = dav.1.md
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
92 SRCMAN += dav-sync.1.md
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
93
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
94 HTML = $(SRC:%.md=build/%.html)
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
95 MAN = $(SRCMAN:%.md=build/%.man)
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
96
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
97 DISTHTML = ../html
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
98 DISTMAN = ../man
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
99
285
02d3e4b1245f adds some small fixes for 1.0 release
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 276
diff changeset
100 FILES = build/davdoc.css build/index.html
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
101
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
102 all: doc manual
276
20a176d5a53e adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents: 275
diff changeset
103
20a176d5a53e adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents: 275
diff changeset
104 doc: build $(HTML) $(FILES)
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
105
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
106 manual: build $(MAN)
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
107
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
108 build:
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
109 mkdir -p build
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
110
562
78a25071ed88 adds missing make target dependencies for documentation
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
111 build/%.html: %.md $(PDEPEND)
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
112 $(PANDOC) $(PFLAGS) $< -o $@
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
113
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
114 build/%.man: %.md
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
115 $(PANDOC) $(PFLAGSMAN) $< -o $@
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
116
562
78a25071ed88 adds missing make target dependencies for documentation
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
117 build/davdoc.css: davdoc.css
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
118 cp davdoc.css build
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
119
562
78a25071ed88 adds missing make target dependencies for documentation
Mike Becker <universe@uap-core.de>
parents: 436
diff changeset
120 build/index.html: index.html
285
02d3e4b1245f adds some small fixes for 1.0 release
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 276
diff changeset
121 cp index.html build
02d3e4b1245f adds some small fixes for 1.0 release
Olaf Wintermann <olaf.wintermann@gmail.com>
parents: 276
diff changeset
122
436
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
123 dist: doc manual
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
124 rm -Rf $(DISTHTML) $(DISTMAN)
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
125 mkdir -p $(DISTHTML) $(DISTMAN)
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
126 cp build/*.html $(DISTHTML)/
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
127 cp build/*.css $(DISTHTML)/
daea53362170 adds draft man pages
Mike Becker <universe@uap-core.de>
parents: 407
diff changeset
128 cp build/*.man $(DISTMAN)/
275
fa48ab29abd2 adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents: 273
diff changeset
129
276
20a176d5a53e adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents: 275
diff changeset
130 clean:
265
ee9e63c437c4 adds documentation for most dav commands
Olaf Wintermann <olaf.wintermann@gmail.com>
parents:
diff changeset
131 rm -Rf build
276
20a176d5a53e adds more details to add-directory.md
Mike Becker <universe@uap-core.de>
parents: 275
diff changeset
132

mercurial