geemili
/
drm
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
drm/man/Makefile.am

68 lines
1.6 KiB
Makefile
Raw Normal View History

man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
#
# This generates man-pages out of the Docbook XML files. Simply add your files
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
# to the relevant *man_PRE array. If aliases are created, please add them to the
# *man_aliases_PRE array so they get installed correctly.
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
#
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
libman_PRE = \
drmAvailable.xml \
drmHandleEvent.xml \
drmModeGetResources.xml
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
miscman_PRE = \
drm.xml \
drm-kms.xml \
drm-memory.xml
man: Fix typo and use $() for make expressions Due to the typo, none of the .xml files would end up in the release tarball and cause make distcheck as well as builds from the tarball to fail. Using $() isn't strictly necessary but other variables and expressions use that variant already so it makes the usage consistent. Reviewed-by: David Herrmann <dh.herrmann@googlemail.com> Signed-off-by: Thierry Reding <thierry.reding@avionic-design.de>
2013-01-18 05:22:01 -07:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
miscman_aliases_PRE = \
drm-mm.xml \
drm-gem.xml \
drm-ttm.xml
libmandir = $(LIB_MAN_DIR)
miscmandir = $(MISC_MAN_DIR)
miscman_aliasesdir = $(MISC_MAN_DIR)
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
libman_DATA = $(libman_PRE:.xml=.$(LIB_MAN_SUFFIX))
miscman_DATA = $(miscman_PRE:.xml=.$(MISC_MAN_SUFFIX))
miscman_aliases_DATA = $(miscman_aliases_PRE:.xml=.$(MISC_MAN_SUFFIX))
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
XML_FILES = \
$(libman_PRE) \
$(miscman_PRE)
MAN_FILES = \
$(libman_DATA) \
$(miscman_DATA) \
$(miscman_aliases_DATA)
EXTRA_DIST = $(XML_FILES)
CLEANFILES = $(MAN_FILES) .man_fixup
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
XSLTPROC_FLAGS = \
--stringparam man.authors.section.enabled 0 \
--stringparam man.copyright.section.enabled 0 \
--stringparam funcsynopsis.style ansi \
man: fix manpage build instructions This fixes all the out-of-tree build-failures with manpages and uses a .man_fixup file to avoid overriding man-pages on every build. Manpages are only built if xsltproc is found and the stylesheets are available locally. You can disable building manpages with --disable-manpages so the quite expensive xsltproc procedure can be skipped. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2013-01-16 11:35:25 -07:00
--stringparam man.output.quietly 1 \
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
--nonet \
$(MANPAGES_STYLESHEET)
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
XSLTPROC_PROCESS_MAN = \
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
$(AM_V_GEN)$(XSLTPROC) -o "$@" $(XSLTPROC_FLAGS) "$<" && \
man: fix manpage build instructions This fixes all the out-of-tree build-failures with manpages and uses a .man_fixup file to avoid overriding man-pages on every build. Manpages are only built if xsltproc is found and the stylesheets are available locally. You can disable building manpages with --disable-manpages so the quite expensive xsltproc procedure can be skipped. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2013-01-16 11:35:25 -07:00
touch .man_fixup
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
# Force .man_fixup if $(miscman_DATA) are not built
.man_fixup: | $(miscman_DATA)
$(AM_V_GEN)touch .man_fixup
man: fix manpage build instructions This fixes all the out-of-tree build-failures with manpages and uses a .man_fixup file to avoid overriding man-pages on every build. Manpages are only built if xsltproc is found and the stylesheets are available locally. You can disable building manpages with --disable-manpages so the quite expensive xsltproc procedure can be skipped. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2013-01-16 11:35:25 -07:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
$(miscman_aliases_DATA): $(miscman_DATA) .man_fixup
man: fix manpage build instructions This fixes all the out-of-tree build-failures with manpages and uses a .man_fixup file to avoid overriding man-pages on every build. Manpages are only built if xsltproc is found and the stylesheets are available locally. You can disable building manpages with --disable-manpages so the quite expensive xsltproc procedure can be skipped. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2013-01-16 11:35:25 -07:00
$(AM_V_GEN)if test -n "$@" ; then $(SED) -i -e 's/^\.so \([a-z_]\+\)\.\([0-9]\)$$/\.so man\2\/\1\.\2/' "$@" ; fi
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
SUFFIXES = .$(LIB_MAN_SUFFIX) .$(MISC_MAN_SUFFIX) .xml
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
.xml.$(LIB_MAN_SUFFIX):
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
$(XSLTPROC_PROCESS_MAN)
man: rework the Makefile.am Remove GNU make specific constructs and take into consideration that Solaris man 7 is not the same as Linux man 7. This commit introduces a dependency of xorg-macros 1.12 (released 4+ years ago) which is used to handle the above man section discrepancies. Cc: Niveditha Rau <niveditha.rau@oracle.com> Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
2015-04-06 12:02:38 -06:00
.xml.$(MISC_MAN_SUFFIX):
man: convert manpages to XML instead of plain troff If we want to use the manpages in external documentation other than normal manpages, we should rather use XML. Furthermore, almost no-one knows troff today, anyway, and XML allows others to easily add more pages without having to learn troff. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-09-28 15:44:19 -06:00
$(XSLTPROC_PROCESS_MAN)