path: root/release/doc/share/mk/doc.relnotes.mk
diff options
authorSimon L. B. Nielsen <simon@FreeBSD.org>2004-08-03 22:12:45 +0000
committerSimon L. B. Nielsen <simon@FreeBSD.org>2004-08-03 22:12:45 +0000
commit4e702f5b140c8ab63afe07df4dd882310fc639be (patch)
tree201c61c13fdbfc870db0edc4181601f660590220 /release/doc/share/mk/doc.relnotes.mk
parentfdae98ecd6e3978107418c01d896c6d37b0e2821 (diff)
Auto generate the device listings in the Hardware Notes based on
manual pages, to avoid duplicating work between the Hardware Notes and manual pages. Each text line in the output from the manual page parser is generated as a SGML entity, making it possible for translators to only translate lines which actually contains English text (this neat idea came from hrs). To determine which drivers are usable on which architectures the dev.archlist.txt file is used to explicitly list this. It it an imperfect solution, but the best I have been able to come up with for now. This commit converts most of the devices which has a section 4 manual page with a HARDWARE section to be the new auto generated format. Reviewed in principle by: ru, hrs, trhodes Good ideas for improvements: hrs No objections: -doc, re
Notes: svn path=/head/; revision=133094
Diffstat (limited to 'release/doc/share/mk/doc.relnotes.mk')
1 files changed, 21 insertions, 0 deletions
diff --git a/release/doc/share/mk/doc.relnotes.mk b/release/doc/share/mk/doc.relnotes.mk
index 0335640342c1..da5dbc042735 100644
--- a/release/doc/share/mk/doc.relnotes.mk
+++ b/release/doc/share/mk/doc.relnotes.mk
@@ -26,3 +26,24 @@ JADEFLAGS+= -iinclude.historic
JADEFLAGS+= -ino.include.historic
+# Automatic device list generation:
+.if exists(${RELN_ROOT}/../man4)
+MAN4DIR?= ${RELN_ROOT}/../man4
+.elif exists(${RELN_ROOT}/../../man4)
+MAN4DIR?= ${RELN_ROOT}/../../man4
+MAN4DIR?= ${RELN_ROOT}/../../share/man/man4
+MAN4PAGES?= ${MAN4DIR}/*.4 ${MAN4DIR}/man4.*/*.4
+ARCHLIST?= ${RELN_ROOT}/share/misc/dev.archlist.txt
+DEV-AUTODIR= ${RELN_ROOT:S/${.CURDIR}/${.OBJDIR}/}/share/sgml
+CLEANFILES+= ${DEV-AUTODIR}/dev-auto.sgml ${DEV-AUTODIR}/catalog-auto
+# Dependency that the article makefiles can use to pull in
+# dev-auto.sgml.
+${DEV-AUTODIR}/catalog-auto ${DEV-AUTODIR}/dev-auto.sgml: ${MAN4PAGES} \
+ ${ARCHLIST} ${RELN_ROOT}/share/misc/man2hwnotes.pl
+ cd ${RELN_ROOT}/share/sgml && make dev-auto.sgml