os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Indexterms should not be embedded directly into a question or answer

Browse source 
element but into a deeper paragraph, optimally right after the
  referenced word without spaces even [1] but somehow the schema allows
  badly nested indexterms.  Correct such entires in the whole documentation
  set.
- Add constraints to check for invalid indexterm entries.

See also: http://www.sagehill.net/docbookxsl/GenerateIndex.html#Indexterms [1]
This commit is contained in:
Gabor Kovesdan 2013-07-11 16:34:54 +00:00
parent 3c49cbd8e2
commit b0b78fa4e9
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=42247
39 changed files with 93 additions and 296 deletions
Download patch file Download diff file Expand all files Collapse all files

9
share/xml/freebsd.sch
View file

@ -74,6 +74,15 @@
</rule>
</pattern>
<pattern name="Check indexes">
<rule context="//question">
<report test="./indexterm">Indexterm is not allowed directly in question, place it into a concrete paragraph (in section <xsl:value-of select="(ancestor::sect5[last()]|ancestor::sect4[last()]|ancestor::sect3[last()]|ancestor::sect2[last()]|ancestor::sect1[last()]|ancestor::chapter[last()])[last()]/@id"/>).</report>
</rule>
<rule context="//answer">
<report test="./indexterm">Indexterm is not allowed directly in answer, place it into a concrete paragraph (in section <xsl:value-of select="(ancestor::sect5[last()]|ancestor::sect4[last()]|ancestor::sect3[last()]|ancestor::sect2[last()]|ancestor::sect1[last()]|ancestor::chapter[last()])[last()]/@id"/>).</report>
</rule>
</pattern>
<!--
Backported constraints from DocBook 5.0
-->