Skip to content
GitLab
Explore
Sign in
Register
Primary navigation
Search or go to…
Project
steam-runtime-tools
Manage
Activity
Members
Labels
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Analyze
Contributor analytics
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
steamrt
steam-runtime-tools
Commits
aa75e75b
Commit
aa75e75b
authored
7 years ago
by
Vivek Das Mohapatra
Browse files
Options
Downloads
Patches
Plain Diff
Generate man pages from gtk-doc generated devhelp xml
parent
7b24d4a4
No related branches found
No related tags found
1 merge request
!311
Build capsule-capture-libs from a bundled copy of libcapsule
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
doc/devhelp2man.xslt
+162
-0
162 additions, 0 deletions
doc/devhelp2man.xslt
documentation.mk
+15
-3
15 additions, 3 deletions
documentation.mk
with
177 additions
and
3 deletions
doc/devhelp2man.xslt
0 → 100644
+
162
−
0
View file @
aa75e75b
<xsl:stylesheet
version =
'1.0'
xmlns:xi=
"http://www.w3.org/2003/XInclude"
xmlns:xsl=
'http://www.w3.org/1999/XSL/Transform'
xmlns:saxon=
"http://icl.com/saxon"
xmlns:xslt=
"http://xml.apache.org/xslt"
xmlns:string=
"http://exslt.org/strings"
xmlns:ext=
"http://exslt.org/common"
extension-element-prefixes=
"saxon"
exclude-result-prefixes=
"xi"
>
<xsl:strip-space
elements=
"*"
/>
<xsl:output
omit-xml-declaration=
"yes"
indent=
"yes"
encoding=
"utf-8"
xslt:indent-amount=
"2"
/>
<xsl:template
match=
"node()|@*"
mode=
"description"
>
<xsl:apply-templates/>
</xsl:template>
<xsl:template
name=
"paramdesc"
match=
"refsect2[@role='function']"
mode=
"paramdesc"
>
<xsl:param
name=
"matched"
select=
"indexterm/primary"
/>
<xsl:if
test=
"$matched = $target"
>
<xsl:element
name=
"title"
>
Parameters:
</xsl:element>
<xsl:element
name=
"variablelist"
>
<xsl:for-each
select=
"refsect3[@role='parameters']//row"
>
<xsl:element
name=
"varlistentry"
>
<xsl:element
name=
"term"
>
<xsl:element
name=
"code"
>
<xsl:value-of
select=
"concat(entry[@role='parameter_name'], ': ')"
/>
</xsl:element>
</xsl:element>
<xsl:element
name=
"listitem"
>
<xsl:element
name=
"para"
>
<xsl:value-of
select=
"entry[@role='parameter_description']"
/>
</xsl:element>
</xsl:element>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:if>
</xsl:template>
<xsl:template
name=
"retdesc"
match=
"refsect2[@role='function']"
mode=
"retdesc"
>
<xsl:param
name=
"matched"
select=
"indexterm/primary"
/>
<xsl:if
test=
"$matched = $target"
>
<xsl:for-each
select=
"refsect3[@role='returns']/*"
>
<xsl:copy-of
select=
"."
/>
</xsl:for-each>
</xsl:if>
</xsl:template>
<!-- //////////////////////////////////////////////////////// -->
<xsl:template
match=
"node()|@*"
name=
"ignore"
>
<xsl:apply-templates/>
</xsl:template>
<xsl:template
match=
"entry[@role='function_name']/link"
name=
"refnamediv"
>
<xsl:param
name=
"matched"
select=
"."
/>
<xsl:if
test=
"$matched = $target"
>
<xsl:element
name=
"refname"
>
<xsl:value-of
select=
"."
/>
</xsl:element>
<xsl:apply-templates/>
</xsl:if>
</xsl:template>
<xsl:template
name=
"paramdef"
match=
"parameter"
>
<xsl:param
name=
"tok"
select=
"string:tokenize(., ' ')"
/>
<xsl:param
name=
"last"
select=
"ext:node-set($tok)[last()]"
/>
<xsl:param
name=
"name"
select=
"string:tokenize($last, '*')"
/>
<xsl:param
name=
"stars"
select=
"substring-before($last, $name)"
/>
<xsl:element
name=
"paramdef"
>
<xsl:for-each
select=
"ext:node-set($tok)[position() != last()]"
>
<xsl:value-of
select=
"concat(., ' ')"
/>
</xsl:for-each>
<xsl:value-of
select=
"$stars"
/>
<xsl:element
name=
"parameter"
>
<xsl:value-of
select=
"$name"
/>
</xsl:element>
</xsl:element>
</xsl:template>
<xsl:template
name=
"funcproto"
match=
"refsect2[@role='function']"
>
<xsl:param
name=
"matched"
select=
"indexterm/primary"
/>
<xsl:if
test=
"$matched = $target"
>
<xsl:element
name=
"funcprototype"
>
<xsl:element
name=
"funcdef"
>
<xsl:value-of
select=
"concat(substring-before(programlisting,'
'), ' ')"
/>
<xsl:element
name=
"function"
>
<xsl:value-of
select=
"indexterm/primary"
/>
</xsl:element>
</xsl:element>
<xsl:apply-templates
select=
"programlisting"
/>
</xsl:element>
</xsl:if>
</xsl:template>
<xsl:template
name=
"voiddesc"
match=
"refsect2[@role='function']"
mode=
"voiddesc"
>
<xsl:param
name=
"matched"
select=
"indexterm/primary"
/>
<xsl:if
test=
"$matched = $target"
>
<xsl:for-each
select=
"para"
>
<xsl:copy-of
select=
"."
/>
</xsl:for-each>
</xsl:if>
</xsl:template>
<xsl:template
match=
"/refentry"
name=
"top"
>
<xsl:element
name=
"refentry"
>
<xsl:attribute
name=
"id"
><xsl:value-of
select=
"@id"
/></xsl:attribute>
<xsl:element
name=
"refentryinfo"
>
<xsl:element
name=
"productname"
>
libcapsule
</xsl:element>
<xsl:element
name=
"authorgroup"
>
<xsl:element
name=
"contrib"
>
Author
</xsl:element>
<xsl:element
name=
"firstname"
>
Vivek
</xsl:element>
<xsl:element
name=
"surname"
>
Das Mohapatra
</xsl:element>
</xsl:element>
</xsl:element>
<xsl:element
name=
"refmeta"
>
<xsl:element
name=
"refentrytitle"
>
<!-- xsl:value-of select="/refentry/refmeta/refentrytitle"/ -->
<xsl:value-of
select=
"$target"
/>
</xsl:element>
<xsl:element
name=
"manvolnum"
>
<xsl:value-of
select=
"/refentry/refmeta/manvolnum"
/>
</xsl:element>
<xsl:element
name=
"refmiscinfo"
>
<xsl:attribute
name=
"class"
>
manual
</xsl:attribute>
<xsl:value-of
select=
"normalize-space(refmeta/refmiscinfo)"
/>
</xsl:element>
</xsl:element>
<xsl:element
name=
"refnamediv"
>
<xsl:apply-templates
select=
"refsect1[@role='functions_proto']"
/>
</xsl:element>
<xsl:element
name=
"refsynopsisdiv"
>
<xsl:element
name=
"funcsynopsis"
>
<xsl:element
name=
"funcsynopsisinfo"
>
<xsl:value-of
select=
"$fsinfo"
/>
</xsl:element>
</xsl:element>
<xsl:apply-templates
select=
"refsect1[@role='details']"
/>
</xsl:element>
<xsl:element
name=
"refsect1"
>
<xsl:element
name=
"title"
>
Description:
</xsl:element>
<xsl:apply-templates
select=
"refsect1[@role='details']/refsect2"
mode=
"voiddesc"
/>
<xsl:element
name=
"refsect2"
>
<xsl:apply-templates
select=
"refsect1[@role='details']/refsect2"
mode=
"paramdesc"
/>
</xsl:element>
<xsl:element
name=
"refsect2"
>
<xsl:apply-templates
select=
"refsect1[@role='details']/refsect2"
mode=
"retdesc"
/>
</xsl:element>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
This diff is collapsed.
Click to expand it.
documentation.mk
+
15
−
3
View file @
aa75e75b
...
@@ -10,12 +10,24 @@ XSLTPROC_FLAGS = \
...
@@ -10,12 +10,24 @@ XSLTPROC_FLAGS = \
XSLT_DOMAIN
=
docbook.sourceforge.net
XSLT_DOMAIN
=
docbook.sourceforge.net
XSLT_MAN
=
http://
$(
XSLT_DOMAIN
)
/release/xsl/current/manpages/docbook.xsl
XSLT_MAN
=
http://
$(
XSLT_DOMAIN
)
/release/xsl/current/manpages/docbook.xsl
XSLT_CAPARGS
=
--stringparam
fsinfo
"
\#
include <capsule.h>"
--stringparam
target
XSLTPROC_STD
=
$(
XSLTPROC
)
$(
XSLTPROC_FLAGS
)
%.1
:
doc/%.xml
%.1
:
doc/%.xml
$(
AM_V_GEN
)
$(
XSLTPROC
)
$(
XSLTPROC_FLAGS
)
$(
XSLT_MAN
)
$<
$(
AM_V_GEN
)
$(
XSLTPROC
_STD
)
$(
XSLT_MAN
)
$<
%.3
:
xml/%.xml docs
xml/capsule.xml
:
docs
$(
AM_V_GEN
)
$(
XSLTPROC
)
$(
XSLTPROC_FLAGS
)
$(
XSLT_MAN
)
$<
%.3.xml
:
xml/capsule.xml doc/devhelp2man.xslt
$(
AM_V_GEN
)
$(
XSLTPROC_STD
)
$(
XSLT_CAPARGS
)
$*
doc/devhelp2man.xslt
$<
>
$@
%.3
:
%.3.xml
$(
AM_V_GEN
)
$(
XSLTPROC_STD
)
$(
XSLT_MAN
)
$<
man_MANS
=
capsule-init-project.1 capsule-mkstublib.1
man_MANS
=
capsule-init-project.1 capsule-mkstublib.1
man_MANS
+=
capsule_dlmopen.3
man_MANS
+=
capsule_init.3
man_MANS
+=
capsule_relocate.3
man_MANS
+=
capsule_shim_dlopen.3
CLEANFILES
+=
$(
man_MANS
)
CLEANFILES
+=
$(
man_MANS
)
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment