mirror of
https://gitlab.freedesktop.org/wayland/wayland.git
synced 2025-11-27 06:59:51 -05:00
doc: clarify how ClientAPI.xml is built
I found the comment a bit confusing and it's quite hard to read. re-explain with a simple step-by-step list Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
This commit is contained in:
parent
dcb402a2c2
commit
ee569711ee
1 changed files with 6 additions and 3 deletions
|
|
@ -36,9 +36,12 @@ en-US/ProtocolInterfaces.xml: $(top_srcdir)/protocol/wayland.xml $(srcdir)/proto
|
||||||
$(AM_V_GEN)$(XSLTPROC) $(srcdir)/protocol-interfaces-to-docbook.xsl \
|
$(AM_V_GEN)$(XSLTPROC) $(srcdir)/protocol-interfaces-to-docbook.xsl \
|
||||||
$(top_srcdir)/protocol/wayland.xml > en-US/ProtocolInterfaces.xml
|
$(top_srcdir)/protocol/wayland.xml > en-US/ProtocolInterfaces.xml
|
||||||
|
|
||||||
# WaylandClientAPI.xml is generated after combining all xml in one single file
|
# WaylandClientAPI.xml:
|
||||||
# with the exception of wayland-client_8h.xml that is omitted to not duplicate
|
# * we don't want wayland-client_8h.xml to avoid duplicating output methods,
|
||||||
# the output methods.
|
# move it out of the way first.
|
||||||
|
# * use doxygen's combine.xslt to merge the xml files into one single file
|
||||||
|
# * move wayland-client_8h.xml back to its original location
|
||||||
|
# * transform the combined XML file into docbook format
|
||||||
en-US/WaylandClientAPI.xml: $(top_builddir)/doc/doxygen/xml/index.xml $(srcdir)/doxygen-to-publican.xsl
|
en-US/WaylandClientAPI.xml: $(top_builddir)/doc/doxygen/xml/index.xml $(srcdir)/doxygen-to-publican.xsl
|
||||||
$(AM_V_GEN)$(MKDIR_P) en-US/images
|
$(AM_V_GEN)$(MKDIR_P) en-US/images
|
||||||
$(AM_V_GEN)mv $(top_builddir)/doc/doxygen/xml/wayland-client_8h.xml \
|
$(AM_V_GEN)mv $(top_builddir)/doc/doxygen/xml/wayland-client_8h.xml \
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue