mirror/freebsd
1
0
Fork 0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-15 10:17:20 +00:00
Code Issues Releases Activity

RELNOTESng infrastructure fixes:

Browse Source 
1.  There is now only one RELNOTESng stylesheet; the architecture-specific
stylesheets (to handle different values of the arch= attribute) are gone.

2.  Several Makefile variable definitions were factored into
doc.relnotes.mk.

Submitted by:	dd
This commit is contained in:
Bruce A. Mah 2001-05-02 22:02:50 +00:00
parent c9cd7283cf
commit 1eb55ff65d
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=76222
20 changed files with 23 additions and 105 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
release/doc/README
View File

@ -18,10 +18,17 @@ DOC_PREFIX Makefile variable. RELNOTESng also requires the DocProj
build tools, which can easily be installed with the textproc/docproj
port in the Ports Collection.
share/sgml/*.dsl
Architecture-dependent stylesheets. These stylesheets support
the arch= attribute on (all?) DocBook elements. Currently-
supported values are: i386, alpha.
share/mk/doc.relnotes.mk
Common Makefile definitions for RELNOTESng. These definitions
mostly accomodate the fact that we're building DocProj-like
documents outside the doc/ tree.
share/sgml/release.dsl
Language-neutral stylesheet. This stylesheet supports
the arch= attribute on (all?) DocBook elements; elements with
an arch= attribute are only included in the output if their
value is equal to the value of the &arch; entity. In the
future, arch= could be a list of possible &arch; entity values
that match, such as "i386,alpha".
share/sgml/release.ent
Release information. Need to update the entry definitions in
this file when rolling new revisions; these should take effect

1
release/doc/en_US.ISO8859-1/errata/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml

5
release/doc/en_US.ISO8859-1/hardware/alpha/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -16,9 +15,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/dev.sgml
SRCS+= ../common/config.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO8859-1/hardware/i386/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -16,9 +15,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/dev.sgml
SRCS+= ../common/config.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-i386.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-i386.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO8859-1/installation/alpha/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -17,9 +16,5 @@ SRCS+= ../common/layout.sgml
SRCS+= ../common/trouble.sgml
SRCS+= ../common/upgrade.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO8859-1/installation/i386/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -17,9 +16,5 @@ SRCS+= ../common/layout.sgml
SRCS+= ../common/trouble.sgml
SRCS+= ../common/upgrade.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-i386.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-i386.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

1
release/doc/en_US.ISO8859-1/readme/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
#
# SRCS lists the individual SGML files that make up the document. Changes

5
release/doc/en_US.ISO8859-1/relnotes/alpha/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -15,9 +14,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/new.sgml
SRCS+= ../common/upgrading.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO8859-1/relnotes/i386/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -15,9 +14,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/new.sgml
SRCS+= ../common/upgrading.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-i386.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-i386.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

1
release/doc/en_US.ISO_8859-1/errata/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml

5
release/doc/en_US.ISO_8859-1/hardware/alpha/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -16,9 +15,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/dev.sgml
SRCS+= ../common/config.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO_8859-1/hardware/i386/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -16,9 +15,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/dev.sgml
SRCS+= ../common/config.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-i386.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-i386.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO_8859-1/installation/alpha/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -17,9 +16,5 @@ SRCS+= ../common/layout.sgml
SRCS+= ../common/trouble.sgml
SRCS+= ../common/upgrade.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO_8859-1/installation/i386/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -17,9 +16,5 @@ SRCS+= ../common/layout.sgml
SRCS+= ../common/trouble.sgml
SRCS+= ../common/upgrade.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-i386.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-i386.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

1
release/doc/en_US.ISO_8859-1/readme/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
#
# SRCS lists the individual SGML files that make up the document. Changes

5
release/doc/en_US.ISO_8859-1/relnotes/alpha/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -15,9 +14,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/new.sgml
SRCS+= ../common/upgrading.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-alpha.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

5
release/doc/en_US.ISO_8859-1/relnotes/i386/Makefile
View File

@ -6,7 +6,6 @@ DOC?= article
FORMATS?= html
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# SGML content
SRCS+= article.sgml
@ -15,9 +14,5 @@ SRCS+= ../common/artheader.sgml
SRCS+= ../common/new.sgml
SRCS+= ../common/upgrading.sgml
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release-i386.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release-i386.dsl
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

7
release/doc/share/mk/doc.relnotes.mk
View File

@ -2,5 +2,12 @@
DOC_PREFIX?= ${RELN_ROOT}/../../../doc
# Find the RELNOTESng document catalog
EXTRA_CATALOGS+= ${RELN_ROOT}/share/sgml/catalog
# Use the appropriate architecture-dependent RELNOTESng stylesheet
DSLHTML?= ${RELN_ROOT}/share/sgml/release.dsl
DSLPRINT?= ${RELN_ROOT}/share/sgml/release.dsl
# XXX using /release/doc as anchor!
DESTDIR?= ${DOCDIR}/${.CURDIR:C/^.*\/release\/doc//}

32
release/doc/share/sgml/release-i386.dsl
View File

@ -1,32 +0,0 @@
<!-- $FreeBSD$ -->
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY freebsd.dsl PUBLIC "-//FreeBSD//DOCUMENT DocBook Stylesheet//EN" CDATA DSSSL>
]>
<style-sheet>
<style-specification use="docbook">
<style-specification-body>
; The architecture we're building for. We really need to pull this out of a
; entity somewhere, so it can be defined without needing to munge the
; stylesheet. Or do we?
(define for-arch "i386")
(default
(let* ((arch (attribute-string (normalize "arch"))))
(if (or (equal? arch #f)
(equal? arch ""))
(next-match)
; We can do a lot more flexible things here. Like it'd be nice to
; tokenize the arch= attribute and do comparisons of for-arch against
; different substrings.
(cond ((equal? arch for-arch) (next-match))
(else (empty-sosofo))))))
</style-specification-body>
</style-specification>
<external-specification id="docbook" document="freebsd.dsl">
</style-sheet>

10
release/doc/share/sgml/release-alpha.dsl → release/doc/share/sgml/release.dsl
View File

@ -8,13 +8,13 @@
<style-specification use="docbook">
<style-specification-body>
; The architecture we're building for. We really need to pull this out of a
; entity somewhere, so it can be defined without needing to munge the
; stylesheet. Or do we?
(define for-arch "alpha")
; The architecture we're building for. We need to define this as a
; procedure, because we may not be able to evaluate it until we are
; at a point in formatting where (current-node) is defined.
(default
(let* ((arch (attribute-string (normalize "arch"))))
(let* ((arch (attribute-string (normalize "arch")))
(for-arch (entity-text "arch")))
(if (or (equal? arch #f)
(equal? arch ""))
(next-match)