]> git.ipfire.org Git - thirdparty/apache/httpd.git/commit
doc xsl/dtd: introduce idtype attribute for directivesynopsis
authorLuca Toscano <elukey@apache.org>
Fri, 18 Aug 2017 08:21:43 +0000 (08:21 +0000)
committerLuca Toscano <elukey@apache.org>
Fri, 18 Aug 2017 08:21:43 +0000 (08:21 +0000)
commit50c86e4f2c95c1939cb5534039e4d4e7063c0434
tree44f40f40f53767239ede0bf37329bd1696fa5c0e
parente3c1a0de84c57bf63d190e7e19e665c98969b50f
doc xsl/dtd: introduce idtype attribute for directivesynopsis

In r1805193 synopsis.xsl was changed to allow two directives
of different type (like <SSLPolicy> and SSLPolicy) to share
the same name but have different ids (and please validate-xml/xhtml).
The downside of this action was that all the quicklinks to
existing directive sections (like <If>, <VirtualHost>, etc..)
were changed, possibly breaking external clients already
referencing them.

This change introduces a new attribute in the directivesynopsis
DTD, namely 'idtype', that will be appended to 'name'
in the id generation by synopsis.xsl. This will rollback
link names to their previous values and will allow documentators
to fine tune directivesynopsis sections as they need
(for example we have recently introduced mod_md's
ManagedDomain/<ManagedDomain>, and modssl's SSLPolicy/<SSLPolicy>).

This approach seems more precise and less invasive to me.
Of course the name of the attribute can be changed later on
to whatever term would fit best, the main concern for me at
the moment is to restore the trunk documentation to its previous
state.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1805372 13f79535-47bb-0310-9956-ffa450edef68
docs/manual/style/modulesynopsis.dtd
docs/manual/style/xsl/common.xsl
docs/manual/style/xsl/synopsis.xsl