forked from GNOME/devhelp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
74 lines (43 loc) · 2.14 KB
/
README
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
How to compile newest version of devhelp in Ubuntu 13.10 64-bit using devhelp sources on github
================================================================================================
sudo apt-get update
sudo apt-get remove devhelp
sudo apt-get install gnome-common libwebkit2gtk-3.0-dev cdbs dh-translations gnome-pkg-tools libpython3-dev libpython3.3-dev libwebkit2gtk-3.0-dev libwebkit2gtk-3.0-25 python-scour python3-dev python3.3-dev libgconfmm-2.6-dev
sudo add-apt-repository ppa:gnome3-team/gnome3
sudo apt-get update
sudo apt-get build-dep devhelp
git clone https://github.com/GNOME/devhelp.git
cd devhelp
./autogen.sh
sudo make
sudo make install
Close all Terminal windows.
Open new Terminal window.
Check version of devhelp using this command:
devhelp -v
Devhelp extra information
===========================
Devhelp's primary goal is to be an API documentation browser for
GNOME. When you build (or install) a GNOME library, it will build an
API reference for you and install it into:
$datadir/gtk-doc/html/$PACKAGE.
Along with the HTML files, a .devhelp and/or .devhelp2 index file is
also generated automatically. Thus Devhelp can simply scan that folder
for those index files and display the books they represent.
Devhelp uses the "XDG Base Directory Specification" to find
documentation. You can read more about that specification here:
http://standards.freedesktop.org/basedir-spec/latest/
The list of locations searched for devhelp books is:
$XDG_DATA_HOME/devhelp/books
e.g. /home/ross/.local/share/devhelp/books/glib-2.0/glib-2.0.devhelp
$XDG_DATA_HOME/gtk-doc/html
e.g. /home/ross/.local/share/gtk-doc/html/glib-2.0/glib-2.0.devhelp
$XDG_DATA_DIRS/devhelp/books
e.g. /usr/local/share/devhelp/books/glib-2.0/glib-2.0.devhelp
$XDG_DATA_DIRS/gtk-doc/html
e.g. /usr/local/share/gtk-doc/html/glib-2.0/glib-2.0.devhelp
Note that the two latter consist of: separated lists of directories to
look for. Those environment variables are normally set up by the
desktop environment or distribution.
Note that the name of the directory the .devhelp file is in and the
name of the .devhelp file (minus the extension) must match.