1 # -*- python; coding: utf-8 -*-
3 # gtk-doc - GTK DocBook documentation generator.
4 # Copyright (C) 1998 Owen Taylor
5 # 2001-2005 Damon Chaplin
6 # 2009-2017 Stefan Sauer
9 # This program is free software; you can redistribute it and/or modify
10 # it under the terms of the GNU General Public License as published by
11 # the Free Software Foundation; either version 2 of the License, or
12 # (at your option) any later version.
14 # This program is distributed in the hope that it will be useful,
15 # but WITHOUT ANY WARRANTY; without even the implied warranty of
16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 # GNU General Public License for more details.
19 # You should have received a copy of the GNU General Public License
20 # along with this program; if not, write to the Free Software
21 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
34 def run_xsltproc(options
, args
):
35 command
= [config
.xsltproc
]
36 # we could do "$path_option $PWD " to avoid needing rewriting entities that
37 # are copied from the header into docs under xml
38 if os
.environ
.get("GTKDOC_PROFILE", '') == '':
39 for path
in options
.path
:
40 command
+= ['--path', path
]
41 logging
.info('running "%s"', ' '.join(command
+ args
))
42 return subprocess
.call(command
+ args
)
44 command
+= ['--profile']
45 for path
in options
.path
:
46 command
+= ['--path', path
]
47 logging
.info('running "%s"', ' '.join(command
+ args
))
48 return subprocess
.call(command
+ args
, stderr
=open('profile.txt', 'w'))
52 module
= options
.args
[0]
53 document
= options
.args
[1]
58 remaining_args
= options
.args
[2:]
60 if options
.uninstalled
:
61 # this does not work from buiddir!=srcdir
62 gtkdocdir
= os
.path
.split(sys
.argv
[0])[0]
63 if not os
.path
.exists(gtkdocdir
+ '/gtk-doc.xsl'):
64 # try to src dir (set from makefiles) too
65 if os
.path
.exists(os
.environ
.get("ABS_TOP_SRCDIR", '') + '/gtk-doc.xsl'):
66 gtkdocdir
= os
.environ
['ABS_TOP_SRCDIR']
67 styledir
= gtkdocdir
+ '/style'
69 gtkdocdir
= os
.path
.join(config
.datadir
, 'gtk-doc/data')
72 res
= run_xsltproc(options
, [
85 'chunker.output.quiet',
86 quiet
] + remaining_args
+ [gtkdocdir
+ '/gtk-doc.xsl', document
])
89 if os
.environ
.get("GTKDOC_PROFILE", '') != '':
90 subprocess
.check_call('cat profile.txt | gprof2dot.py -e 0.01 -n 0.01 | dot -Tpng -o profile.png', shell
=True)
92 # copy navigation images and stylesheets to html directory ...
93 for f
in glob(styledir
+ '/*.png') + glob(styledir
+ '/*.css'):
96 with
open('../html.stamp', 'w') as h
: