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
parent
95f22197
Please register or sign in to comment