booky 0.0.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (1557) hide show
  1. data/.gitignore +4 -0
  2. data/Gemfile +4 -0
  3. data/README.textile +18 -0
  4. data/Rakefile +2 -0
  5. data/bin/booky +6 -0
  6. data/booky.gemspec +24 -0
  7. data/lib/booky/docbook.rb +13 -0
  8. data/lib/booky/fo.rb +15 -0
  9. data/lib/booky/fonts.rb +104 -0
  10. data/lib/booky/pdf.rb +19 -0
  11. data/lib/booky/version.rb +3 -0
  12. data/lib/booky.rb +101 -0
  13. data/lib/custom_fonts.xml +91 -0
  14. data/lib/fonts/Ubuntu-B.ttf +0 -0
  15. data/lib/fonts/Ubuntu-BI.ttf +0 -0
  16. data/lib/fonts/Ubuntu-L.ttf +0 -0
  17. data/lib/fonts/Ubuntu-LI.ttf +0 -0
  18. data/lib/fonts/Ubuntu-M.ttf +0 -0
  19. data/lib/fonts/Ubuntu-MI.ttf +0 -0
  20. data/lib/fonts/Ubuntu-R.ttf +0 -0
  21. data/lib/fonts/Ubuntu-RI.ttf +0 -0
  22. data/lib/fop/KEYS +248 -0
  23. data/lib/fop/LICENSE +202 -0
  24. data/lib/fop/NOTICE +10 -0
  25. data/lib/fop/README +286 -0
  26. data/lib/fop/build/fop.jar +0 -0
  27. data/lib/fop/conf/fop.xconf +464 -0
  28. data/lib/fop/fop +254 -0
  29. data/lib/fop/fop.bat +85 -0
  30. data/lib/fop/fop.cmd +75 -0
  31. data/lib/fop/fop.js +341 -0
  32. data/lib/fop/lib/README.txt +243 -0
  33. data/lib/fop/lib/avalon-framework-4.2.0.jar +0 -0
  34. data/lib/fop/lib/avalon-framework.LICENSE.txt +175 -0
  35. data/lib/fop/lib/avalon-framework.NOTICE.TXT +11 -0
  36. data/lib/fop/lib/batik-all-1.7.jar +0 -0
  37. data/lib/fop/lib/batik.LICENSE.txt +201 -0
  38. data/lib/fop/lib/batik.NOTICE.txt +18 -0
  39. data/lib/fop/lib/commons-io-1.3.1.jar +0 -0
  40. data/lib/fop/lib/commons-io.LICENSE.txt +203 -0
  41. data/lib/fop/lib/commons-io.NOTICE.txt +6 -0
  42. data/lib/fop/lib/commons-logging-1.0.4.jar +0 -0
  43. data/lib/fop/lib/commons-logging.LICENSE.txt +202 -0
  44. data/lib/fop/lib/commons-logging.NOTICE.txt +3 -0
  45. data/lib/fop/lib/jeuclid-core-3.1.9.jar +0 -0
  46. data/lib/fop/lib/jeuclid-fop-3.1.9.jar +0 -0
  47. data/lib/fop/lib/serializer-2.7.0.jar +0 -0
  48. data/lib/fop/lib/serializer.LICENSE.txt +201 -0
  49. data/lib/fop/lib/serializer.NOTICE.txt +15 -0
  50. data/lib/fop/lib/xalan-2.7.0.jar +0 -0
  51. data/lib/fop/lib/xalan.BCEL.LICENSE.txt +52 -0
  52. data/lib/fop/lib/xalan.LICENSE.txt +202 -0
  53. data/lib/fop/lib/xalan.NOTICE.txt +44 -0
  54. data/lib/fop/lib/xalan.regexp.LICENSE.txt +52 -0
  55. data/lib/fop/lib/xalan.runtime.LICENSE.txt +20 -0
  56. data/lib/fop/lib/xerces.LICENSE.txt +56 -0
  57. data/lib/fop/lib/xercesImpl-2.7.1.jar +0 -0
  58. data/lib/fop/lib/xercesImpl.LICENSE.txt +201 -0
  59. data/lib/fop/lib/xercesImpl.NOTICE.txt +14 -0
  60. data/lib/fop/lib/xml-apis-1.3.04.jar +0 -0
  61. data/lib/fop/lib/xml-apis-ext-1.3.04.jar +0 -0
  62. data/lib/fop/lib/xml-apis-ext.LICENSE.dom-documentation.txt +73 -0
  63. data/lib/fop/lib/xml-apis-ext.LICENSE.dom-software.txt +61 -0
  64. data/lib/fop/lib/xml-apis-ext.LICENSE.sac.html +75 -0
  65. data/lib/fop/lib/xml-apis-ext.LICENSE.txt +202 -0
  66. data/lib/fop/lib/xml-apis-ext.NOTICE.txt +16 -0
  67. data/lib/fop/lib/xml-apis-ext.README.dom.txt +56 -0
  68. data/lib/fop/lib/xml-apis.LICENSE-SAX.html +17 -0
  69. data/lib/fop/lib/xml-apis.LICENSE.DOM-documentation.html +74 -0
  70. data/lib/fop/lib/xml-apis.LICENSE.DOM-software.html +66 -0
  71. data/lib/fop/lib/xml-apis.LICENSE.txt +201 -0
  72. data/lib/fop/lib/xml-apis.NOTICE.txt +13 -0
  73. data/lib/fop/lib/xmlgraphics-commons-1.4.jar +0 -0
  74. data/lib/fop/lib/xmlgraphics-commons.LICENSE.txt +202 -0
  75. data/lib/fop/lib/xmlgraphics-commons.NOTICE.txt +5 -0
  76. data/lib/fop/status.xml +1809 -0
  77. data/lib/params.pdf +0 -0
  78. data/lib/stylesheets/.CatalogManager.properties.example +61 -0
  79. data/lib/stylesheets/.urilist +1 -0
  80. data/lib/stylesheets/AUTHORS +4 -0
  81. data/lib/stylesheets/BUGS +21 -0
  82. data/lib/stylesheets/COPYING +47 -0
  83. data/lib/stylesheets/INSTALL +88 -0
  84. data/lib/stylesheets/Makefile +89 -0
  85. data/lib/stylesheets/NEWS +139 -0
  86. data/lib/stylesheets/NEWS.html +25 -0
  87. data/lib/stylesheets/NEWS.xml +145 -0
  88. data/lib/stylesheets/README +166 -0
  89. data/lib/stylesheets/RELEASE-NOTES.html +8353 -0
  90. data/lib/stylesheets/RELEASE-NOTES.pdf +24340 -11
  91. data/lib/stylesheets/RELEASE-NOTES.txt +8575 -0
  92. data/lib/stylesheets/RELEASE-NOTES.xml +10327 -0
  93. data/lib/stylesheets/TODO +23 -0
  94. data/lib/stylesheets/VERSION +115 -0
  95. data/lib/stylesheets/catalog.xml +8 -0
  96. data/lib/stylesheets/common/addns.xsl +118 -0
  97. data/lib/stylesheets/common/af.xml +1229 -0
  98. data/lib/stylesheets/common/am.xml +1229 -0
  99. data/lib/stylesheets/common/ar.xml +1229 -0
  100. data/lib/stylesheets/common/as.xml +660 -0
  101. data/lib/stylesheets/common/ast.xml +660 -0
  102. data/lib/stylesheets/common/autoidx-kimber.xsl +45 -0
  103. data/lib/stylesheets/common/autoidx-kosek.xsl +155 -0
  104. data/lib/stylesheets/common/az.xml +672 -0
  105. data/lib/stylesheets/common/bg.xml +724 -0
  106. data/lib/stylesheets/common/bn.xml +1229 -0
  107. data/lib/stylesheets/common/bn_in.xml +660 -0
  108. data/lib/stylesheets/common/bs.xml +662 -0
  109. data/lib/stylesheets/common/ca.xml +660 -0
  110. data/lib/stylesheets/common/charmap.xml +185 -0
  111. data/lib/stylesheets/common/charmap.xsl +222 -0
  112. data/lib/stylesheets/common/common.xml +622 -0
  113. data/lib/stylesheets/common/common.xsl +2040 -0
  114. data/lib/stylesheets/common/cs.xml +700 -0
  115. data/lib/stylesheets/common/cy.xml +1245 -0
  116. data/lib/stylesheets/common/da.xml +664 -0
  117. data/lib/stylesheets/common/de.xml +666 -0
  118. data/lib/stylesheets/common/el.xml +729 -0
  119. data/lib/stylesheets/common/en.xml +1230 -0
  120. data/lib/stylesheets/common/entities.ent +67 -0
  121. data/lib/stylesheets/common/eo.xml +1229 -0
  122. data/lib/stylesheets/common/es.xml +676 -0
  123. data/lib/stylesheets/common/et.xml +1229 -0
  124. data/lib/stylesheets/common/eu.xml +1229 -0
  125. data/lib/stylesheets/common/fa.xml +660 -0
  126. data/lib/stylesheets/common/fi.xml +670 -0
  127. data/lib/stylesheets/common/fr.xml +690 -0
  128. data/lib/stylesheets/common/ga.xml +1229 -0
  129. data/lib/stylesheets/common/gentext.xsl +840 -0
  130. data/lib/stylesheets/common/gl.xml +1229 -0
  131. data/lib/stylesheets/common/gu.xml +660 -0
  132. data/lib/stylesheets/common/he.xml +1229 -0
  133. data/lib/stylesheets/common/hi.xml +660 -0
  134. data/lib/stylesheets/common/hr.xml +662 -0
  135. data/lib/stylesheets/common/hu.xml +678 -0
  136. data/lib/stylesheets/common/id.xml +1229 -0
  137. data/lib/stylesheets/common/insertfile.xsl +113 -0
  138. data/lib/stylesheets/common/is.xml +672 -0
  139. data/lib/stylesheets/common/it.xml +1229 -0
  140. data/lib/stylesheets/common/ja.xml +660 -0
  141. data/lib/stylesheets/common/ka.xml +700 -0
  142. data/lib/stylesheets/common/kn.xml +1229 -0
  143. data/lib/stylesheets/common/ko.xml +1229 -0
  144. data/lib/stylesheets/common/ky.xml +732 -0
  145. data/lib/stylesheets/common/l10n.dtd +64 -0
  146. data/lib/stylesheets/common/l10n.xml +77 -0
  147. data/lib/stylesheets/common/l10n.xsl +594 -0
  148. data/lib/stylesheets/common/la.xml +1229 -0
  149. data/lib/stylesheets/common/labels.xsl +888 -0
  150. data/lib/stylesheets/common/lt.xml +678 -0
  151. data/lib/stylesheets/common/lv.xml +1229 -0
  152. data/lib/stylesheets/common/ml.xml +660 -0
  153. data/lib/stylesheets/common/mn.xml +730 -0
  154. data/lib/stylesheets/common/mr.xml +660 -0
  155. data/lib/stylesheets/common/nb.xml +1229 -0
  156. data/lib/stylesheets/common/nds.xml +666 -0
  157. data/lib/stylesheets/common/nl.xml +660 -0
  158. data/lib/stylesheets/common/nn.xml +1229 -0
  159. data/lib/stylesheets/common/olink.xsl +1227 -0
  160. data/lib/stylesheets/common/or.xml +1229 -0
  161. data/lib/stylesheets/common/pa.xml +660 -0
  162. data/lib/stylesheets/common/pi.xml +168 -0
  163. data/lib/stylesheets/common/pi.xsl +347 -0
  164. data/lib/stylesheets/common/pl.xml +678 -0
  165. data/lib/stylesheets/common/pt.xml +1229 -0
  166. data/lib/stylesheets/common/pt_br.xml +1229 -0
  167. data/lib/stylesheets/common/refentry.xml +781 -0
  168. data/lib/stylesheets/common/refentry.xsl +1353 -0
  169. data/lib/stylesheets/common/ro.xml +1229 -0
  170. data/lib/stylesheets/common/ru.xml +726 -0
  171. data/lib/stylesheets/common/sk.xml +1229 -0
  172. data/lib/stylesheets/common/sl.xml +1229 -0
  173. data/lib/stylesheets/common/sq.xml +1229 -0
  174. data/lib/stylesheets/common/sr.xml +720 -0
  175. data/lib/stylesheets/common/sr_Latn.xml +679 -0
  176. data/lib/stylesheets/common/subtitles.xsl +156 -0
  177. data/lib/stylesheets/common/sv.xml +664 -0
  178. data/lib/stylesheets/common/ta.xml +660 -0
  179. data/lib/stylesheets/common/table.xsl +515 -0
  180. data/lib/stylesheets/common/targetdatabase.dtd +49 -0
  181. data/lib/stylesheets/common/targets.xsl +334 -0
  182. data/lib/stylesheets/common/te.xml +660 -0
  183. data/lib/stylesheets/common/th.xml +1229 -0
  184. data/lib/stylesheets/common/titles.xsl +806 -0
  185. data/lib/stylesheets/common/tl.xml +1229 -0
  186. data/lib/stylesheets/common/tr.xml +666 -0
  187. data/lib/stylesheets/common/uk.xml +726 -0
  188. data/lib/stylesheets/common/utility.xml +259 -0
  189. data/lib/stylesheets/common/utility.xsl +291 -0
  190. data/lib/stylesheets/common/vi.xml +1229 -0
  191. data/lib/stylesheets/common/xh.xml +1229 -0
  192. data/lib/stylesheets/common/zh.xml +660 -0
  193. data/lib/stylesheets/common/zh_cn.xml +660 -0
  194. data/lib/stylesheets/common/zh_tw.xml +660 -0
  195. data/lib/stylesheets/docsrc/authors.xml +10 -0
  196. data/lib/stylesheets/docsrc/copyright.xml +18 -0
  197. data/lib/stylesheets/docsrc/license.xml +23 -0
  198. data/lib/stylesheets/docsrc/page.png +0 -0
  199. data/lib/stylesheets/docsrc/reference.css +79 -0
  200. data/lib/stylesheets/docsrc/reference.xml +229 -0
  201. data/lib/stylesheets/docsrc/reference.xml.included +33905 -0
  202. data/lib/stylesheets/docsrc/warranty.xml +11 -0
  203. data/lib/stylesheets/eclipse/eclipse.xsl +294 -0
  204. data/lib/stylesheets/eclipse/eclipse3.xsl +112 -0
  205. data/lib/stylesheets/eclipse/profile-eclipse.xsl +268 -0
  206. data/lib/stylesheets/epub/README +88 -0
  207. data/lib/stylesheets/epub/bin/dbtoepub +76 -0
  208. data/lib/stylesheets/epub/bin/lib/docbook.rb +227 -0
  209. data/lib/stylesheets/epub/bin/xslt/obfuscate.xsl +14 -0
  210. data/lib/stylesheets/epub/docbook.xsl +1678 -0
  211. data/lib/stylesheets/extensions/LICENSE.txt +264 -0
  212. data/lib/stylesheets/extensions/NOTICE.txt +12 -0
  213. data/lib/stylesheets/extensions/README.LIBXSLT +52 -0
  214. data/lib/stylesheets/extensions/README.txt +4 -0
  215. data/lib/stylesheets/extensions/docbook.py +239 -0
  216. data/lib/stylesheets/extensions/lucene-analyzers-3.0.0.jar +0 -0
  217. data/lib/stylesheets/extensions/lucene-core-3.0.0.jar +0 -0
  218. data/lib/stylesheets/extensions/saxon65.jar +0 -0
  219. data/lib/stylesheets/extensions/webhelpindexer.jar +0 -0
  220. data/lib/stylesheets/extensions/xalan27.jar +0 -0
  221. data/lib/stylesheets/extensions/xslt.py +84 -0
  222. data/lib/stylesheets/fo/admon.xsl +132 -0
  223. data/lib/stylesheets/fo/annotations.xsl +20 -0
  224. data/lib/stylesheets/fo/autoidx-kimber.xsl +173 -0
  225. data/lib/stylesheets/fo/autoidx-kosek.xsl +140 -0
  226. data/lib/stylesheets/fo/autoidx-ng.xsl +22 -0
  227. data/lib/stylesheets/fo/autoidx.xsl +1331 -0
  228. data/lib/stylesheets/fo/autotoc.xsl +917 -0
  229. data/lib/stylesheets/fo/axf.xsl +112 -0
  230. data/lib/stylesheets/fo/biblio-iso690.xsl +1302 -0
  231. data/lib/stylesheets/fo/biblio.xsl +1171 -0
  232. data/lib/stylesheets/fo/block.xsl +656 -0
  233. data/lib/stylesheets/fo/callout.xsl +232 -0
  234. data/lib/stylesheets/fo/component.xsl +900 -0
  235. data/lib/stylesheets/fo/division.xsl +614 -0
  236. data/lib/stylesheets/fo/docbook.xsl +333 -0
  237. data/lib/stylesheets/fo/ebnf.xsl +326 -0
  238. data/lib/stylesheets/fo/fo-rtf.xsl +155 -0
  239. data/lib/stylesheets/fo/fo.xsl +119 -0
  240. data/lib/stylesheets/fo/footnote.xsl +221 -0
  241. data/lib/stylesheets/fo/fop.xsl +95 -0
  242. data/lib/stylesheets/fo/fop1.xsl +225 -0
  243. data/lib/stylesheets/fo/formal.xsl +644 -0
  244. data/lib/stylesheets/fo/glossary.xsl +1170 -0
  245. data/lib/stylesheets/fo/graphics.xsl +649 -0
  246. data/lib/stylesheets/fo/highlight.xsl +78 -0
  247. data/lib/stylesheets/fo/htmltbl.xsl +427 -0
  248. data/lib/stylesheets/fo/index.xsl +486 -0
  249. data/lib/stylesheets/fo/info.xsl +36 -0
  250. data/lib/stylesheets/fo/inline.xsl +1289 -0
  251. data/lib/stylesheets/fo/keywords.xsl +23 -0
  252. data/lib/stylesheets/fo/lists.xsl +1395 -0
  253. data/lib/stylesheets/fo/math.xsl +141 -0
  254. data/lib/stylesheets/fo/pagesetup.xsl +2571 -0
  255. data/lib/stylesheets/fo/param.xml +12445 -0
  256. data/lib/stylesheets/fo/param.xsl +969 -0
  257. data/lib/stylesheets/fo/passivetex.xsl +38 -0
  258. data/lib/stylesheets/fo/pdf2index +140 -0
  259. data/lib/stylesheets/fo/pi.xml +1002 -0
  260. data/lib/stylesheets/fo/pi.xsl +1093 -0
  261. data/lib/stylesheets/fo/profile-docbook.xsl +288 -0
  262. data/lib/stylesheets/fo/ptc.xsl +79 -0
  263. data/lib/stylesheets/fo/qandaset.xsl +397 -0
  264. data/lib/stylesheets/fo/refentry.xsl +640 -0
  265. data/lib/stylesheets/fo/sections.xsl +766 -0
  266. data/lib/stylesheets/fo/spaces.xsl +276 -0
  267. data/lib/stylesheets/fo/synop.xsl +1009 -0
  268. data/lib/stylesheets/fo/table.xml +135 -0
  269. data/lib/stylesheets/fo/table.xsl +1682 -0
  270. data/lib/stylesheets/fo/task.xsl +93 -0
  271. data/lib/stylesheets/fo/titlepage.templates.xml +1354 -0
  272. data/lib/stylesheets/fo/titlepage.templates.xsl +5186 -0
  273. data/lib/stylesheets/fo/titlepage.xsl +769 -0
  274. data/lib/stylesheets/fo/toc.xsl +334 -0
  275. data/lib/stylesheets/fo/verbatim.xsl +466 -0
  276. data/lib/stylesheets/fo/xep.xsl +182 -0
  277. data/lib/stylesheets/fo/xref.xsl +1539 -0
  278. data/lib/stylesheets/highlighting/README +16 -0
  279. data/lib/stylesheets/highlighting/c-hl.xml +101 -0
  280. data/lib/stylesheets/highlighting/common.xsl +121 -0
  281. data/lib/stylesheets/highlighting/cpp-hl.xml +150 -0
  282. data/lib/stylesheets/highlighting/csharp-hl.xml +187 -0
  283. data/lib/stylesheets/highlighting/delphi-hl.xml +200 -0
  284. data/lib/stylesheets/highlighting/ini-hl.xml +45 -0
  285. data/lib/stylesheets/highlighting/java-hl.xml +117 -0
  286. data/lib/stylesheets/highlighting/javascript-hl.xml +147 -0
  287. data/lib/stylesheets/highlighting/m2-hl.xml +90 -0
  288. data/lib/stylesheets/highlighting/myxml-hl.xml +116 -0
  289. data/lib/stylesheets/highlighting/perl-hl.xml +120 -0
  290. data/lib/stylesheets/highlighting/php-hl.xml +149 -0
  291. data/lib/stylesheets/highlighting/python-hl.xml +100 -0
  292. data/lib/stylesheets/highlighting/ruby-hl.xml +109 -0
  293. data/lib/stylesheets/highlighting/tcl-hl.xml +180 -0
  294. data/lib/stylesheets/highlighting/xslthl-config.xml +46 -0
  295. data/lib/stylesheets/html/admon.xsl +136 -0
  296. data/lib/stylesheets/html/annotations.xsl +171 -0
  297. data/lib/stylesheets/html/autoidx-kimber.xsl +166 -0
  298. data/lib/stylesheets/html/autoidx-kosek.xsl +121 -0
  299. data/lib/stylesheets/html/autoidx-ng.xsl +22 -0
  300. data/lib/stylesheets/html/autoidx.xsl +740 -0
  301. data/lib/stylesheets/html/autotoc.xsl +709 -0
  302. data/lib/stylesheets/html/biblio-iso690.xsl +1302 -0
  303. data/lib/stylesheets/html/biblio.xsl +1255 -0
  304. data/lib/stylesheets/html/block.xsl +540 -0
  305. data/lib/stylesheets/html/callout.xsl +202 -0
  306. data/lib/stylesheets/html/changebars.xsl +123 -0
  307. data/lib/stylesheets/html/chunk-changebars.xsl +100 -0
  308. data/lib/stylesheets/html/chunk-code.xsl +672 -0
  309. data/lib/stylesheets/html/chunk-common.xsl +1921 -0
  310. data/lib/stylesheets/html/chunk.xsl +53 -0
  311. data/lib/stylesheets/html/chunker.xsl +440 -0
  312. data/lib/stylesheets/html/chunkfast.xsl +73 -0
  313. data/lib/stylesheets/html/chunktoc.xsl +541 -0
  314. data/lib/stylesheets/html/component.xsl +427 -0
  315. data/lib/stylesheets/html/division.xsl +219 -0
  316. data/lib/stylesheets/html/docbook.css.xml +109 -0
  317. data/lib/stylesheets/html/docbook.xsl +468 -0
  318. data/lib/stylesheets/html/ebnf.xsl +330 -0
  319. data/lib/stylesheets/html/footnote.xsl +314 -0
  320. data/lib/stylesheets/html/formal.xsl +427 -0
  321. data/lib/stylesheets/html/glossary.xsl +493 -0
  322. data/lib/stylesheets/html/graphics.xsl +1516 -0
  323. data/lib/stylesheets/html/highlight.xsl +87 -0
  324. data/lib/stylesheets/html/html-rtf.xsl +336 -0
  325. data/lib/stylesheets/html/html.xsl +614 -0
  326. data/lib/stylesheets/html/htmltbl.xsl +137 -0
  327. data/lib/stylesheets/html/index.xsl +290 -0
  328. data/lib/stylesheets/html/info.xsl +45 -0
  329. data/lib/stylesheets/html/inline.xsl +1491 -0
  330. data/lib/stylesheets/html/keywords.xsl +37 -0
  331. data/lib/stylesheets/html/lists.xsl +1185 -0
  332. data/lib/stylesheets/html/maketoc.xsl +87 -0
  333. data/lib/stylesheets/html/manifest.xsl +23 -0
  334. data/lib/stylesheets/html/math.xsl +271 -0
  335. data/lib/stylesheets/html/oldchunker.xsl +203 -0
  336. data/lib/stylesheets/html/onechunk.xsl +38 -0
  337. data/lib/stylesheets/html/param.xml +10905 -0
  338. data/lib/stylesheets/html/param.xsl +436 -0
  339. data/lib/stylesheets/html/pi.xml +1113 -0
  340. data/lib/stylesheets/html/pi.xsl +1264 -0
  341. data/lib/stylesheets/html/profile-chunk-code.xsl +614 -0
  342. data/lib/stylesheets/html/profile-chunk.xsl +53 -0
  343. data/lib/stylesheets/html/profile-docbook.xsl +412 -0
  344. data/lib/stylesheets/html/profile-onechunk.xsl +38 -0
  345. data/lib/stylesheets/html/qandaset.xsl +438 -0
  346. data/lib/stylesheets/html/refentry.xsl +301 -0
  347. data/lib/stylesheets/html/sections.xsl +617 -0
  348. data/lib/stylesheets/html/synop.xsl +1556 -0
  349. data/lib/stylesheets/html/table.xsl +1201 -0
  350. data/lib/stylesheets/html/task.xsl +78 -0
  351. data/lib/stylesheets/html/titlepage.templates.xml +708 -0
  352. data/lib/stylesheets/html/titlepage.templates.xsl +3818 -0
  353. data/lib/stylesheets/html/titlepage.xsl +1049 -0
  354. data/lib/stylesheets/html/toc.xsl +352 -0
  355. data/lib/stylesheets/html/verbatim.xsl +411 -0
  356. data/lib/stylesheets/html/xref.xsl +1378 -0
  357. data/lib/stylesheets/htmlhelp/htmlhelp-common.xsl +1108 -0
  358. data/lib/stylesheets/htmlhelp/htmlhelp.xsl +23 -0
  359. data/lib/stylesheets/htmlhelp/profile-htmlhelp-common.xsl +1082 -0
  360. data/lib/stylesheets/htmlhelp/profile-htmlhelp.xsl +23 -0
  361. data/lib/stylesheets/images/annot-close.png +0 -0
  362. data/lib/stylesheets/images/annot-open.png +0 -0
  363. data/lib/stylesheets/images/blank.png +0 -0
  364. data/lib/stylesheets/images/callouts/1.gif +0 -0
  365. data/lib/stylesheets/images/callouts/1.png +0 -0
  366. data/lib/stylesheets/images/callouts/1.svg +15 -0
  367. data/lib/stylesheets/images/callouts/10.gif +0 -0
  368. data/lib/stylesheets/images/callouts/10.png +0 -0
  369. data/lib/stylesheets/images/callouts/10.svg +18 -0
  370. data/lib/stylesheets/images/callouts/11.gif +0 -0
  371. data/lib/stylesheets/images/callouts/11.png +0 -0
  372. data/lib/stylesheets/images/callouts/11.svg +16 -0
  373. data/lib/stylesheets/images/callouts/12.gif +0 -0
  374. data/lib/stylesheets/images/callouts/12.png +0 -0
  375. data/lib/stylesheets/images/callouts/12.svg +18 -0
  376. data/lib/stylesheets/images/callouts/13.gif +0 -0
  377. data/lib/stylesheets/images/callouts/13.png +0 -0
  378. data/lib/stylesheets/images/callouts/13.svg +20 -0
  379. data/lib/stylesheets/images/callouts/14.gif +0 -0
  380. data/lib/stylesheets/images/callouts/14.png +0 -0
  381. data/lib/stylesheets/images/callouts/14.svg +17 -0
  382. data/lib/stylesheets/images/callouts/15.gif +0 -0
  383. data/lib/stylesheets/images/callouts/15.png +0 -0
  384. data/lib/stylesheets/images/callouts/15.svg +19 -0
  385. data/lib/stylesheets/images/callouts/16.svg +20 -0
  386. data/lib/stylesheets/images/callouts/17.svg +17 -0
  387. data/lib/stylesheets/images/callouts/18.svg +21 -0
  388. data/lib/stylesheets/images/callouts/19.svg +20 -0
  389. data/lib/stylesheets/images/callouts/2.gif +0 -0
  390. data/lib/stylesheets/images/callouts/2.png +0 -0
  391. data/lib/stylesheets/images/callouts/2.svg +17 -0
  392. data/lib/stylesheets/images/callouts/20.svg +20 -0
  393. data/lib/stylesheets/images/callouts/21.svg +18 -0
  394. data/lib/stylesheets/images/callouts/22.svg +20 -0
  395. data/lib/stylesheets/images/callouts/23.svg +22 -0
  396. data/lib/stylesheets/images/callouts/24.svg +19 -0
  397. data/lib/stylesheets/images/callouts/25.svg +21 -0
  398. data/lib/stylesheets/images/callouts/26.svg +22 -0
  399. data/lib/stylesheets/images/callouts/27.svg +19 -0
  400. data/lib/stylesheets/images/callouts/28.svg +23 -0
  401. data/lib/stylesheets/images/callouts/29.svg +22 -0
  402. data/lib/stylesheets/images/callouts/3.gif +0 -0
  403. data/lib/stylesheets/images/callouts/3.png +0 -0
  404. data/lib/stylesheets/images/callouts/3.svg +19 -0
  405. data/lib/stylesheets/images/callouts/30.svg +22 -0
  406. data/lib/stylesheets/images/callouts/4.gif +0 -0
  407. data/lib/stylesheets/images/callouts/4.png +0 -0
  408. data/lib/stylesheets/images/callouts/4.svg +16 -0
  409. data/lib/stylesheets/images/callouts/5.gif +0 -0
  410. data/lib/stylesheets/images/callouts/5.png +0 -0
  411. data/lib/stylesheets/images/callouts/5.svg +18 -0
  412. data/lib/stylesheets/images/callouts/6.gif +0 -0
  413. data/lib/stylesheets/images/callouts/6.png +0 -0
  414. data/lib/stylesheets/images/callouts/6.svg +19 -0
  415. data/lib/stylesheets/images/callouts/7.gif +0 -0
  416. data/lib/stylesheets/images/callouts/7.png +0 -0
  417. data/lib/stylesheets/images/callouts/7.svg +16 -0
  418. data/lib/stylesheets/images/callouts/8.gif +0 -0
  419. data/lib/stylesheets/images/callouts/8.png +0 -0
  420. data/lib/stylesheets/images/callouts/8.svg +20 -0
  421. data/lib/stylesheets/images/callouts/9.gif +0 -0
  422. data/lib/stylesheets/images/callouts/9.png +0 -0
  423. data/lib/stylesheets/images/callouts/9.svg +19 -0
  424. data/lib/stylesheets/images/caution.gif +0 -0
  425. data/lib/stylesheets/images/caution.png +0 -0
  426. data/lib/stylesheets/images/caution.svg +25 -0
  427. data/lib/stylesheets/images/caution.tif +0 -0
  428. data/lib/stylesheets/images/colorsvg/caution.svg +141 -0
  429. data/lib/stylesheets/images/colorsvg/home.svg +498 -0
  430. data/lib/stylesheets/images/colorsvg/important.svg +239 -0
  431. data/lib/stylesheets/images/colorsvg/next.svg +338 -0
  432. data/lib/stylesheets/images/colorsvg/note.svg +200 -0
  433. data/lib/stylesheets/images/colorsvg/prev.svg +338 -0
  434. data/lib/stylesheets/images/colorsvg/tip.svg +367 -0
  435. data/lib/stylesheets/images/colorsvg/up.svg +338 -0
  436. data/lib/stylesheets/images/colorsvg/warning.svg +232 -0
  437. data/lib/stylesheets/images/draft.png +0 -0
  438. data/lib/stylesheets/images/home.gif +0 -0
  439. data/lib/stylesheets/images/home.png +0 -0
  440. data/lib/stylesheets/images/home.svg +26 -0
  441. data/lib/stylesheets/images/important.gif +0 -0
  442. data/lib/stylesheets/images/important.png +0 -0
  443. data/lib/stylesheets/images/important.svg +25 -0
  444. data/lib/stylesheets/images/important.tif +0 -0
  445. data/lib/stylesheets/images/next.gif +0 -0
  446. data/lib/stylesheets/images/next.png +0 -0
  447. data/lib/stylesheets/images/next.svg +19 -0
  448. data/lib/stylesheets/images/note.gif +0 -0
  449. data/lib/stylesheets/images/note.png +0 -0
  450. data/lib/stylesheets/images/note.svg +33 -0
  451. data/lib/stylesheets/images/note.tif +0 -0
  452. data/lib/stylesheets/images/prev.gif +0 -0
  453. data/lib/stylesheets/images/prev.png +0 -0
  454. data/lib/stylesheets/images/prev.svg +19 -0
  455. data/lib/stylesheets/images/tip.gif +0 -0
  456. data/lib/stylesheets/images/tip.png +0 -0
  457. data/lib/stylesheets/images/tip.svg +31 -0
  458. data/lib/stylesheets/images/tip.tif +0 -0
  459. data/lib/stylesheets/images/toc-blank.png +0 -0
  460. data/lib/stylesheets/images/toc-minus.png +0 -0
  461. data/lib/stylesheets/images/toc-plus.png +0 -0
  462. data/lib/stylesheets/images/up.gif +0 -0
  463. data/lib/stylesheets/images/up.png +0 -0
  464. data/lib/stylesheets/images/up.svg +19 -0
  465. data/lib/stylesheets/images/warning.gif +0 -0
  466. data/lib/stylesheets/images/warning.png +0 -0
  467. data/lib/stylesheets/images/warning.svg +23 -0
  468. data/lib/stylesheets/images/warning.tif +0 -0
  469. data/lib/stylesheets/install.sh +977 -0
  470. data/lib/stylesheets/javahelp/javahelp.xsl +613 -0
  471. data/lib/stylesheets/javahelp/profile-javahelp.xsl +548 -0
  472. data/lib/stylesheets/lib/lib.xsl +482 -0
  473. data/lib/stylesheets/manpages/ChangeLog.20020917 +195 -0
  474. data/lib/stylesheets/manpages/block.xsl +412 -0
  475. data/lib/stylesheets/manpages/charmap.groff.xsl +6014 -0
  476. data/lib/stylesheets/manpages/docbook.xsl +302 -0
  477. data/lib/stylesheets/manpages/endnotes.xsl +587 -0
  478. data/lib/stylesheets/manpages/html-synop.xsl +1569 -0
  479. data/lib/stylesheets/manpages/info.xsl +801 -0
  480. data/lib/stylesheets/manpages/inline.xsl +221 -0
  481. data/lib/stylesheets/manpages/lists.xsl +606 -0
  482. data/lib/stylesheets/manpages/other.xsl +889 -0
  483. data/lib/stylesheets/manpages/param.xml +3220 -0
  484. data/lib/stylesheets/manpages/param.xsl +195 -0
  485. data/lib/stylesheets/manpages/pi.xml +70 -0
  486. data/lib/stylesheets/manpages/pi.xsl +80 -0
  487. data/lib/stylesheets/manpages/profile-docbook.xsl +282 -0
  488. data/lib/stylesheets/manpages/refentry.xsl +321 -0
  489. data/lib/stylesheets/manpages/synop.xsl +433 -0
  490. data/lib/stylesheets/manpages/table.xsl +633 -0
  491. data/lib/stylesheets/manpages/utility.xsl +556 -0
  492. data/lib/stylesheets/params/abstract.notitle.enabled.xml +22 -0
  493. data/lib/stylesheets/params/abstract.properties.xml +32 -0
  494. data/lib/stylesheets/params/abstract.title.properties.xml +39 -0
  495. data/lib/stylesheets/params/active.toc.xml +29 -0
  496. data/lib/stylesheets/params/ade.extensions.xml +32 -0
  497. data/lib/stylesheets/params/admon.graphics.extension.xml +27 -0
  498. data/lib/stylesheets/params/admon.graphics.path.xml +27 -0
  499. data/lib/stylesheets/params/admon.graphics.xml +29 -0
  500. data/lib/stylesheets/params/admon.style.xml +31 -0
  501. data/lib/stylesheets/params/admon.textlabel.xml +32 -0
  502. data/lib/stylesheets/params/admonition.properties.xml +25 -0
  503. data/lib/stylesheets/params/admonition.title.properties.xml +32 -0
  504. data/lib/stylesheets/params/alignment.xml +41 -0
  505. data/lib/stylesheets/params/annotate.toc.xml +28 -0
  506. data/lib/stylesheets/params/annotation.css.xml +71 -0
  507. data/lib/stylesheets/params/annotation.graphic.close.xml +31 -0
  508. data/lib/stylesheets/params/annotation.graphic.open.xml +28 -0
  509. data/lib/stylesheets/params/annotation.js.xml +33 -0
  510. data/lib/stylesheets/params/annotation.support.xml +29 -0
  511. data/lib/stylesheets/params/appendix.autolabel.xml +73 -0
  512. data/lib/stylesheets/params/arbortext.extensions.xml +30 -0
  513. data/lib/stylesheets/params/article.appendix.title.properties.xml +33 -0
  514. data/lib/stylesheets/params/author.othername.in.middle.xml +31 -0
  515. data/lib/stylesheets/params/autolayout-file.xml +29 -0
  516. data/lib/stylesheets/params/autotoc.label.in.hyperlink.xml +29 -0
  517. data/lib/stylesheets/params/autotoc.label.separator.xml +27 -0
  518. data/lib/stylesheets/params/axf.extensions.xml +33 -0
  519. data/lib/stylesheets/params/banner.before.navigation.xml +25 -0
  520. data/lib/stylesheets/params/base.dir.xml +29 -0
  521. data/lib/stylesheets/params/biblioentry.item.separator.xml +26 -0
  522. data/lib/stylesheets/params/biblioentry.properties.xml +28 -0
  523. data/lib/stylesheets/params/bibliography.collection.xml +104 -0
  524. data/lib/stylesheets/params/bibliography.numbered.xml +27 -0
  525. data/lib/stylesheets/params/bibliography.style.xml +35 -0
  526. data/lib/stylesheets/params/blockquote.properties.xml +34 -0
  527. data/lib/stylesheets/params/blurb.on.titlepage.enabled.xml +31 -0
  528. data/lib/stylesheets/params/body.attributes.xml +31 -0
  529. data/lib/stylesheets/params/body.bg.color.xml +28 -0
  530. data/lib/stylesheets/params/body.end.indent.xml +37 -0
  531. data/lib/stylesheets/params/body.font.family.xml +32 -0
  532. data/lib/stylesheets/params/body.font.master.xml +30 -0
  533. data/lib/stylesheets/params/body.font.size.xml +31 -0
  534. data/lib/stylesheets/params/body.margin.bottom.xml +29 -0
  535. data/lib/stylesheets/params/body.margin.top.xml +28 -0
  536. data/lib/stylesheets/params/body.start.indent.xml +64 -0
  537. data/lib/stylesheets/params/bookmarks.collapse.xml +31 -0
  538. data/lib/stylesheets/params/bridgehead.in.toc.xml +28 -0
  539. data/lib/stylesheets/params/bullet.image.xml +28 -0
  540. data/lib/stylesheets/params/callout.defaultcolumn.xml +30 -0
  541. data/lib/stylesheets/params/callout.graphics.extension.xml +33 -0
  542. data/lib/stylesheets/params/callout.graphics.number.limit.xml +34 -0
  543. data/lib/stylesheets/params/callout.graphics.path.xml +31 -0
  544. data/lib/stylesheets/params/callout.graphics.xml +30 -0
  545. data/lib/stylesheets/params/callout.icon.size.xml +28 -0
  546. data/lib/stylesheets/params/callout.list.table.xml +32 -0
  547. data/lib/stylesheets/params/callout.unicode.font.xml +29 -0
  548. data/lib/stylesheets/params/callout.unicode.number.limit.xml +35 -0
  549. data/lib/stylesheets/params/callout.unicode.start.character.xml +33 -0
  550. data/lib/stylesheets/params/callout.unicode.xml +26 -0
  551. data/lib/stylesheets/params/callouts.extension.xml +30 -0
  552. data/lib/stylesheets/params/chapter.autolabel.xml +71 -0
  553. data/lib/stylesheets/params/chunk.append.xml +30 -0
  554. data/lib/stylesheets/params/chunk.first.sections.xml +31 -0
  555. data/lib/stylesheets/params/chunk.quietly.xml +30 -0
  556. data/lib/stylesheets/params/chunk.section.depth.xml +27 -0
  557. data/lib/stylesheets/params/chunk.sections.xml +30 -0
  558. data/lib/stylesheets/params/chunk.separate.lots.xml +36 -0
  559. data/lib/stylesheets/params/chunk.toc.xml +30 -0
  560. data/lib/stylesheets/params/chunk.tocs.and.lots.has.title.xml +28 -0
  561. data/lib/stylesheets/params/chunk.tocs.and.lots.xml +32 -0
  562. data/lib/stylesheets/params/chunker.output.cdata-section-elements.xml +30 -0
  563. data/lib/stylesheets/params/chunker.output.doctype-public.xml +31 -0
  564. data/lib/stylesheets/params/chunker.output.doctype-system.xml +31 -0
  565. data/lib/stylesheets/params/chunker.output.encoding.xml +31 -0
  566. data/lib/stylesheets/params/chunker.output.indent.xml +30 -0
  567. data/lib/stylesheets/params/chunker.output.media-type.xml +35 -0
  568. data/lib/stylesheets/params/chunker.output.method.xml +32 -0
  569. data/lib/stylesheets/params/chunker.output.omit-xml-declaration.xml +30 -0
  570. data/lib/stylesheets/params/chunker.output.standalone.xml +31 -0
  571. data/lib/stylesheets/params/citerefentry.link.xml +29 -0
  572. data/lib/stylesheets/params/collect.xref.targets.xml +33 -0
  573. data/lib/stylesheets/params/column.count.back.xml +27 -0
  574. data/lib/stylesheets/params/column.count.body.xml +27 -0
  575. data/lib/stylesheets/params/column.count.front.xml +27 -0
  576. data/lib/stylesheets/params/column.count.index.xml +27 -0
  577. data/lib/stylesheets/params/column.count.lot.xml +28 -0
  578. data/lib/stylesheets/params/column.count.titlepage.xml +27 -0
  579. data/lib/stylesheets/params/column.gap.back.xml +28 -0
  580. data/lib/stylesheets/params/column.gap.body.xml +28 -0
  581. data/lib/stylesheets/params/column.gap.front.xml +28 -0
  582. data/lib/stylesheets/params/column.gap.index.xml +28 -0
  583. data/lib/stylesheets/params/column.gap.lot.xml +28 -0
  584. data/lib/stylesheets/params/column.gap.titlepage.xml +29 -0
  585. data/lib/stylesheets/params/compact.list.item.spacing.xml +28 -0
  586. data/lib/stylesheets/params/component.label.includes.part.label.xml +39 -0
  587. data/lib/stylesheets/params/component.title.properties.xml +40 -0
  588. data/lib/stylesheets/params/component.titlepage.properties.xml +33 -0
  589. data/lib/stylesheets/params/contrib.inline.enabled.xml +26 -0
  590. data/lib/stylesheets/params/crop.mark.bleed.xml +28 -0
  591. data/lib/stylesheets/params/crop.mark.offset.xml +28 -0
  592. data/lib/stylesheets/params/crop.mark.width.xml +28 -0
  593. data/lib/stylesheets/params/crop.marks.xml +28 -0
  594. data/lib/stylesheets/params/css.decoration.xml +33 -0
  595. data/lib/stylesheets/params/css.stylesheet.dir.xml +33 -0
  596. data/lib/stylesheets/params/css.stylesheet.xml +29 -0
  597. data/lib/stylesheets/params/current.docid.xml +27 -0
  598. data/lib/stylesheets/params/currentpage.marker.xml +25 -0
  599. data/lib/stylesheets/params/custom.css.source.xml +119 -0
  600. data/lib/stylesheets/params/default.float.class.xml +34 -0
  601. data/lib/stylesheets/params/default.image.width.xml +30 -0
  602. data/lib/stylesheets/params/default.table.frame.xml +28 -0
  603. data/lib/stylesheets/params/default.table.rules.xml +76 -0
  604. data/lib/stylesheets/params/default.table.width.xml +26 -0
  605. data/lib/stylesheets/params/default.units.xml +37 -0
  606. data/lib/stylesheets/params/dingbat.font.family.xml +33 -0
  607. data/lib/stylesheets/params/docbook.css.link.xml +42 -0
  608. data/lib/stylesheets/params/docbook.css.source.xml +83 -0
  609. data/lib/stylesheets/params/double.sided.xml +31 -0
  610. data/lib/stylesheets/params/draft.mode.xml +36 -0
  611. data/lib/stylesheets/params/draft.watermark.image.xml +27 -0
  612. data/lib/stylesheets/params/dry-run.xml +27 -0
  613. data/lib/stylesheets/params/dynamic.toc.xml +29 -0
  614. data/lib/stylesheets/params/ebnf.assignment.xml +39 -0
  615. data/lib/stylesheets/params/ebnf.statement.terminator.xml +32 -0
  616. data/lib/stylesheets/params/ebnf.table.bgcolor.xml +30 -0
  617. data/lib/stylesheets/params/ebnf.table.border.xml +26 -0
  618. data/lib/stylesheets/params/eclipse.autolabel.xml +28 -0
  619. data/lib/stylesheets/params/eclipse.plugin.id.xml +28 -0
  620. data/lib/stylesheets/params/eclipse.plugin.name.xml +27 -0
  621. data/lib/stylesheets/params/eclipse.plugin.provider.xml +27 -0
  622. data/lib/stylesheets/params/editedby.enabled.xml +27 -0
  623. data/lib/stylesheets/params/email.delimiters.enabled.xml +34 -0
  624. data/lib/stylesheets/params/email.mailto.enabled.xml +29 -0
  625. data/lib/stylesheets/params/emphasis.propagates.style.xml +26 -0
  626. data/lib/stylesheets/params/entry.propagates.style.xml +30 -0
  627. data/lib/stylesheets/params/epub.autolabel.xml +28 -0
  628. data/lib/stylesheets/params/equation.number.properties.xml +28 -0
  629. data/lib/stylesheets/params/equation.properties.xml +27 -0
  630. data/lib/stylesheets/params/example.properties.xml +27 -0
  631. data/lib/stylesheets/params/exsl.node.set.available.xml +44 -0
  632. data/lib/stylesheets/params/feedback.href.xml +28 -0
  633. data/lib/stylesheets/params/feedback.link.text.xml +28 -0
  634. data/lib/stylesheets/params/feedback.with.ids.xml +27 -0
  635. data/lib/stylesheets/params/figure.properties.xml +27 -0
  636. data/lib/stylesheets/params/filename-prefix.xml +28 -0
  637. data/lib/stylesheets/params/firstterm.only.link.xml +29 -0
  638. data/lib/stylesheets/params/foil.properties.xml +37 -0
  639. data/lib/stylesheets/params/foil.subtitle.properties.xml +36 -0
  640. data/lib/stylesheets/params/foil.title.master.xml +29 -0
  641. data/lib/stylesheets/params/foil.title.size.xml +32 -0
  642. data/lib/stylesheets/params/foilgroup.properties.xml +31 -0
  643. data/lib/stylesheets/params/foilgroup.toc.xml +29 -0
  644. data/lib/stylesheets/params/footer.column.widths.xml +80 -0
  645. data/lib/stylesheets/params/footer.content.properties.xml +34 -0
  646. data/lib/stylesheets/params/footer.hr.xml +26 -0
  647. data/lib/stylesheets/params/footer.rule.xml +27 -0
  648. data/lib/stylesheets/params/footer.table.height.xml +32 -0
  649. data/lib/stylesheets/params/footer.table.properties.xml +30 -0
  650. data/lib/stylesheets/params/footers.on.blank.pages.xml +27 -0
  651. data/lib/stylesheets/params/footnote.font.size.xml +28 -0
  652. data/lib/stylesheets/params/footnote.mark.properties.xml +41 -0
  653. data/lib/stylesheets/params/footnote.number.format.xml +33 -0
  654. data/lib/stylesheets/params/footnote.number.symbols.xml +39 -0
  655. data/lib/stylesheets/params/footnote.properties.xml +43 -0
  656. data/lib/stylesheets/params/footnote.sep.leader.properties.xml +39 -0
  657. data/lib/stylesheets/params/fop.extensions.xml +36 -0
  658. data/lib/stylesheets/params/fop1.extensions.xml +34 -0
  659. data/lib/stylesheets/params/formal.object.properties.xml +36 -0
  660. data/lib/stylesheets/params/formal.procedures.xml +28 -0
  661. data/lib/stylesheets/params/formal.title.placement.xml +41 -0
  662. data/lib/stylesheets/params/formal.title.properties.xml +34 -0
  663. data/lib/stylesheets/params/funcsynopsis.decoration.xml +30 -0
  664. data/lib/stylesheets/params/funcsynopsis.style.xml +31 -0
  665. data/lib/stylesheets/params/function.parens.xml +29 -0
  666. data/lib/stylesheets/params/generate.css.header.xml +40 -0
  667. data/lib/stylesheets/params/generate.id.attributes.xml +59 -0
  668. data/lib/stylesheets/params/generate.index.xml +25 -0
  669. data/lib/stylesheets/params/generate.legalnotice.link.xml +72 -0
  670. data/lib/stylesheets/params/generate.manifest.xml +27 -0
  671. data/lib/stylesheets/params/generate.meta.abstract.xml +29 -0
  672. data/lib/stylesheets/params/generate.revhistory.link.xml +50 -0
  673. data/lib/stylesheets/params/generate.section.toc.level.xml +35 -0
  674. data/lib/stylesheets/params/generate.toc.xml +108 -0
  675. data/lib/stylesheets/params/glossary.as.blocks.xml +38 -0
  676. data/lib/stylesheets/params/glossary.collection.xml +252 -0
  677. data/lib/stylesheets/params/glossary.sort.xml +32 -0
  678. data/lib/stylesheets/params/glossdef.block.properties.xml +32 -0
  679. data/lib/stylesheets/params/glossdef.list.properties.xml +30 -0
  680. data/lib/stylesheets/params/glossentry.list.item.properties.xml +32 -0
  681. data/lib/stylesheets/params/glossentry.show.acronym.xml +37 -0
  682. data/lib/stylesheets/params/glosslist.as.blocks.xml +27 -0
  683. data/lib/stylesheets/params/glossterm.auto.link.xml +33 -0
  684. data/lib/stylesheets/params/glossterm.block.properties.xml +35 -0
  685. data/lib/stylesheets/params/glossterm.list.properties.xml +30 -0
  686. data/lib/stylesheets/params/glossterm.separation.xml +31 -0
  687. data/lib/stylesheets/params/glossterm.width.xml +28 -0
  688. data/lib/stylesheets/params/graphic.default.extension.xml +29 -0
  689. data/lib/stylesheets/params/graphical.admonition.properties.xml +42 -0
  690. data/lib/stylesheets/params/graphics.dir.xml +33 -0
  691. data/lib/stylesheets/params/graphicsize.extension.xml +30 -0
  692. data/lib/stylesheets/params/graphicsize.use.img.src.path.xml +30 -0
  693. data/lib/stylesheets/params/header.column.widths.xml +80 -0
  694. data/lib/stylesheets/params/header.content.properties.xml +34 -0
  695. data/lib/stylesheets/params/header.hr.xml +26 -0
  696. data/lib/stylesheets/params/header.rule.xml +27 -0
  697. data/lib/stylesheets/params/header.table.height.xml +32 -0
  698. data/lib/stylesheets/params/header.table.properties.xml +30 -0
  699. data/lib/stylesheets/params/headers.on.blank.pages.xml +27 -0
  700. data/lib/stylesheets/params/hidetoc.image.xml +29 -0
  701. data/lib/stylesheets/params/highlight.default.language.xml +27 -0
  702. data/lib/stylesheets/params/highlight.source.xml +82 -0
  703. data/lib/stylesheets/params/highlight.xslthl.config.xml +33 -0
  704. data/lib/stylesheets/params/home.image.xml +27 -0
  705. data/lib/stylesheets/params/html.append.xml +30 -0
  706. data/lib/stylesheets/params/html.base.xml +30 -0
  707. data/lib/stylesheets/params/html.cellpadding.xml +29 -0
  708. data/lib/stylesheets/params/html.cellspacing.xml +29 -0
  709. data/lib/stylesheets/params/html.cleanup.xml +34 -0
  710. data/lib/stylesheets/params/html.ext.xml +29 -0
  711. data/lib/stylesheets/params/html.extra.head.links.xml +31 -0
  712. data/lib/stylesheets/params/html.head.legalnotice.link.multiple.xml +44 -0
  713. data/lib/stylesheets/params/html.head.legalnotice.link.types.xml +75 -0
  714. data/lib/stylesheets/params/html.longdesc.link.xml +39 -0
  715. data/lib/stylesheets/params/html.longdesc.xml +28 -0
  716. data/lib/stylesheets/params/html.stylesheet.type.xml +26 -0
  717. data/lib/stylesheets/params/html.stylesheet.xml +36 -0
  718. data/lib/stylesheets/params/htmlhelp.alias.file.xml +27 -0
  719. data/lib/stylesheets/params/htmlhelp.autolabel.xml +28 -0
  720. data/lib/stylesheets/params/htmlhelp.button.back.xml +27 -0
  721. data/lib/stylesheets/params/htmlhelp.button.forward.xml +27 -0
  722. data/lib/stylesheets/params/htmlhelp.button.hideshow.xml +27 -0
  723. data/lib/stylesheets/params/htmlhelp.button.home.url.xml +27 -0
  724. data/lib/stylesheets/params/htmlhelp.button.home.xml +27 -0
  725. data/lib/stylesheets/params/htmlhelp.button.jump1.title.xml +27 -0
  726. data/lib/stylesheets/params/htmlhelp.button.jump1.url.xml +27 -0
  727. data/lib/stylesheets/params/htmlhelp.button.jump1.xml +23 -0
  728. data/lib/stylesheets/params/htmlhelp.button.jump2.title.xml +27 -0
  729. data/lib/stylesheets/params/htmlhelp.button.jump2.url.xml +27 -0
  730. data/lib/stylesheets/params/htmlhelp.button.jump2.xml +27 -0
  731. data/lib/stylesheets/params/htmlhelp.button.locate.xml +28 -0
  732. data/lib/stylesheets/params/htmlhelp.button.next.xml +27 -0
  733. data/lib/stylesheets/params/htmlhelp.button.options.xml +28 -0
  734. data/lib/stylesheets/params/htmlhelp.button.prev.xml +28 -0
  735. data/lib/stylesheets/params/htmlhelp.button.print.xml +28 -0
  736. data/lib/stylesheets/params/htmlhelp.button.refresh.xml +27 -0
  737. data/lib/stylesheets/params/htmlhelp.button.stop.xml +28 -0
  738. data/lib/stylesheets/params/htmlhelp.button.zoom.xml +28 -0
  739. data/lib/stylesheets/params/htmlhelp.chm.xml +27 -0
  740. data/lib/stylesheets/params/htmlhelp.default.topic.xml +37 -0
  741. data/lib/stylesheets/params/htmlhelp.display.progress.xml +28 -0
  742. data/lib/stylesheets/params/htmlhelp.encoding.xml +28 -0
  743. data/lib/stylesheets/params/htmlhelp.enhanced.decompilation.xml +27 -0
  744. data/lib/stylesheets/params/htmlhelp.enumerate.images.xml +28 -0
  745. data/lib/stylesheets/params/htmlhelp.force.map.and.alias.xml +26 -0
  746. data/lib/stylesheets/params/htmlhelp.hhc.binary.xml +29 -0
  747. data/lib/stylesheets/params/htmlhelp.hhc.folders.instead.books.xml +31 -0
  748. data/lib/stylesheets/params/htmlhelp.hhc.section.depth.xml +27 -0
  749. data/lib/stylesheets/params/htmlhelp.hhc.show.root.xml +29 -0
  750. data/lib/stylesheets/params/htmlhelp.hhc.width.xml +28 -0
  751. data/lib/stylesheets/params/htmlhelp.hhc.xml +27 -0
  752. data/lib/stylesheets/params/htmlhelp.hhk.xml +27 -0
  753. data/lib/stylesheets/params/htmlhelp.hhp.tail.xml +28 -0
  754. data/lib/stylesheets/params/htmlhelp.hhp.window.xml +28 -0
  755. data/lib/stylesheets/params/htmlhelp.hhp.windows.xml +29 -0
  756. data/lib/stylesheets/params/htmlhelp.hhp.xml +28 -0
  757. data/lib/stylesheets/params/htmlhelp.map.file.xml +25 -0
  758. data/lib/stylesheets/params/htmlhelp.only.xml +32 -0
  759. data/lib/stylesheets/params/htmlhelp.remember.window.position.xml +27 -0
  760. data/lib/stylesheets/params/htmlhelp.show.advanced.search.xml +28 -0
  761. data/lib/stylesheets/params/htmlhelp.show.favorities.xml +28 -0
  762. data/lib/stylesheets/params/htmlhelp.show.menu.xml +28 -0
  763. data/lib/stylesheets/params/htmlhelp.show.toolbar.text.xml +28 -0
  764. data/lib/stylesheets/params/htmlhelp.title.xml +28 -0
  765. data/lib/stylesheets/params/htmlhelp.use.hhk.xml +28 -0
  766. data/lib/stylesheets/params/htmlhelp.window.geometry.xml +30 -0
  767. data/lib/stylesheets/params/hyphenate.verbatim.characters.xml +30 -0
  768. data/lib/stylesheets/params/hyphenate.verbatim.xml +45 -0
  769. data/lib/stylesheets/params/hyphenate.xml +29 -0
  770. data/lib/stylesheets/params/id.warnings.xml +25 -0
  771. data/lib/stylesheets/params/ignore.image.scaling.xml +28 -0
  772. data/lib/stylesheets/params/img.src.path.xml +40 -0
  773. data/lib/stylesheets/params/index.div.title.properties.xml +39 -0
  774. data/lib/stylesheets/params/index.entry.properties.xml +33 -0
  775. data/lib/stylesheets/params/index.links.to.section.xml +76 -0
  776. data/lib/stylesheets/params/index.method.xml +162 -0
  777. data/lib/stylesheets/params/index.number.separator.xml +54 -0
  778. data/lib/stylesheets/params/index.on.role.xml +48 -0
  779. data/lib/stylesheets/params/index.on.type.xml +52 -0
  780. data/lib/stylesheets/params/index.page.number.properties.xml +31 -0
  781. data/lib/stylesheets/params/index.prefer.titleabbrev.xml +29 -0
  782. data/lib/stylesheets/params/index.preferred.page.properties.xml +32 -0
  783. data/lib/stylesheets/params/index.range.separator.xml +57 -0
  784. data/lib/stylesheets/params/index.term.separator.xml +54 -0
  785. data/lib/stylesheets/params/informal.object.properties.xml +29 -0
  786. data/lib/stylesheets/params/informalequation.properties.xml +27 -0
  787. data/lib/stylesheets/params/informalexample.properties.xml +27 -0
  788. data/lib/stylesheets/params/informalfigure.properties.xml +27 -0
  789. data/lib/stylesheets/params/informaltable.properties.xml +32 -0
  790. data/lib/stylesheets/params/inherit.keywords.xml +31 -0
  791. data/lib/stylesheets/params/insert.link.page.number.xml +69 -0
  792. data/lib/stylesheets/params/insert.olink.page.number.xml +83 -0
  793. data/lib/stylesheets/params/insert.olink.pdf.frag.xml +68 -0
  794. data/lib/stylesheets/params/insert.xref.page.number.xml +60 -0
  795. data/lib/stylesheets/params/itemizedlist.label.properties.xml +26 -0
  796. data/lib/stylesheets/params/itemizedlist.label.width.xml +28 -0
  797. data/lib/stylesheets/params/itemizedlist.properties.xml +23 -0
  798. data/lib/stylesheets/params/javahelp.encoding.xml +31 -0
  799. data/lib/stylesheets/params/keep.relative.image.uris.xml +34 -0
  800. data/lib/stylesheets/params/keyboard.nav.xml +29 -0
  801. data/lib/stylesheets/params/l10n.gentext.default.language.xml +30 -0
  802. data/lib/stylesheets/params/l10n.gentext.language.xml +33 -0
  803. data/lib/stylesheets/params/l10n.gentext.use.xref.language.xml +53 -0
  804. data/lib/stylesheets/params/l10n.lang.value.rfc.compliant.xml +57 -0
  805. data/lib/stylesheets/params/label.from.part.xml +38 -0
  806. data/lib/stylesheets/params/line-height.xml +27 -0
  807. data/lib/stylesheets/params/linenumbering.everyNth.xml +29 -0
  808. data/lib/stylesheets/params/linenumbering.extension.xml +30 -0
  809. data/lib/stylesheets/params/linenumbering.separator.xml +30 -0
  810. data/lib/stylesheets/params/linenumbering.width.xml +29 -0
  811. data/lib/stylesheets/params/link.mailto.url.xml +29 -0
  812. data/lib/stylesheets/params/list.block.properties.xml +25 -0
  813. data/lib/stylesheets/params/list.block.spacing.xml +29 -0
  814. data/lib/stylesheets/params/list.item.spacing.xml +26 -0
  815. data/lib/stylesheets/params/make.clean.html.xml +51 -0
  816. data/lib/stylesheets/params/make.graphic.viewport.xml +35 -0
  817. data/lib/stylesheets/params/make.index.markup.xml +73 -0
  818. data/lib/stylesheets/params/make.single.year.ranges.xml +28 -0
  819. data/lib/stylesheets/params/make.valid.html.xml +35 -0
  820. data/lib/stylesheets/params/make.year.ranges.xml +32 -0
  821. data/lib/stylesheets/params/man.authors.section.enabled.xml +46 -0
  822. data/lib/stylesheets/params/man.base.url.for.relative.links.xml +76 -0
  823. data/lib/stylesheets/params/man.break.after.slash.xml +46 -0
  824. data/lib/stylesheets/params/man.charmap.enabled.xml +55 -0
  825. data/lib/stylesheets/params/man.charmap.subset.profile.english.xml +80 -0
  826. data/lib/stylesheets/params/man.charmap.subset.profile.xml +297 -0
  827. data/lib/stylesheets/params/man.charmap.uri.xml +42 -0
  828. data/lib/stylesheets/params/man.charmap.use.subset.xml +80 -0
  829. data/lib/stylesheets/params/man.copyright.section.enabled.xml +46 -0
  830. data/lib/stylesheets/params/man.endnotes.are.numbered.xml +106 -0
  831. data/lib/stylesheets/params/man.endnotes.list.enabled.xml +105 -0
  832. data/lib/stylesheets/params/man.endnotes.list.heading.xml +36 -0
  833. data/lib/stylesheets/params/man.font.funcprototype.xml +30 -0
  834. data/lib/stylesheets/params/man.font.funcsynopsisinfo.xml +30 -0
  835. data/lib/stylesheets/params/man.font.links.xml +64 -0
  836. data/lib/stylesheets/params/man.font.table.headings.xml +30 -0
  837. data/lib/stylesheets/params/man.font.table.title.xml +30 -0
  838. data/lib/stylesheets/params/man.funcsynopsis.style.xml +26 -0
  839. data/lib/stylesheets/params/man.hyphenate.computer.inlines.xml +53 -0
  840. data/lib/stylesheets/params/man.hyphenate.filenames.xml +47 -0
  841. data/lib/stylesheets/params/man.hyphenate.urls.xml +46 -0
  842. data/lib/stylesheets/params/man.hyphenate.xml +59 -0
  843. data/lib/stylesheets/params/man.indent.blurbs.xml +33 -0
  844. data/lib/stylesheets/params/man.indent.lists.xml +35 -0
  845. data/lib/stylesheets/params/man.indent.refsect.xml +70 -0
  846. data/lib/stylesheets/params/man.indent.verbatims.xml +33 -0
  847. data/lib/stylesheets/params/man.indent.width.xml +39 -0
  848. data/lib/stylesheets/params/man.justify.xml +52 -0
  849. data/lib/stylesheets/params/man.output.base.dir.xml +39 -0
  850. data/lib/stylesheets/params/man.output.better.ps.enabled.xml +61 -0
  851. data/lib/stylesheets/params/man.output.encoding.xml +53 -0
  852. data/lib/stylesheets/params/man.output.in.separate.dir.xml +32 -0
  853. data/lib/stylesheets/params/man.output.lang.in.name.enabled.xml +50 -0
  854. data/lib/stylesheets/params/man.output.manifest.enabled.xml +27 -0
  855. data/lib/stylesheets/params/man.output.manifest.filename.xml +29 -0
  856. data/lib/stylesheets/params/man.output.quietly.xml +37 -0
  857. data/lib/stylesheets/params/man.output.subdirs.enabled.xml +40 -0
  858. data/lib/stylesheets/params/man.segtitle.suppress.xml +28 -0
  859. data/lib/stylesheets/params/man.string.subst.map.local.post.xml +34 -0
  860. data/lib/stylesheets/params/man.string.subst.map.local.pre.xml +34 -0
  861. data/lib/stylesheets/params/man.string.subst.map.xml +162 -0
  862. data/lib/stylesheets/params/man.subheading.divider.enabled.xml +37 -0
  863. data/lib/stylesheets/params/man.subheading.divider.xml +37 -0
  864. data/lib/stylesheets/params/man.table.footnotes.divider.xml +29 -0
  865. data/lib/stylesheets/params/man.th.extra1.suppress.xml +32 -0
  866. data/lib/stylesheets/params/man.th.extra2.max.length.xml +43 -0
  867. data/lib/stylesheets/params/man.th.extra2.suppress.xml +44 -0
  868. data/lib/stylesheets/params/man.th.extra3.max.length.xml +42 -0
  869. data/lib/stylesheets/params/man.th.extra3.suppress.xml +34 -0
  870. data/lib/stylesheets/params/man.th.title.max.length.xml +63 -0
  871. data/lib/stylesheets/params/manifest.in.base.dir.xml +29 -0
  872. data/lib/stylesheets/params/manifest.xml +29 -0
  873. data/lib/stylesheets/params/manual.toc.xml +29 -0
  874. data/lib/stylesheets/params/margin.note.float.type.xml +77 -0
  875. data/lib/stylesheets/params/margin.note.properties.xml +54 -0
  876. data/lib/stylesheets/params/margin.note.title.properties.xml +32 -0
  877. data/lib/stylesheets/params/margin.note.width.xml +35 -0
  878. data/lib/stylesheets/params/marker.section.level.xml +50 -0
  879. data/lib/stylesheets/params/menuchoice.menu.separator.xml +42 -0
  880. data/lib/stylesheets/params/menuchoice.separator.xml +32 -0
  881. data/lib/stylesheets/params/minus.image.xml +29 -0
  882. data/lib/stylesheets/params/monospace.font.family.xml +29 -0
  883. data/lib/stylesheets/params/monospace.properties.xml +38 -0
  884. data/lib/stylesheets/params/monospace.verbatim.font.width.xml +40 -0
  885. data/lib/stylesheets/params/monospace.verbatim.properties.xml +27 -0
  886. data/lib/stylesheets/params/multiframe.bottom.bgcolor.xml +28 -0
  887. data/lib/stylesheets/params/multiframe.navigation.height.xml +28 -0
  888. data/lib/stylesheets/params/multiframe.top.bgcolor.xml +28 -0
  889. data/lib/stylesheets/params/multiframe.xml +31 -0
  890. data/lib/stylesheets/params/nav.separator.xml +28 -0
  891. data/lib/stylesheets/params/nav.table.summary.xml +27 -0
  892. data/lib/stylesheets/params/navbgcolor.xml +26 -0
  893. data/lib/stylesheets/params/navbodywidth.xml +26 -0
  894. data/lib/stylesheets/params/navig.graphics.extension.xml +28 -0
  895. data/lib/stylesheets/params/navig.graphics.path.xml +30 -0
  896. data/lib/stylesheets/params/navig.graphics.xml +31 -0
  897. data/lib/stylesheets/params/navig.showtitles.xml +32 -0
  898. data/lib/stylesheets/params/navtocwidth.xml +26 -0
  899. data/lib/stylesheets/params/next.image.xml +27 -0
  900. data/lib/stylesheets/params/no.home.image.xml +27 -0
  901. data/lib/stylesheets/params/no.next.image.xml +27 -0
  902. data/lib/stylesheets/params/no.prev.image.xml +27 -0
  903. data/lib/stylesheets/params/no.toc.image.xml +27 -0
  904. data/lib/stylesheets/params/no.up.image.xml +27 -0
  905. data/lib/stylesheets/params/nominal.image.depth.xml +27 -0
  906. data/lib/stylesheets/params/nominal.image.width.xml +43 -0
  907. data/lib/stylesheets/params/nominal.table.width.xml +30 -0
  908. data/lib/stylesheets/params/nongraphical.admonition.properties.xml +41 -0
  909. data/lib/stylesheets/params/normal.para.spacing.xml +26 -0
  910. data/lib/stylesheets/params/olink.base.uri.xml +35 -0
  911. data/lib/stylesheets/params/olink.debug.xml +36 -0
  912. data/lib/stylesheets/params/olink.doctitle.xml +146 -0
  913. data/lib/stylesheets/params/olink.fragid.xml +23 -0
  914. data/lib/stylesheets/params/olink.lang.fallback.sequence.xml +83 -0
  915. data/lib/stylesheets/params/olink.outline.ext.xml +28 -0
  916. data/lib/stylesheets/params/olink.properties.xml +33 -0
  917. data/lib/stylesheets/params/olink.pubid.xml +27 -0
  918. data/lib/stylesheets/params/olink.resolver.xml +23 -0
  919. data/lib/stylesheets/params/olink.sysid.xml +27 -0
  920. data/lib/stylesheets/params/orderedlist.label.properties.xml +26 -0
  921. data/lib/stylesheets/params/orderedlist.label.width.xml +28 -0
  922. data/lib/stylesheets/params/orderedlist.properties.xml +24 -0
  923. data/lib/stylesheets/params/othercredit.like.author.enabled.xml +31 -0
  924. data/lib/stylesheets/params/output-root.xml +28 -0
  925. data/lib/stylesheets/params/output.indent.xml +32 -0
  926. data/lib/stylesheets/params/overlay.js.xml +28 -0
  927. data/lib/stylesheets/params/overlay.logo.xml +28 -0
  928. data/lib/stylesheets/params/overlay.xml +32 -0
  929. data/lib/stylesheets/params/page.height.portrait.xml +69 -0
  930. data/lib/stylesheets/params/page.height.xml +37 -0
  931. data/lib/stylesheets/params/page.margin.bottom.xml +29 -0
  932. data/lib/stylesheets/params/page.margin.inner.xml +56 -0
  933. data/lib/stylesheets/params/page.margin.outer.xml +53 -0
  934. data/lib/stylesheets/params/page.margin.top.xml +28 -0
  935. data/lib/stylesheets/params/page.orientation.xml +32 -0
  936. data/lib/stylesheets/params/page.width.portrait.xml +67 -0
  937. data/lib/stylesheets/params/page.width.xml +36 -0
  938. data/lib/stylesheets/params/pages.template.xml +29 -0
  939. data/lib/stylesheets/params/paper.type.xml +73 -0
  940. data/lib/stylesheets/params/para.propagates.style.xml +29 -0
  941. data/lib/stylesheets/params/part.autolabel.xml +73 -0
  942. data/lib/stylesheets/params/passivetex.extensions.xml +37 -0
  943. data/lib/stylesheets/params/pgwide.properties.xml +52 -0
  944. data/lib/stylesheets/params/phrase.propagates.style.xml +29 -0
  945. data/lib/stylesheets/params/pixels.per.inch.xml +31 -0
  946. data/lib/stylesheets/params/plus.image.xml +29 -0
  947. data/lib/stylesheets/params/points.per.em.xml +29 -0
  948. data/lib/stylesheets/params/preface.autolabel.xml +71 -0
  949. data/lib/stylesheets/params/prefer.internal.olink.xml +78 -0
  950. data/lib/stylesheets/params/preferred.mediaobject.role.xml +40 -0
  951. data/lib/stylesheets/params/prev.image.xml +27 -0
  952. data/lib/stylesheets/params/procedure.properties.xml +29 -0
  953. data/lib/stylesheets/params/process.empty.source.toc.xml +39 -0
  954. data/lib/stylesheets/params/process.source.toc.xml +39 -0
  955. data/lib/stylesheets/params/profile.arch.xml +39 -0
  956. data/lib/stylesheets/params/profile.attribute.xml +34 -0
  957. data/lib/stylesheets/params/profile.audience.xml +38 -0
  958. data/lib/stylesheets/params/profile.condition.xml +38 -0
  959. data/lib/stylesheets/params/profile.conformance.xml +38 -0
  960. data/lib/stylesheets/params/profile.lang.xml +38 -0
  961. data/lib/stylesheets/params/profile.os.xml +38 -0
  962. data/lib/stylesheets/params/profile.revision.xml +38 -0
  963. data/lib/stylesheets/params/profile.revisionflag.xml +38 -0
  964. data/lib/stylesheets/params/profile.role.xml +54 -0
  965. data/lib/stylesheets/params/profile.security.xml +38 -0
  966. data/lib/stylesheets/params/profile.separator.xml +27 -0
  967. data/lib/stylesheets/params/profile.status.xml +38 -0
  968. data/lib/stylesheets/params/profile.userlevel.xml +38 -0
  969. data/lib/stylesheets/params/profile.value.xml +41 -0
  970. data/lib/stylesheets/params/profile.vendor.xml +38 -0
  971. data/lib/stylesheets/params/profile.wordsize.xml +38 -0
  972. data/lib/stylesheets/params/punct.honorific.xml +28 -0
  973. data/lib/stylesheets/params/qanda.defaultlabel.xml +86 -0
  974. data/lib/stylesheets/params/qanda.in.toc.xml +34 -0
  975. data/lib/stylesheets/params/qanda.inherit.numeration.xml +30 -0
  976. data/lib/stylesheets/params/qanda.nested.in.toc.xml +29 -0
  977. data/lib/stylesheets/params/qanda.title.level1.properties.xml +32 -0
  978. data/lib/stylesheets/params/qanda.title.level2.properties.xml +32 -0
  979. data/lib/stylesheets/params/qanda.title.level3.properties.xml +32 -0
  980. data/lib/stylesheets/params/qanda.title.level4.properties.xml +32 -0
  981. data/lib/stylesheets/params/qanda.title.level5.properties.xml +32 -0
  982. data/lib/stylesheets/params/qanda.title.level6.properties.xml +34 -0
  983. data/lib/stylesheets/params/qanda.title.properties.xml +37 -0
  984. data/lib/stylesheets/params/qandadiv.autolabel.xml +26 -0
  985. data/lib/stylesheets/params/rebuild-all.xml +33 -0
  986. data/lib/stylesheets/params/refclass.suppress.xml +28 -0
  987. data/lib/stylesheets/params/refentry.date.profile.enabled.xml +46 -0
  988. data/lib/stylesheets/params/refentry.date.profile.xml +38 -0
  989. data/lib/stylesheets/params/refentry.generate.name.xml +33 -0
  990. data/lib/stylesheets/params/refentry.generate.title.xml +33 -0
  991. data/lib/stylesheets/params/refentry.manual.fallback.profile.xml +48 -0
  992. data/lib/stylesheets/params/refentry.manual.profile.enabled.xml +47 -0
  993. data/lib/stylesheets/params/refentry.manual.profile.xml +72 -0
  994. data/lib/stylesheets/params/refentry.meta.get.quietly.xml +37 -0
  995. data/lib/stylesheets/params/refentry.pagebreak.xml +33 -0
  996. data/lib/stylesheets/params/refentry.separator.xml +29 -0
  997. data/lib/stylesheets/params/refentry.source.fallback.profile.xml +49 -0
  998. data/lib/stylesheets/params/refentry.source.name.profile.enabled.xml +48 -0
  999. data/lib/stylesheets/params/refentry.source.name.profile.xml +89 -0
  1000. data/lib/stylesheets/params/refentry.source.name.suppress.xml +42 -0
  1001. data/lib/stylesheets/params/refentry.title.properties.xml +59 -0
  1002. data/lib/stylesheets/params/refentry.version.profile.enabled.xml +47 -0
  1003. data/lib/stylesheets/params/refentry.version.profile.xml +41 -0
  1004. data/lib/stylesheets/params/refentry.version.suppress.xml +43 -0
  1005. data/lib/stylesheets/params/refentry.xref.manvolnum.xml +31 -0
  1006. data/lib/stylesheets/params/reference.autolabel.xml +67 -0
  1007. data/lib/stylesheets/params/region.after.extent.xml +29 -0
  1008. data/lib/stylesheets/params/region.before.extent.xml +29 -0
  1009. data/lib/stylesheets/params/revhistory.table.cell.properties.xml +28 -0
  1010. data/lib/stylesheets/params/revhistory.table.properties.xml +28 -0
  1011. data/lib/stylesheets/params/revhistory.title.properties.xml +28 -0
  1012. data/lib/stylesheets/params/root.filename.xml +29 -0
  1013. data/lib/stylesheets/params/root.properties.xml +46 -0
  1014. data/lib/stylesheets/params/rootid.xml +33 -0
  1015. data/lib/stylesheets/params/runinhead.default.title.end.punct.xml +27 -0
  1016. data/lib/stylesheets/params/runinhead.title.end.punct.xml +32 -0
  1017. data/lib/stylesheets/params/running.foot.properties.xml +34 -0
  1018. data/lib/stylesheets/params/sans.font.family.xml +29 -0
  1019. data/lib/stylesheets/params/saxon.callouts.xml +30 -0
  1020. data/lib/stylesheets/params/saxon.character.representation.xml +38 -0
  1021. data/lib/stylesheets/params/saxon.linenumbering.xml +32 -0
  1022. data/lib/stylesheets/params/saxon.tablecolumns.xml +30 -0
  1023. data/lib/stylesheets/params/script.dir.xml +33 -0
  1024. data/lib/stylesheets/params/section.autolabel.max.depth.xml +32 -0
  1025. data/lib/stylesheets/params/section.autolabel.xml +26 -0
  1026. data/lib/stylesheets/params/section.container.element.xml +62 -0
  1027. data/lib/stylesheets/params/section.label.includes.component.label.xml +27 -0
  1028. data/lib/stylesheets/params/section.level1.properties.xml +43 -0
  1029. data/lib/stylesheets/params/section.level2.properties.xml +43 -0
  1030. data/lib/stylesheets/params/section.level3.properties.xml +43 -0
  1031. data/lib/stylesheets/params/section.level4.properties.xml +43 -0
  1032. data/lib/stylesheets/params/section.level5.properties.xml +43 -0
  1033. data/lib/stylesheets/params/section.level6.properties.xml +43 -0
  1034. data/lib/stylesheets/params/section.properties.xml +35 -0
  1035. data/lib/stylesheets/params/section.title.level1.properties.xml +32 -0
  1036. data/lib/stylesheets/params/section.title.level2.properties.xml +33 -0
  1037. data/lib/stylesheets/params/section.title.level3.properties.xml +32 -0
  1038. data/lib/stylesheets/params/section.title.level4.properties.xml +32 -0
  1039. data/lib/stylesheets/params/section.title.level5.properties.xml +32 -0
  1040. data/lib/stylesheets/params/section.title.level6.properties.xml +33 -0
  1041. data/lib/stylesheets/params/section.title.properties.xml +39 -0
  1042. data/lib/stylesheets/params/segmentedlist.as.table.xml +28 -0
  1043. data/lib/stylesheets/params/sequential.links.xml +25 -0
  1044. data/lib/stylesheets/params/shade.verbatim.style.xml +36 -0
  1045. data/lib/stylesheets/params/shade.verbatim.xml +30 -0
  1046. data/lib/stylesheets/params/show.comments.xml +32 -0
  1047. data/lib/stylesheets/params/show.foil.number.xml +28 -0
  1048. data/lib/stylesheets/params/show.revisionflag.xml +42 -0
  1049. data/lib/stylesheets/params/showtoc.image.xml +29 -0
  1050. data/lib/stylesheets/params/side.float.properties.xml +50 -0
  1051. data/lib/stylesheets/params/sidebar.float.type.xml +90 -0
  1052. data/lib/stylesheets/params/sidebar.float.width.xml +35 -0
  1053. data/lib/stylesheets/params/sidebar.properties.xml +42 -0
  1054. data/lib/stylesheets/params/sidebar.title.properties.xml +32 -0
  1055. data/lib/stylesheets/params/simplesect.in.toc.xml +26 -0
  1056. data/lib/stylesheets/params/slide.font.family.xml +31 -0
  1057. data/lib/stylesheets/params/slide.title.font.family.xml +31 -0
  1058. data/lib/stylesheets/params/slides.js.xml +28 -0
  1059. data/lib/stylesheets/params/slides.properties.xml +31 -0
  1060. data/lib/stylesheets/params/spacing.paras.xml +30 -0
  1061. data/lib/stylesheets/params/speakernote.properties.xml +32 -0
  1062. data/lib/stylesheets/params/subscript.properties.xml +29 -0
  1063. data/lib/stylesheets/params/superscript.properties.xml +29 -0
  1064. data/lib/stylesheets/params/suppress.footer.navigation.xml +26 -0
  1065. data/lib/stylesheets/params/suppress.header.navigation.xml +27 -0
  1066. data/lib/stylesheets/params/suppress.homepage.title.xml +25 -0
  1067. data/lib/stylesheets/params/suppress.navigation.xml +28 -0
  1068. data/lib/stylesheets/params/symbol.font.family.xml +45 -0
  1069. data/lib/stylesheets/params/table.borders.with.css.xml +28 -0
  1070. data/lib/stylesheets/params/table.cell.border.color.xml +39 -0
  1071. data/lib/stylesheets/params/table.cell.border.style.xml +42 -0
  1072. data/lib/stylesheets/params/table.cell.border.thickness.xml +35 -0
  1073. data/lib/stylesheets/params/table.cell.padding.xml +32 -0
  1074. data/lib/stylesheets/params/table.entry.padding.xml +27 -0
  1075. data/lib/stylesheets/params/table.footnote.number.format.xml +33 -0
  1076. data/lib/stylesheets/params/table.footnote.number.symbols.xml +39 -0
  1077. data/lib/stylesheets/params/table.footnote.properties.xml +39 -0
  1078. data/lib/stylesheets/params/table.frame.border.color.xml +28 -0
  1079. data/lib/stylesheets/params/table.frame.border.style.xml +37 -0
  1080. data/lib/stylesheets/params/table.frame.border.thickness.xml +27 -0
  1081. data/lib/stylesheets/params/table.properties.xml +34 -0
  1082. data/lib/stylesheets/params/table.spacer.image.xml +26 -0
  1083. data/lib/stylesheets/params/table.table.properties.xml +36 -0
  1084. data/lib/stylesheets/params/tablecolumns.extension.xml +30 -0
  1085. data/lib/stylesheets/params/target.database.document.xml +37 -0
  1086. data/lib/stylesheets/params/targets.filename.xml +32 -0
  1087. data/lib/stylesheets/params/template.xml +27 -0
  1088. data/lib/stylesheets/params/tex.math.delims.xml +47 -0
  1089. data/lib/stylesheets/params/tex.math.file.xml +42 -0
  1090. data/lib/stylesheets/params/tex.math.in.alt.xml +76 -0
  1091. data/lib/stylesheets/params/text.home.xml +27 -0
  1092. data/lib/stylesheets/params/text.next.xml +27 -0
  1093. data/lib/stylesheets/params/text.prev.xml +27 -0
  1094. data/lib/stylesheets/params/text.toc.xml +27 -0
  1095. data/lib/stylesheets/params/text.up.xml +27 -0
  1096. data/lib/stylesheets/params/textbgcolor.xml +26 -0
  1097. data/lib/stylesheets/params/textdata.default.encoding.xml +32 -0
  1098. data/lib/stylesheets/params/textinsert.extension.xml +62 -0
  1099. data/lib/stylesheets/params/title.font.family.xml +33 -0
  1100. data/lib/stylesheets/params/title.margin.left.xml +65 -0
  1101. data/lib/stylesheets/params/titlefoil.html.xml +27 -0
  1102. data/lib/stylesheets/params/toc.bg.color.xml +27 -0
  1103. data/lib/stylesheets/params/toc.blank.graphic.xml +28 -0
  1104. data/lib/stylesheets/params/toc.blank.image.xml +27 -0
  1105. data/lib/stylesheets/params/toc.blank.text.xml +27 -0
  1106. data/lib/stylesheets/params/toc.hide.show.xml +33 -0
  1107. data/lib/stylesheets/params/toc.html.xml +27 -0
  1108. data/lib/stylesheets/params/toc.image.xml +27 -0
  1109. data/lib/stylesheets/params/toc.indent.width.xml +34 -0
  1110. data/lib/stylesheets/params/toc.line.properties.xml +44 -0
  1111. data/lib/stylesheets/params/toc.list.type.xml +30 -0
  1112. data/lib/stylesheets/params/toc.margin.properties.xml +33 -0
  1113. data/lib/stylesheets/params/toc.max.depth.xml +25 -0
  1114. data/lib/stylesheets/params/toc.pointer.graphic.xml +28 -0
  1115. data/lib/stylesheets/params/toc.pointer.image.xml +27 -0
  1116. data/lib/stylesheets/params/toc.pointer.text.xml +27 -0
  1117. data/lib/stylesheets/params/toc.row.height.xml +33 -0
  1118. data/lib/stylesheets/params/toc.section.depth.xml +28 -0
  1119. data/lib/stylesheets/params/toc.spacer.graphic.xml +28 -0
  1120. data/lib/stylesheets/params/toc.spacer.image.xml +27 -0
  1121. data/lib/stylesheets/params/toc.spacer.text.xml +27 -0
  1122. data/lib/stylesheets/params/toc.width.xml +28 -0
  1123. data/lib/stylesheets/params/ua.js.xml +28 -0
  1124. data/lib/stylesheets/params/ulink.footnotes.xml +34 -0
  1125. data/lib/stylesheets/params/ulink.hyphenate.chars.xml +37 -0
  1126. data/lib/stylesheets/params/ulink.hyphenate.xml +35 -0
  1127. data/lib/stylesheets/params/ulink.show.xml +37 -0
  1128. data/lib/stylesheets/params/ulink.target.xml +29 -0
  1129. data/lib/stylesheets/params/up.image.xml +27 -0
  1130. data/lib/stylesheets/params/use.embed.for.svg.xml +33 -0
  1131. data/lib/stylesheets/params/use.extensions.xml +31 -0
  1132. data/lib/stylesheets/params/use.id.as.filename.xml +30 -0
  1133. data/lib/stylesheets/params/use.id.function.xml +32 -0
  1134. data/lib/stylesheets/params/use.local.olink.style.xml +28 -0
  1135. data/lib/stylesheets/params/use.role.as.xrefstyle.xml +93 -0
  1136. data/lib/stylesheets/params/use.role.for.mediaobject.xml +56 -0
  1137. data/lib/stylesheets/params/use.svg.xml +30 -0
  1138. data/lib/stylesheets/params/variablelist.as.blocks.xml +62 -0
  1139. data/lib/stylesheets/params/variablelist.as.table.xml +54 -0
  1140. data/lib/stylesheets/params/variablelist.max.termlength.xml +46 -0
  1141. data/lib/stylesheets/params/variablelist.term.break.after.xml +39 -0
  1142. data/lib/stylesheets/params/variablelist.term.properties.xml +29 -0
  1143. data/lib/stylesheets/params/variablelist.term.separator.xml +40 -0
  1144. data/lib/stylesheets/params/verbatim.properties.xml +38 -0
  1145. data/lib/stylesheets/params/wordml.template.xml +29 -0
  1146. data/lib/stylesheets/params/writing.mode.xml +83 -0
  1147. data/lib/stylesheets/params/xbCollapsibleLists.js.xml +28 -0
  1148. data/lib/stylesheets/params/xbDOM.js.xml +28 -0
  1149. data/lib/stylesheets/params/xbLibrary.js.xml +28 -0
  1150. data/lib/stylesheets/params/xbStyle.js.xml +28 -0
  1151. data/lib/stylesheets/params/xep.extensions.xml +31 -0
  1152. data/lib/stylesheets/params/xep.index.item.properties.xml +36 -0
  1153. data/lib/stylesheets/params/xref.label-page.separator.xml +38 -0
  1154. data/lib/stylesheets/params/xref.label-title.separator.xml +36 -0
  1155. data/lib/stylesheets/params/xref.properties.xml +29 -0
  1156. data/lib/stylesheets/params/xref.title-page.separator.xml +36 -0
  1157. data/lib/stylesheets/params/xref.with.number.and.title.xml +30 -0
  1158. data/lib/stylesheets/profiling/profile-mode.xsl +239 -0
  1159. data/lib/stylesheets/profiling/profile.xsl +58 -0
  1160. data/lib/stylesheets/profiling/strip-attributes.xsl +27 -0
  1161. data/lib/stylesheets/profiling/xsl2profile.xsl +159 -0
  1162. data/lib/stylesheets/roundtrip/blocks-spec.xml +11 -0
  1163. data/lib/stylesheets/roundtrip/blocks2dbk.dtd +76 -0
  1164. data/lib/stylesheets/roundtrip/blocks2dbk.xsl +1734 -0
  1165. data/lib/stylesheets/roundtrip/dbk2ooo.xsl +178 -0
  1166. data/lib/stylesheets/roundtrip/dbk2pages.xsl +442 -0
  1167. data/lib/stylesheets/roundtrip/dbk2wordml.xsl +402 -0
  1168. data/lib/stylesheets/roundtrip/dbk2wp.xsl +1376 -0
  1169. data/lib/stylesheets/roundtrip/normalise-common.xsl +39 -0
  1170. data/lib/stylesheets/roundtrip/normalise2sections.xsl +1270 -0
  1171. data/lib/stylesheets/roundtrip/pages2normalise.xsl +352 -0
  1172. data/lib/stylesheets/roundtrip/param.xml +105 -0
  1173. data/lib/stylesheets/roundtrip/param.xsl +20 -0
  1174. data/lib/stylesheets/roundtrip/sections-spec.xml +38 -0
  1175. data/lib/stylesheets/roundtrip/sections2blocks.xsl +263 -0
  1176. data/lib/stylesheets/roundtrip/specifications.xml +1420 -0
  1177. data/lib/stylesheets/roundtrip/template-pages.xml +2 -0
  1178. data/lib/stylesheets/roundtrip/template.dot +0 -0
  1179. data/lib/stylesheets/roundtrip/template.xml +3 -0
  1180. data/lib/stylesheets/roundtrip/wordml2normalise.xsl +446 -0
  1181. data/lib/stylesheets/slides/browser/CTOCWidget.js +169 -0
  1182. data/lib/stylesheets/slides/browser/overlay.js +142 -0
  1183. data/lib/stylesheets/slides/browser/slides-default.css +9 -0
  1184. data/lib/stylesheets/slides/browser/slides-frames.css +73 -0
  1185. data/lib/stylesheets/slides/browser/slides-plain.css +1 -0
  1186. data/lib/stylesheets/slides/browser/slides-table.css +41 -0
  1187. data/lib/stylesheets/slides/browser/slides-w3c.css +1 -0
  1188. data/lib/stylesheets/slides/browser/slides.css +119 -0
  1189. data/lib/stylesheets/slides/browser/slides.js +120 -0
  1190. data/lib/stylesheets/slides/browser/ua.js +135 -0
  1191. data/lib/stylesheets/slides/browser/xbCollapsibleLists.js +537 -0
  1192. data/lib/stylesheets/slides/browser/xbDOM.js +374 -0
  1193. data/lib/stylesheets/slides/browser/xbDebug.js +311 -0
  1194. data/lib/stylesheets/slides/browser/xbLibrary.js +80 -0
  1195. data/lib/stylesheets/slides/browser/xbStyle-css.js +791 -0
  1196. data/lib/stylesheets/slides/browser/xbStyle-nn4.js +485 -0
  1197. data/lib/stylesheets/slides/browser/xbStyle-not-supported.js +77 -0
  1198. data/lib/stylesheets/slides/browser/xbStyle.js +295 -0
  1199. data/lib/stylesheets/slides/fo/param.xml +356 -0
  1200. data/lib/stylesheets/slides/fo/param.xsl +74 -0
  1201. data/lib/stylesheets/slides/fo/plain-titlepage.xml +79 -0
  1202. data/lib/stylesheets/slides/fo/plain-titlepage.xsl +187 -0
  1203. data/lib/stylesheets/slides/fo/plain.xsl +528 -0
  1204. data/lib/stylesheets/slides/graphics/active/arr-next.png +0 -0
  1205. data/lib/stylesheets/slides/graphics/active/arr-prev.png +0 -0
  1206. data/lib/stylesheets/slides/graphics/active/but-fforward.png +0 -0
  1207. data/lib/stylesheets/slides/graphics/active/but-info.png +0 -0
  1208. data/lib/stylesheets/slides/graphics/active/but-next.png +0 -0
  1209. data/lib/stylesheets/slides/graphics/active/but-prev.png +0 -0
  1210. data/lib/stylesheets/slides/graphics/active/but-rewind.png +0 -0
  1211. data/lib/stylesheets/slides/graphics/active/nav-home.png +0 -0
  1212. data/lib/stylesheets/slides/graphics/active/nav-next.png +0 -0
  1213. data/lib/stylesheets/slides/graphics/active/nav-prev.png +0 -0
  1214. data/lib/stylesheets/slides/graphics/active/nav-toc.png +0 -0
  1215. data/lib/stylesheets/slides/graphics/active/nav-up.png +0 -0
  1216. data/lib/stylesheets/slides/graphics/active/w3c-next.png +0 -0
  1217. data/lib/stylesheets/slides/graphics/active/w3c-prev.png +0 -0
  1218. data/lib/stylesheets/slides/graphics/active/w3c-toc.png +0 -0
  1219. data/lib/stylesheets/slides/graphics/arrow.gif +0 -0
  1220. data/lib/stylesheets/slides/graphics/blank.gif +0 -0
  1221. data/lib/stylesheets/slides/graphics/blank.png +0 -0
  1222. data/lib/stylesheets/slides/graphics/hidetoc.gif +0 -0
  1223. data/lib/stylesheets/slides/graphics/inactive/but-fforward.png +0 -0
  1224. data/lib/stylesheets/slides/graphics/inactive/but-info.png +0 -0
  1225. data/lib/stylesheets/slides/graphics/inactive/but-next.png +0 -0
  1226. data/lib/stylesheets/slides/graphics/inactive/but-prev.png +0 -0
  1227. data/lib/stylesheets/slides/graphics/inactive/but-rewind.png +0 -0
  1228. data/lib/stylesheets/slides/graphics/inactive/nav-home.png +0 -0
  1229. data/lib/stylesheets/slides/graphics/inactive/nav-next.png +0 -0
  1230. data/lib/stylesheets/slides/graphics/inactive/nav-prev.png +0 -0
  1231. data/lib/stylesheets/slides/graphics/inactive/nav-toc.png +0 -0
  1232. data/lib/stylesheets/slides/graphics/inactive/nav-up.png +0 -0
  1233. data/lib/stylesheets/slides/graphics/inactive/w3c-next.png +0 -0
  1234. data/lib/stylesheets/slides/graphics/inactive/w3c-prev.png +0 -0
  1235. data/lib/stylesheets/slides/graphics/inactive/w3c-toc.png +0 -0
  1236. data/lib/stylesheets/slides/graphics/plus.gif +0 -0
  1237. data/lib/stylesheets/slides/graphics/pointer.png +0 -0
  1238. data/lib/stylesheets/slides/graphics/showtoc.gif +0 -0
  1239. data/lib/stylesheets/slides/graphics/toc/bullet.png +0 -0
  1240. data/lib/stylesheets/slides/graphics/toc/closed.png +0 -0
  1241. data/lib/stylesheets/slides/graphics/toc/open.png +0 -0
  1242. data/lib/stylesheets/slides/html/css.xsl +46 -0
  1243. data/lib/stylesheets/slides/html/default.xsl +261 -0
  1244. data/lib/stylesheets/slides/html/flat.xsl +70 -0
  1245. data/lib/stylesheets/slides/html/frames.xsl +2016 -0
  1246. data/lib/stylesheets/slides/html/graphics.xsl +151 -0
  1247. data/lib/stylesheets/slides/html/jscript.xsl +127 -0
  1248. data/lib/stylesheets/slides/html/param.xml +1376 -0
  1249. data/lib/stylesheets/slides/html/param.xsl +68 -0
  1250. data/lib/stylesheets/slides/html/plain.xsl +472 -0
  1251. data/lib/stylesheets/slides/html/slides-common.xsl +1541 -0
  1252. data/lib/stylesheets/slides/html/tables.xsl +336 -0
  1253. data/lib/stylesheets/slides/html/vslides.xsl +667 -0
  1254. data/lib/stylesheets/slides/html/w3c.xsl +376 -0
  1255. data/lib/stylesheets/slides/htmlhelp/htmlhelp.xsl +89 -0
  1256. data/lib/stylesheets/slides/keynote/default.xsl +600 -0
  1257. data/lib/stylesheets/slides/keynote/xsltsl/cmp.xsl +348 -0
  1258. data/lib/stylesheets/slides/keynote/xsltsl/date-time.xsl +1524 -0
  1259. data/lib/stylesheets/slides/keynote/xsltsl/example.xsl +90 -0
  1260. data/lib/stylesheets/slides/keynote/xsltsl/markup.xsl +789 -0
  1261. data/lib/stylesheets/slides/keynote/xsltsl/math.xsl +704 -0
  1262. data/lib/stylesheets/slides/keynote/xsltsl/node.xsl +229 -0
  1263. data/lib/stylesheets/slides/keynote/xsltsl/stdlib.xsl +340 -0
  1264. data/lib/stylesheets/slides/keynote/xsltsl/string.xsl +1233 -0
  1265. data/lib/stylesheets/slides/keynote/xsltsl/svg.xsl +177 -0
  1266. data/lib/stylesheets/slides/keynote/xsltsl/uri.xsl +580 -0
  1267. data/lib/stylesheets/slides/svg/default.xsl +686 -0
  1268. data/lib/stylesheets/slides/xhtml/css.xsl +47 -0
  1269. data/lib/stylesheets/slides/xhtml/default.xsl +246 -0
  1270. data/lib/stylesheets/slides/xhtml/flat.xsl +71 -0
  1271. data/lib/stylesheets/slides/xhtml/frames.xsl +1982 -0
  1272. data/lib/stylesheets/slides/xhtml/graphics.xsl +152 -0
  1273. data/lib/stylesheets/slides/xhtml/jscript.xsl +128 -0
  1274. data/lib/stylesheets/slides/xhtml/param.xsl +70 -0
  1275. data/lib/stylesheets/slides/xhtml/plain.xsl +470 -0
  1276. data/lib/stylesheets/slides/xhtml/slides-common.xsl +1534 -0
  1277. data/lib/stylesheets/slides/xhtml/tables.xsl +334 -0
  1278. data/lib/stylesheets/slides/xhtml/vslides.xsl +652 -0
  1279. data/lib/stylesheets/slides/xhtml/w3c.xsl +358 -0
  1280. data/lib/stylesheets/template/titlepage.xml +478 -0
  1281. data/lib/stylesheets/template/titlepage.xsl +1355 -0
  1282. data/lib/stylesheets/tests/refentry.007.ns.xml +325 -0
  1283. data/lib/stylesheets/tests/refentry.007.xml +340 -0
  1284. data/lib/stylesheets/tools/bin/docbook-xsl-update +53 -0
  1285. data/lib/stylesheets/tools/make/Makefile.DocBook +698 -0
  1286. data/lib/stylesheets/tools/make/Makefile.combine +182 -0
  1287. data/lib/stylesheets/tools/make/Makefile.docParam +59 -0
  1288. data/lib/stylesheets/webhelp/LICENSE +1 -0
  1289. data/lib/stylesheets/webhelp/build.properties +43 -0
  1290. data/lib/stylesheets/webhelp/build.xml +112 -0
  1291. data/lib/stylesheets/webhelp/docs/common/css/positioning.css +109 -0
  1292. data/lib/stylesheets/webhelp/docs/common/images/header-bg.gif +0 -0
  1293. data/lib/stylesheets/webhelp/docs/common/images/highlight-blue.gif +0 -0
  1294. data/lib/stylesheets/webhelp/docs/common/images/highlight-yellow.gif +0 -0
  1295. data/lib/stylesheets/webhelp/docs/common/images/loading.gif +0 -0
  1296. data/lib/stylesheets/webhelp/docs/common/images/logo.png +0 -0
  1297. data/lib/stylesheets/webhelp/docs/common/images/showHideTreeIcons.png +0 -0
  1298. data/lib/stylesheets/webhelp/docs/common/jquery/jquery-1.4.2.min.js +154 -0
  1299. data/lib/stylesheets/webhelp/docs/common/jquery/jquery-ui-1.8.2.custom.min.js +321 -0
  1300. data/lib/stylesheets/webhelp/docs/common/jquery/jquery.cookie.js +93 -0
  1301. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-anim_basic_16x16.gif +0 -0
  1302. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_flat_0_aaaaaa_40x100.png +0 -0
  1303. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_flat_55_fbec88_40x100.png +0 -0
  1304. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_glass_75_d0e5f5_1x400.png +0 -0
  1305. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_glass_85_dfeffc_1x400.png +0 -0
  1306. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_glass_95_fef1ec_1x400.png +0 -0
  1307. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_gloss-wave_55_5c9ccc_500x100.png +0 -0
  1308. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_f5f8f9_1x100.png +0 -0
  1309. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_fcfdfd_1x100.png +0 -0
  1310. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_217bc0_256x240.png +0 -0
  1311. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_2e83ff_256x240.png +0 -0
  1312. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_469bdd_256x240.png +0 -0
  1313. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_6da8d5_256x240.png +0 -0
  1314. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_cd0a0a_256x240.png +0 -0
  1315. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_d8e7f3_256x240.png +0 -0
  1316. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/images/ui-icons_f9bd01_256x240.png +0 -0
  1317. data/lib/stylesheets/webhelp/docs/common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css +398 -0
  1318. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/file.gif +0 -0
  1319. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/folder-closed.gif +0 -0
  1320. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/folder-closed2.gif +0 -0
  1321. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/folder.gif +0 -0
  1322. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/folder2.gif +0 -0
  1323. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/minus.gif +0 -0
  1324. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/plus.gif +0 -0
  1325. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-black-line.gif +0 -0
  1326. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-black.gif +0 -0
  1327. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-default-line.gif +0 -0
  1328. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-default.gif +0 -0
  1329. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-famfamfam-line.gif +0 -0
  1330. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-famfamfam.gif +0 -0
  1331. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-gray-line.gif +0 -0
  1332. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-gray.gif +0 -0
  1333. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-red-line.gif +0 -0
  1334. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/images/treeview-red.gif +0 -0
  1335. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/jquery.treeview.async.js +72 -0
  1336. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/jquery.treeview.css +85 -0
  1337. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/jquery.treeview.js +255 -0
  1338. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/jquery.treeview.min.js +16 -0
  1339. data/lib/stylesheets/webhelp/docs/common/jquery/treeview/jquery.treeview.pack.js +16 -0
  1340. data/lib/stylesheets/webhelp/docs/common/main.js +161 -0
  1341. data/lib/stylesheets/webhelp/docs/content/ch01.html +61 -0
  1342. data/lib/stylesheets/webhelp/docs/content/ch02.html +32 -0
  1343. data/lib/stylesheets/webhelp/docs/content/ch02s01.html +117 -0
  1344. data/lib/stylesheets/webhelp/docs/content/ch02s02.html +102 -0
  1345. data/lib/stylesheets/webhelp/docs/content/ch02s03.html +36 -0
  1346. data/lib/stylesheets/webhelp/docs/content/ch02s04.html +42 -0
  1347. data/lib/stylesheets/webhelp/docs/content/ch03.html +37 -0
  1348. data/lib/stylesheets/webhelp/docs/content/ch03s01.html +62 -0
  1349. data/lib/stylesheets/webhelp/docs/content/ch03s02.html +124 -0
  1350. data/lib/stylesheets/webhelp/docs/content/index.html +71 -0
  1351. data/lib/stylesheets/webhelp/docs/content/search/htmlFileInfoList.js +10 -0
  1352. data/lib/stylesheets/webhelp/docs/content/search/htmlFileList.js +11 -0
  1353. data/lib/stylesheets/webhelp/docs/content/search/index-1.js +224 -0
  1354. data/lib/stylesheets/webhelp/docs/content/search/index-2.js +223 -0
  1355. data/lib/stylesheets/webhelp/docs/content/search/index-3.js +221 -0
  1356. data/lib/stylesheets/webhelp/docs/content/search/nwSearchFnt.js +513 -0
  1357. data/lib/stylesheets/webhelp/docs/content/search/stemmers/en_stemmer.js +187 -0
  1358. data/lib/stylesheets/webhelp/docs/favicon.ico +0 -0
  1359. data/lib/stylesheets/webhelp/docs/index.html +13 -0
  1360. data/lib/stylesheets/webhelp/docsrc/readme.xml +891 -0
  1361. data/lib/stylesheets/webhelp/template/common/css/positioning.css +109 -0
  1362. data/lib/stylesheets/webhelp/template/common/images/header-bg.gif +0 -0
  1363. data/lib/stylesheets/webhelp/template/common/images/highlight-blue.gif +0 -0
  1364. data/lib/stylesheets/webhelp/template/common/images/highlight-yellow.gif +0 -0
  1365. data/lib/stylesheets/webhelp/template/common/images/loading.gif +0 -0
  1366. data/lib/stylesheets/webhelp/template/common/images/logo.png +0 -0
  1367. data/lib/stylesheets/webhelp/template/common/images/showHideTreeIcons.png +0 -0
  1368. data/lib/stylesheets/webhelp/template/common/jquery/jquery-1.4.2.min.js +154 -0
  1369. data/lib/stylesheets/webhelp/template/common/jquery/jquery-ui-1.8.2.custom.min.js +321 -0
  1370. data/lib/stylesheets/webhelp/template/common/jquery/jquery.cookie.js +93 -0
  1371. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-anim_basic_16x16.gif +0 -0
  1372. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_flat_0_aaaaaa_40x100.png +0 -0
  1373. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_flat_55_fbec88_40x100.png +0 -0
  1374. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_glass_75_d0e5f5_1x400.png +0 -0
  1375. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_glass_85_dfeffc_1x400.png +0 -0
  1376. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_glass_95_fef1ec_1x400.png +0 -0
  1377. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_gloss-wave_55_5c9ccc_500x100.png +0 -0
  1378. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_f5f8f9_1x100.png +0 -0
  1379. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-bg_inset-hard_100_fcfdfd_1x100.png +0 -0
  1380. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_217bc0_256x240.png +0 -0
  1381. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_2e83ff_256x240.png +0 -0
  1382. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_469bdd_256x240.png +0 -0
  1383. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_6da8d5_256x240.png +0 -0
  1384. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_cd0a0a_256x240.png +0 -0
  1385. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_d8e7f3_256x240.png +0 -0
  1386. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/images/ui-icons_f9bd01_256x240.png +0 -0
  1387. data/lib/stylesheets/webhelp/template/common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css +398 -0
  1388. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/file.gif +0 -0
  1389. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/folder-closed.gif +0 -0
  1390. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/folder-closed2.gif +0 -0
  1391. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/folder.gif +0 -0
  1392. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/folder2.gif +0 -0
  1393. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/minus.gif +0 -0
  1394. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/plus.gif +0 -0
  1395. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-black-line.gif +0 -0
  1396. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-black.gif +0 -0
  1397. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-default-line.gif +0 -0
  1398. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-default.gif +0 -0
  1399. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-famfamfam-line.gif +0 -0
  1400. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-famfamfam.gif +0 -0
  1401. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-gray-line.gif +0 -0
  1402. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-gray.gif +0 -0
  1403. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-red-line.gif +0 -0
  1404. data/lib/stylesheets/webhelp/template/common/jquery/treeview/images/treeview-red.gif +0 -0
  1405. data/lib/stylesheets/webhelp/template/common/jquery/treeview/jquery.treeview.async.js +72 -0
  1406. data/lib/stylesheets/webhelp/template/common/jquery/treeview/jquery.treeview.css +85 -0
  1407. data/lib/stylesheets/webhelp/template/common/jquery/treeview/jquery.treeview.js +255 -0
  1408. data/lib/stylesheets/webhelp/template/common/jquery/treeview/jquery.treeview.min.js +16 -0
  1409. data/lib/stylesheets/webhelp/template/common/jquery/treeview/jquery.treeview.pack.js +16 -0
  1410. data/lib/stylesheets/webhelp/template/common/main.js +161 -0
  1411. data/lib/stylesheets/webhelp/template/content/search/default.props +1 -0
  1412. data/lib/stylesheets/webhelp/template/content/search/en-us.props +45 -0
  1413. data/lib/stylesheets/webhelp/template/content/search/es-es.props +179 -0
  1414. data/lib/stylesheets/webhelp/template/content/search/ja-jp.props +1 -0
  1415. data/lib/stylesheets/webhelp/template/content/search/nwSearchFnt.js +513 -0
  1416. data/lib/stylesheets/webhelp/template/content/search/punctuation.props +31 -0
  1417. data/lib/stylesheets/webhelp/template/content/search/stemmers/de_stemmer.js +247 -0
  1418. data/lib/stylesheets/webhelp/template/content/search/stemmers/en_stemmer.js +187 -0
  1419. data/lib/stylesheets/webhelp/template/content/search/stemmers/fr_stemmer.js +299 -0
  1420. data/lib/stylesheets/webhelp/template/favicon.ico +0 -0
  1421. data/lib/stylesheets/webhelp/xsl/webhelp.xsl +772 -0
  1422. data/lib/stylesheets/website/autolayout.xsl +258 -0
  1423. data/lib/stylesheets/website/chunk-common.xsl +227 -0
  1424. data/lib/stylesheets/website/chunk-tabular.xsl +12 -0
  1425. data/lib/stylesheets/website/chunk-website.xsl +12 -0
  1426. data/lib/stylesheets/website/head.xsl +316 -0
  1427. data/lib/stylesheets/website/makefile-dep.xsl +143 -0
  1428. data/lib/stylesheets/website/olink.xsl +297 -0
  1429. data/lib/stylesheets/website/param.xml +788 -0
  1430. data/lib/stylesheets/website/param.xsl +53 -0
  1431. data/lib/stylesheets/website/rss.xsl +143 -0
  1432. data/lib/stylesheets/website/tabular.xsl +213 -0
  1433. data/lib/stylesheets/website/toc-tabular.xsl +480 -0
  1434. data/lib/stylesheets/website/toc.xsl +286 -0
  1435. data/lib/stylesheets/website/website-common.xsl +821 -0
  1436. data/lib/stylesheets/website/website-targets.xsl +27 -0
  1437. data/lib/stylesheets/website/website.xsl +132 -0
  1438. data/lib/stylesheets/website/xbel.xsl +114 -0
  1439. data/lib/stylesheets/xhtml/admon.xsl +137 -0
  1440. data/lib/stylesheets/xhtml/annotations.xsl +160 -0
  1441. data/lib/stylesheets/xhtml/autoidx-kimber.xsl +140 -0
  1442. data/lib/stylesheets/xhtml/autoidx-kosek.xsl +110 -0
  1443. data/lib/stylesheets/xhtml/autoidx-ng.xsl +23 -0
  1444. data/lib/stylesheets/xhtml/autoidx.xsl +682 -0
  1445. data/lib/stylesheets/xhtml/autotoc.xsl +665 -0
  1446. data/lib/stylesheets/xhtml/biblio-iso690.xsl +1302 -0
  1447. data/lib/stylesheets/xhtml/biblio.xsl +1242 -0
  1448. data/lib/stylesheets/xhtml/block.xsl +537 -0
  1449. data/lib/stylesheets/xhtml/callout.xsl +189 -0
  1450. data/lib/stylesheets/xhtml/changebars.xsl +80 -0
  1451. data/lib/stylesheets/xhtml/chunk-changebars.xsl +97 -0
  1452. data/lib/stylesheets/xhtml/chunk-code.xsl +644 -0
  1453. data/lib/stylesheets/xhtml/chunk-common.xsl +1562 -0
  1454. data/lib/stylesheets/xhtml/chunk.xsl +53 -0
  1455. data/lib/stylesheets/xhtml/chunker.xsl +303 -0
  1456. data/lib/stylesheets/xhtml/chunkfast.xsl +70 -0
  1457. data/lib/stylesheets/xhtml/chunktoc.xsl +527 -0
  1458. data/lib/stylesheets/xhtml/component.xsl +397 -0
  1459. data/lib/stylesheets/xhtml/division.xsl +219 -0
  1460. data/lib/stylesheets/xhtml/docbook.css.xml +109 -0
  1461. data/lib/stylesheets/xhtml/docbook.xsl +435 -0
  1462. data/lib/stylesheets/xhtml/ebnf.xsl +329 -0
  1463. data/lib/stylesheets/xhtml/footnote.xsl +306 -0
  1464. data/lib/stylesheets/xhtml/formal.xsl +413 -0
  1465. data/lib/stylesheets/xhtml/glossary.xsl +565 -0
  1466. data/lib/stylesheets/xhtml/graphics.xsl +1437 -0
  1467. data/lib/stylesheets/xhtml/highlight.xsl +89 -0
  1468. data/lib/stylesheets/xhtml/html-rtf.xsl +321 -0
  1469. data/lib/stylesheets/xhtml/html.xsl +600 -0
  1470. data/lib/stylesheets/xhtml/htmltbl.xsl +104 -0
  1471. data/lib/stylesheets/xhtml/index.xsl +266 -0
  1472. data/lib/stylesheets/xhtml/info.xsl +46 -0
  1473. data/lib/stylesheets/xhtml/inline.xsl +1452 -0
  1474. data/lib/stylesheets/xhtml/keywords.xsl +38 -0
  1475. data/lib/stylesheets/xhtml/lists.xsl +1123 -0
  1476. data/lib/stylesheets/xhtml/maketoc.xsl +92 -0
  1477. data/lib/stylesheets/xhtml/manifest.xsl +23 -0
  1478. data/lib/stylesheets/xhtml/math.xsl +285 -0
  1479. data/lib/stylesheets/xhtml/oldchunker.xsl +177 -0
  1480. data/lib/stylesheets/xhtml/onechunk.xsl +37 -0
  1481. data/lib/stylesheets/xhtml/param.xsl +438 -0
  1482. data/lib/stylesheets/xhtml/pi.xsl +1204 -0
  1483. data/lib/stylesheets/xhtml/profile-chunk-code.xsl +616 -0
  1484. data/lib/stylesheets/xhtml/profile-chunk.xsl +53 -0
  1485. data/lib/stylesheets/xhtml/profile-docbook.xsl +407 -0
  1486. data/lib/stylesheets/xhtml/profile-onechunk.xsl +37 -0
  1487. data/lib/stylesheets/xhtml/qandaset.xsl +421 -0
  1488. data/lib/stylesheets/xhtml/refentry.xsl +301 -0
  1489. data/lib/stylesheets/xhtml/sections.xsl +543 -0
  1490. data/lib/stylesheets/xhtml/synop.xsl +1515 -0
  1491. data/lib/stylesheets/xhtml/table.xsl +1169 -0
  1492. data/lib/stylesheets/xhtml/task.xsl +75 -0
  1493. data/lib/stylesheets/xhtml/titlepage.templates.xsl +3818 -0
  1494. data/lib/stylesheets/xhtml/titlepage.xsl +1032 -0
  1495. data/lib/stylesheets/xhtml/toc.xsl +332 -0
  1496. data/lib/stylesheets/xhtml/verbatim.xsl +389 -0
  1497. data/lib/stylesheets/xhtml/xref.xsl +1317 -0
  1498. data/lib/stylesheets/xhtml-1_1/admon.xsl +135 -0
  1499. data/lib/stylesheets/xhtml-1_1/annotations.xsl +160 -0
  1500. data/lib/stylesheets/xhtml-1_1/autoidx-kimber.xsl +140 -0
  1501. data/lib/stylesheets/xhtml-1_1/autoidx-kosek.xsl +110 -0
  1502. data/lib/stylesheets/xhtml-1_1/autoidx-ng.xsl +23 -0
  1503. data/lib/stylesheets/xhtml-1_1/autoidx.xsl +682 -0
  1504. data/lib/stylesheets/xhtml-1_1/autotoc.xsl +665 -0
  1505. data/lib/stylesheets/xhtml-1_1/biblio-iso690.xsl +1302 -0
  1506. data/lib/stylesheets/xhtml-1_1/biblio.xsl +1242 -0
  1507. data/lib/stylesheets/xhtml-1_1/block.xsl +537 -0
  1508. data/lib/stylesheets/xhtml-1_1/callout.xsl +189 -0
  1509. data/lib/stylesheets/xhtml-1_1/changebars.xsl +80 -0
  1510. data/lib/stylesheets/xhtml-1_1/chunk-changebars.xsl +97 -0
  1511. data/lib/stylesheets/xhtml-1_1/chunk-code.xsl +644 -0
  1512. data/lib/stylesheets/xhtml-1_1/chunk-common.xsl +1562 -0
  1513. data/lib/stylesheets/xhtml-1_1/chunk.xsl +53 -0
  1514. data/lib/stylesheets/xhtml-1_1/chunker.xsl +303 -0
  1515. data/lib/stylesheets/xhtml-1_1/chunkfast.xsl +70 -0
  1516. data/lib/stylesheets/xhtml-1_1/chunktoc.xsl +527 -0
  1517. data/lib/stylesheets/xhtml-1_1/component.xsl +397 -0
  1518. data/lib/stylesheets/xhtml-1_1/division.xsl +219 -0
  1519. data/lib/stylesheets/xhtml-1_1/docbook.css.xml +109 -0
  1520. data/lib/stylesheets/xhtml-1_1/docbook.xsl +435 -0
  1521. data/lib/stylesheets/xhtml-1_1/ebnf.xsl +329 -0
  1522. data/lib/stylesheets/xhtml-1_1/footnote.xsl +306 -0
  1523. data/lib/stylesheets/xhtml-1_1/formal.xsl +413 -0
  1524. data/lib/stylesheets/xhtml-1_1/glossary.xsl +565 -0
  1525. data/lib/stylesheets/xhtml-1_1/graphics.xsl +1437 -0
  1526. data/lib/stylesheets/xhtml-1_1/highlight.xsl +89 -0
  1527. data/lib/stylesheets/xhtml-1_1/html-rtf.xsl +321 -0
  1528. data/lib/stylesheets/xhtml-1_1/html.xsl +600 -0
  1529. data/lib/stylesheets/xhtml-1_1/htmltbl.xsl +104 -0
  1530. data/lib/stylesheets/xhtml-1_1/index.xsl +266 -0
  1531. data/lib/stylesheets/xhtml-1_1/info.xsl +46 -0
  1532. data/lib/stylesheets/xhtml-1_1/inline.xsl +1452 -0
  1533. data/lib/stylesheets/xhtml-1_1/keywords.xsl +38 -0
  1534. data/lib/stylesheets/xhtml-1_1/lists.xsl +1090 -0
  1535. data/lib/stylesheets/xhtml-1_1/maketoc.xsl +92 -0
  1536. data/lib/stylesheets/xhtml-1_1/manifest.xsl +23 -0
  1537. data/lib/stylesheets/xhtml-1_1/math.xsl +285 -0
  1538. data/lib/stylesheets/xhtml-1_1/oldchunker.xsl +177 -0
  1539. data/lib/stylesheets/xhtml-1_1/onechunk.xsl +37 -0
  1540. data/lib/stylesheets/xhtml-1_1/param.xsl +438 -0
  1541. data/lib/stylesheets/xhtml-1_1/pi.xsl +1204 -0
  1542. data/lib/stylesheets/xhtml-1_1/profile-chunk-code.xsl +616 -0
  1543. data/lib/stylesheets/xhtml-1_1/profile-chunk.xsl +53 -0
  1544. data/lib/stylesheets/xhtml-1_1/profile-docbook.xsl +407 -0
  1545. data/lib/stylesheets/xhtml-1_1/profile-onechunk.xsl +37 -0
  1546. data/lib/stylesheets/xhtml-1_1/qandaset.xsl +421 -0
  1547. data/lib/stylesheets/xhtml-1_1/refentry.xsl +301 -0
  1548. data/lib/stylesheets/xhtml-1_1/sections.xsl +543 -0
  1549. data/lib/stylesheets/xhtml-1_1/synop.xsl +1515 -0
  1550. data/lib/stylesheets/xhtml-1_1/table.xsl +1169 -0
  1551. data/lib/stylesheets/xhtml-1_1/task.xsl +75 -0
  1552. data/lib/stylesheets/xhtml-1_1/titlepage.templates.xsl +3818 -0
  1553. data/lib/stylesheets/xhtml-1_1/titlepage.xsl +1032 -0
  1554. data/lib/stylesheets/xhtml-1_1/toc.xsl +332 -0
  1555. data/lib/stylesheets/xhtml-1_1/verbatim.xsl +389 -0
  1556. data/lib/stylesheets/xhtml-1_1/xref.xsl +1317 -0
  1557. metadata +1654 -0
@@ -0,0 +1,3220 @@
1
+ <?xml version="1.0" encoding="ASCII"?>
2
+ <book version="5.0">
3
+ <info>
4
+ <title>Manpages Parameter Reference</title>
5
+ <releaseinfo role="meta">
6
+ $Id: param.xweb 8235 2009-02-09 16:22:14Z xmldoc $
7
+ </releaseinfo>
8
+ <author>
9
+ <orgname>The DocBook Project</orgname>
10
+ </author>
11
+ <copyright>
12
+ <year>2005-2007</year>
13
+ <holder>The DocBook Project</holder>
14
+ </copyright>
15
+ <abstract>
16
+ <para>This is reference documentation for all user-configurable
17
+ parameters in the DocBook XSL "manpages" stylesheet (for
18
+ generating groff/nroff output). Note that the manpages
19
+ stylesheet is a customization layer of the DocBook XSL HTML
20
+ stylesheet. Therefore, you can also use a number of <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../html/">HTML stylesheet parameters</link>
21
+ to control manpages output (in addition to the
22
+ manpages-specific parameters listed in this section).</para>
23
+ </abstract>
24
+ </info>
25
+ <reference xml:id="general">
26
+ <title>Hyphenation, justification, and breaking</title>
27
+ <refentry version="5.0" xml:id="man.hyphenate">
28
+ <refmeta>
29
+ <refentrytitle>man.hyphenate</refentrytitle>
30
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
31
+ </refmeta>
32
+ <refnamediv>
33
+ <refname>man.hyphenate</refname>
34
+ <refpurpose>Enable hyphenation?</refpurpose>
35
+ </refnamediv>
36
+
37
+ <refsynopsisdiv>
38
+ <programlisting xml:id="man.hyphenate.frag">
39
+ &lt;xsl:param name="man.hyphenate"&gt;0&lt;/xsl:param&gt;</programlisting>
40
+ </refsynopsisdiv>
41
+
42
+ <refsection><info><title>Description</title></info>
43
+
44
+ <para>If non-zero, hyphenation is enabled.</para>
45
+
46
+ <note>
47
+ <para>The default value for this parameter is zero because groff is
48
+ not particularly smart about how it does hyphenation; it can end up
49
+ hyphenating a lot of things that you don't want hyphenated. To
50
+ mitigate that, the default behavior of the stylesheets is to suppress
51
+ hyphenation of computer inlines, filenames, and URLs. (You can
52
+ override the default behavior by setting non-zero values for the
53
+ <parameter>man.hyphenate.urls</parameter>,
54
+ <parameter>man.hyphenate.filenames</parameter>, and
55
+ <parameter>man.hyphenate.computer.inlines</parameter> parameters.) But
56
+ the best way is still to just globally disable hyphenation, as the
57
+ stylesheets do by default.</para>
58
+
59
+ <para>The only good reason to enabled hyphenation is if you have also
60
+ enabled justification (which is disabled by default). The reason is
61
+ that justified text can look very bad unless you also hyphenate it; to
62
+ quote the <quote>Hypenation</quote> node from the groff info page:
63
+
64
+ <blockquote>
65
+ <para><emphasis>Since the odds are not great for finding a set of
66
+ words, for every output line, which fit nicely on a line without
67
+ inserting excessive amounts of space between words, 'gtroff'
68
+ hyphenates words so that it can justify lines without inserting too
69
+ much space between words.</emphasis></para>
70
+ </blockquote>
71
+
72
+ So, if you set a non-zero value for the
73
+ <parameter>man.justify</parameter> parameter (to enable
74
+ justification), then you should probably also set a non-zero value for
75
+ <parameter>man.hyphenate</parameter> (to enable hyphenation).</para>
76
+ </note>
77
+
78
+
79
+ </refsection>
80
+ </refentry>
81
+
82
+ <refentry version="5.0" xml:id="man.hyphenate.urls">
83
+ <refmeta>
84
+ <refentrytitle>man.hyphenate.urls</refentrytitle>
85
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
86
+ </refmeta>
87
+ <refnamediv>
88
+ <refname>man.hyphenate.urls</refname>
89
+ <refpurpose>Hyphenate URLs?</refpurpose>
90
+ </refnamediv>
91
+
92
+ <refsynopsisdiv>
93
+ <programlisting xml:id="man.hyphenate.urls.frag">
94
+ &lt;xsl:param name="man.hyphenate.urls"&gt;0&lt;/xsl:param&gt;</programlisting>
95
+ </refsynopsisdiv>
96
+
97
+ <refsection><info><title>Description</title></info>
98
+
99
+ <para>If zero (the default), hyphenation is suppressed for output of
100
+ the <tag>ulink</tag> <tag class="attribute">url</tag> attribute.</para>
101
+
102
+ <note>
103
+ <para>If hyphenation is already turned off globally (that is, if
104
+ <parameter>man.hyphenate</parameter> is zero, setting
105
+ <parameter>man.hyphenate.urls</parameter> is not necessary.</para>
106
+ </note>
107
+
108
+ <para>If <parameter>man.hyphenate.urls</parameter> is non-zero, URLs
109
+ will not be treated specially and are subject to hyphenation just like
110
+ other words.</para>
111
+
112
+ <note>
113
+ <para>If you are thinking about setting a non-zero value for
114
+ <parameter>man.hyphenate.urls</parameter> in order to make long
115
+ URLs break across lines, you'd probably be better off
116
+ experimenting with setting the
117
+ <parameter>man.break.after.slash</parameter> parameter first. That
118
+ will cause long URLs to be broken after slashes.</para>
119
+ </note>
120
+
121
+ </refsection>
122
+ </refentry>
123
+
124
+ <refentry version="5.0" xml:id="man.hyphenate.filenames">
125
+ <refmeta>
126
+ <refentrytitle>man.hyphenate.filenames</refentrytitle>
127
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
128
+ </refmeta>
129
+ <refnamediv>
130
+ <refname>man.hyphenate.filenames</refname>
131
+ <refpurpose>Hyphenate filenames?</refpurpose>
132
+ </refnamediv>
133
+
134
+ <refsynopsisdiv>
135
+ <programlisting xml:id="man.hyphenate.filenames.frag">
136
+ &lt;xsl:param name="man.hyphenate.filenames"&gt;0&lt;/xsl:param&gt;</programlisting>
137
+ </refsynopsisdiv>
138
+
139
+ <refsection><info><title>Description</title></info>
140
+
141
+ <para>If zero (the default), hyphenation is suppressed for
142
+ <tag>filename</tag> output.</para>
143
+
144
+ <note>
145
+ <para>If hyphenation is already turned off globally (that is, if
146
+ <parameter>man.hyphenate</parameter> is zero, setting
147
+ <parameter>man.hyphenate.filenames</parameter> is not
148
+ necessary.</para>
149
+ </note>
150
+
151
+ <para>If <parameter>man.hyphenate.filenames</parameter> is non-zero,
152
+ filenames will not be treated specially and are subject to hyphenation
153
+ just like other words.</para>
154
+
155
+ <note>
156
+ <para>If you are thinking about setting a non-zero value for
157
+ <parameter>man.hyphenate.filenames</parameter> in order to make long
158
+ filenames/pathnames break across lines, you'd probably be better off
159
+ experimenting with setting the
160
+ <parameter>man.break.after.slash</parameter> parameter first. That
161
+ will cause long pathnames to be broken after slashes.</para>
162
+ </note>
163
+
164
+ </refsection>
165
+ </refentry>
166
+
167
+ <refentry version="5.0" xml:id="man.hyphenate.computer.inlines">
168
+ <refmeta>
169
+ <refentrytitle>man.hyphenate.computer.inlines</refentrytitle>
170
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
171
+ </refmeta>
172
+ <refnamediv>
173
+ <refname>man.hyphenate.computer.inlines</refname>
174
+ <refpurpose>Hyphenate computer inlines?</refpurpose>
175
+ </refnamediv>
176
+
177
+ <refsynopsisdiv>
178
+ <programlisting xml:id="man.hyphenate.computer.inlines.frag">
179
+ &lt;xsl:param name="man.hyphenate.computer.inlines"&gt;0&lt;/xsl:param&gt;</programlisting>
180
+ </refsynopsisdiv>
181
+
182
+ <refsection><info><title>Description</title></info>
183
+
184
+ <para>If zero (the default), hyphenation is suppressed for
185
+ <quote>computer inlines</quote> such as environment variables,
186
+ constants, etc. This parameter current affects output of the following
187
+ elements:
188
+ <simplelist type="inline">
189
+
190
+ <member><tag>classname</tag></member>
191
+ <member><tag>constant</tag></member>
192
+ <member><tag>envar</tag></member>
193
+ <member><tag>errorcode</tag></member>
194
+ <member><tag>option</tag></member>
195
+ <member><tag>replaceable</tag></member>
196
+ <member><tag>userinput</tag></member>
197
+ <member><tag>type</tag></member>
198
+ <member><tag>varname</tag></member>
199
+ </simplelist>
200
+ </para>
201
+
202
+ <note>
203
+ <para>If hyphenation is already turned off globally (that is, if
204
+ <parameter>man.hyphenate</parameter> is zero, setting the
205
+ <parameter>man.hyphenate.computer.inlines</parameter> is not
206
+ necessary.</para>
207
+ </note>
208
+
209
+ <para>If <parameter>man.hyphenate.computer.inlines</parameter> is
210
+ non-zero, computer inlines will not be treated specially and will be
211
+ hyphenated like other words when needed.</para>
212
+
213
+ </refsection>
214
+ </refentry>
215
+
216
+ <refentry version="5.0" xml:id="man.justify">
217
+ <refmeta>
218
+ <refentrytitle>man.justify</refentrytitle>
219
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
220
+ </refmeta>
221
+ <refnamediv>
222
+ <refname>man.justify</refname>
223
+ <refpurpose>Justify text to both right and left margins?</refpurpose>
224
+ </refnamediv>
225
+
226
+ <refsynopsisdiv>
227
+ <programlisting xml:id="man.justify.frag">
228
+ &lt;xsl:param name="man.justify"&gt;0&lt;/xsl:param&gt;</programlisting>
229
+ </refsynopsisdiv>
230
+
231
+ <refsection><info><title>Description</title></info>
232
+
233
+ <para>If non-zero, text is justified to both the right and left
234
+ margins (or, in roff terminology, "adjusted and filled" to both the
235
+ right and left margins). If zero (the default), text is adjusted to
236
+ the left margin only -- producing what is traditionally called
237
+ "ragged-right" text.</para>
238
+
239
+ <note>
240
+ <para>The default value for this parameter is zero because justified
241
+ text looks good only when it is also hyphenated. Without hyphenation,
242
+ excessive amounts of space often end up getting between words, in
243
+ order to "pad" lines out to align on the right margin.</para>
244
+
245
+ <para>The problem is that groff is not particularly smart about how it
246
+ does hyphenation; it can end up hyphenating a lot of things that you
247
+ don't want hyphenated. So, disabling both justification and
248
+ hyphenation ensures that hyphens won't get inserted where you don't
249
+ want to them, and you don't end up with lines containing excessive
250
+ amounts of space between words.</para>
251
+
252
+ <para>However, if do you decide to set a non-zero value for the
253
+ <parameter>man.justify</parameter> parameter (to enable
254
+ justification), then you should probably also set a non-zero value for
255
+ <parameter>man.hyphenate</parameter> (to enable hyphenation).</para>
256
+
257
+ <para>Yes, these default settings run counter to how most existing man
258
+ pages are formatted. But there are some notable exceptions, such as
259
+ the <literal>perl</literal> man pages.</para>
260
+ </note>
261
+ </refsection>
262
+ </refentry>
263
+
264
+ <refentry version="5.0" xml:id="man.break.after.slash">
265
+ <refmeta>
266
+ <refentrytitle>man.break.after.slash</refentrytitle>
267
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
268
+ </refmeta>
269
+ <refnamediv>
270
+ <refname>man.break.after.slash</refname>
271
+ <refpurpose>Enable line-breaking after slashes?</refpurpose>
272
+ </refnamediv>
273
+
274
+ <refsynopsisdiv>
275
+ <programlisting xml:id="man.break.after.slash.frag">
276
+ &lt;xsl:param name="man.break.after.slash"&gt;0&lt;/xsl:param&gt;</programlisting>
277
+ </refsynopsisdiv>
278
+
279
+ <refsection><info><title>Description</title></info>
280
+
281
+ <para>If non-zero, line-breaking after slashes is enabled. This is
282
+ mainly useful for causing long URLs or pathnames/filenames to be
283
+ broken up or "wrapped" across lines (though it also has the side
284
+ effect of sometimes causing relatively short URLs and pathnames to be
285
+ broken up across lines too).</para>
286
+
287
+ <para>If zero (the default), line-breaking after slashes is
288
+ disabled. In that case, strings containing slashes (for example, URLs
289
+ or filenames) are not broken across lines, even if they exceed the
290
+ maximum column widith.</para>
291
+
292
+ <warning>
293
+ <para>If you set a non-zero value for this parameter, check your
294
+ man-page output carefuly afterwards, in order to make sure that the
295
+ setting has not introduced an excessive amount of breaking-up of URLs
296
+ or pathnames. If your content contains mostly short URLs or
297
+ pathnames, setting a non-zero value for
298
+ <parameter>man.break.after.slash</parameter> will probably result in
299
+ in a significant number of relatively short URLs and pathnames being
300
+ broken across lines, which is probably not what you want.</para>
301
+ </warning>
302
+
303
+ </refsection>
304
+ </refentry>
305
+
306
+ </reference>
307
+ <reference xml:id="indent">
308
+ <title>Indentation</title>
309
+ <refentry version="5.0" xml:id="man.indent.width">
310
+ <refmeta>
311
+ <refentrytitle>man.indent.width</refentrytitle>
312
+ <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
313
+ </refmeta>
314
+ <refnamediv>
315
+ <refname>man.indent.width</refname>
316
+ <refpurpose>Specifies width used for adjusted indents</refpurpose>
317
+ </refnamediv>
318
+
319
+ <refsynopsisdiv>
320
+ <programlisting xml:id="man.indent.width.frag">
321
+ &lt;xsl:param name="man.indent.width"&gt;4&lt;/xsl:param&gt;
322
+ </programlisting>
323
+ </refsynopsisdiv>
324
+
325
+ <refsection><info><title>Description</title></info>
326
+ <para>The <parameter>man.indent.width</parameter> parameter specifies
327
+ the width used for adjusted indents. The value of
328
+ <parameter>man.indent.width</parameter> is used for indenting of
329
+ lists, verbatims, headings, and elsewhere, depending on whether the
330
+ values of certain <literal>man.indent.*</literal> boolean parameters
331
+ are non-zero.</para>
332
+
333
+ <para>The value of <parameter>man.indent.width</parameter> should
334
+ include a valid roff measurement unit (for example,
335
+ <literal>n</literal> or <literal>u</literal>). The default value of
336
+ <literal>4n</literal> specifies a 4-en width; when viewed on a
337
+ console, that amounts to the width of four characters. For details
338
+ about roff measurment units, see the <literal>Measurements</literal>
339
+ node in the groff info page.</para>
340
+
341
+ </refsection>
342
+ </refentry>
343
+
344
+ <refentry version="5.0" xml:id="man.indent.refsect">
345
+ <refmeta>
346
+ <refentrytitle>man.indent.refsect</refentrytitle>
347
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
348
+ </refmeta>
349
+ <refnamediv>
350
+ <refname>man.indent.refsect</refname>
351
+ <refpurpose>Adjust indentation of refsect* and refsection?</refpurpose>
352
+ </refnamediv>
353
+
354
+ <refsynopsisdiv>
355
+ <programlisting xml:id="man.indent.refsect.frag">
356
+ &lt;xsl:param name="man.indent.refsect" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
357
+ </refsynopsisdiv>
358
+
359
+ <refsection><info><title>Description</title></info>
360
+
361
+ <para>If the value of <parameter>man.indent.refsect</parameter> is
362
+ non-zero, the width of the left margin for
363
+ <tag>refsect1</tag>, <tag>refsect2</tag> and
364
+ <tag>refsect3</tag> contents and titles (and first-level,
365
+ second-level, and third-level nested
366
+ <tag>refsection</tag>instances) is adjusted by the value of
367
+ the <parameter>man.indent.width</parameter> parameter. With
368
+ <parameter>man.indent.width</parameter> set to its default value of
369
+ <literal>3n</literal>, the main results are that:
370
+
371
+ <itemizedlist>
372
+ <listitem>
373
+ <para>contents of <tag>refsect1</tag> are output with a
374
+ left margin of three characters instead the roff default of seven
375
+ or eight characters</para>
376
+ </listitem>
377
+ <listitem>
378
+ <para>contents of <tag>refsect2</tag> are displayed in
379
+ console output with a left margin of six characters instead the of
380
+ the roff default of seven characters</para>
381
+ </listitem>
382
+ <listitem>
383
+ <para> the contents of <tag>refsect3</tag> and nested
384
+ <tag>refsection</tag> instances are adjusted
385
+ accordingly.</para>
386
+ </listitem>
387
+ </itemizedlist>
388
+
389
+ If instead the value of <parameter>man.indent.refsect</parameter> is
390
+ zero, no margin adjustment is done for <literal>refsect*</literal>
391
+ output.</para>
392
+
393
+ <tip>
394
+ <para>If your content is primarly comprised of
395
+ <tag>refsect1</tag> and <tag>refsect2</tag> content
396
+ (or the <tag>refsection</tag> equivalent)&#160;&#8211; with few or
397
+ no <tag>refsect3</tag> or lower nested sections , you may be
398
+ able to &#8220;conserve&#8221; space in your output by setting
399
+ <parameter>man.indent.refsect</parameter> to a non-zero value. Doing
400
+ so will &#8220;squeeze&#8221; the left margin in such as way as to provide an
401
+ additional four characters of &#8220;room&#8221; per line in
402
+ <tag>refsect1</tag> output. That extra room may be useful
403
+ if, for example, you have many verbatim sections with long lines in
404
+ them.</para>
405
+ </tip>
406
+
407
+ </refsection>
408
+ </refentry>
409
+
410
+ <refentry version="5.0" xml:id="man.indent.blurbs">
411
+ <refmeta>
412
+ <refentrytitle>man.indent.blurbs</refentrytitle>
413
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
414
+ </refmeta>
415
+ <refnamediv>
416
+ <refname>man.indent.blurbs</refname>
417
+ <refpurpose>Adjust indentation of blurbs?</refpurpose>
418
+ </refnamediv>
419
+
420
+ <refsynopsisdiv>
421
+ <programlisting xml:id="man.indent.blurbs.frag">
422
+ &lt;xsl:param name="man.indent.blurbs" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
423
+ </refsynopsisdiv>
424
+
425
+ <refsection><info><title>Description</title></info>
426
+
427
+ <para>If the value of <parameter>man.indent.blurbs</parameter> is
428
+ non-zero, the width of the left margin for
429
+ <tag>authorblurb</tag>, <tag>personblurb</tag>, and
430
+ <tag>contrib</tag> output is set to the value of the
431
+ <parameter>man.indent.width</parameter> parameter
432
+ (<literal>3n</literal> by default). If instead the value of
433
+ <parameter>man.indent.blurbs</parameter> is zero, the built-in roff
434
+ default width (<literal>7.2n</literal>) is used.</para>
435
+
436
+ </refsection>
437
+ </refentry>
438
+
439
+ <refentry version="5.0" xml:id="man.indent.lists">
440
+ <refmeta>
441
+ <refentrytitle>man.indent.lists</refentrytitle>
442
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
443
+ </refmeta>
444
+ <refnamediv>
445
+ <refname>man.indent.lists</refname>
446
+ <refpurpose>Adjust indentation of lists?</refpurpose>
447
+ </refnamediv>
448
+
449
+ <refsynopsisdiv>
450
+ <programlisting xml:id="man.indent.lists.frag">
451
+ &lt;xsl:param name="man.indent.lists" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
452
+ </refsynopsisdiv>
453
+
454
+ <refsection><info><title>Description</title></info>
455
+
456
+ <para>If the value of <parameter>man.indent.lists</parameter> is
457
+ non-zero, the width of the left margin for list items in
458
+ <tag>itemizedlist</tag>,
459
+ <tag>orderedlist</tag>,
460
+ <tag>variablelist</tag> output (and output of some other
461
+ lists) is set to the value of the
462
+ <parameter>man.indent.width</parameter> parameter
463
+ (<literal>4n</literal> by default). If instead the value of
464
+ <parameter>man.indent.lists</parameter> is zero, the built-in roff
465
+ default width (<literal>7.2n</literal>) is used.</para>
466
+
467
+ </refsection>
468
+ </refentry>
469
+
470
+ <refentry version="5.0" xml:id="man.indent.verbatims">
471
+ <refmeta>
472
+ <refentrytitle>man.indent.verbatims</refentrytitle>
473
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
474
+ </refmeta>
475
+ <refnamediv>
476
+ <refname>man.indent.verbatims</refname>
477
+ <refpurpose>Adjust indentation of verbatims?</refpurpose>
478
+ </refnamediv>
479
+
480
+ <refsynopsisdiv>
481
+ <programlisting xml:id="man.indent.verbatims.frag">
482
+ &lt;xsl:param name="man.indent.verbatims" select="1"&gt;&lt;/xsl:param&gt;</programlisting>
483
+ </refsynopsisdiv>
484
+
485
+ <refsection><info><title>Description</title></info>
486
+
487
+ <para>If the value of <parameter>man.indent.verbatims</parameter> is
488
+ non-zero, the width of the left margin for output of verbatim
489
+ environments (<tag>programlisting</tag>,
490
+ <tag>screen</tag>, and so on) is set to the value of the
491
+ <parameter>man.indent.width</parameter> parameter
492
+ (<literal>3n</literal> by default). If instead the value of
493
+ <parameter>man.indent.verbatims</parameter> is zero, the built-in roff
494
+ default width (<literal>7.2n</literal>) is used.</para>
495
+
496
+ </refsection>
497
+ </refentry>
498
+
499
+ </reference>
500
+ <reference xml:id="fonts">
501
+ <title>Fonts</title>
502
+ <refentry version="5.0" xml:id="man.font.funcprototype">
503
+ <refmeta>
504
+ <refentrytitle>man.font.funcprototype</refentrytitle>
505
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
506
+ </refmeta>
507
+ <refnamediv>
508
+ <refname>man.font.funcprototype</refname>
509
+ <refpurpose>Specifies font for funcprototype output</refpurpose>
510
+ </refnamediv>
511
+
512
+ <refsynopsisdiv>
513
+ <programlisting xml:id="man.font.funcprototype.frag">
514
+ &lt;xsl:param name="man.font.funcprototype"&gt;BI&lt;/xsl:param&gt;
515
+ </programlisting>
516
+ </refsynopsisdiv>
517
+
518
+ <refsection><info><title>Description</title></info>
519
+
520
+ <para>The <parameter>man.font.funcprototype</parameter> parameter
521
+ specifies the font for <tag>funcprototype</tag> output. It
522
+ should be a valid roff font name, such as <literal>BI</literal> or
523
+ <literal>B</literal>.</para>
524
+
525
+ </refsection>
526
+ </refentry>
527
+
528
+ <refentry version="5.0" xml:id="man.font.funcsynopsisinfo">
529
+ <refmeta>
530
+ <refentrytitle>man.font.funcsynopsisinfo</refentrytitle>
531
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
532
+ </refmeta>
533
+ <refnamediv>
534
+ <refname>man.font.funcsynopsisinfo</refname>
535
+ <refpurpose>Specifies font for funcsynopsisinfo output</refpurpose>
536
+ </refnamediv>
537
+
538
+ <refsynopsisdiv>
539
+ <programlisting xml:id="man.font.funcsynopsisinfo.frag">
540
+ &lt;xsl:param name="man.font.funcsynopsisinfo"&gt;B&lt;/xsl:param&gt;
541
+ </programlisting>
542
+ </refsynopsisdiv>
543
+
544
+ <refsection><info><title>Description</title></info>
545
+
546
+ <para>The <parameter>man.font.funcsynopsisinfo</parameter> parameter
547
+ specifies the font for <tag>funcsynopsisinfo</tag> output. It
548
+ should be a valid roff font name, such as <literal>B</literal> or
549
+ <literal>I</literal>.</para>
550
+
551
+ </refsection>
552
+ </refentry>
553
+
554
+ <refentry version="5.0" xml:id="man.font.links">
555
+ <refmeta>
556
+ <refentrytitle>man.font.links</refentrytitle>
557
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
558
+ </refmeta>
559
+ <refnamediv>
560
+ <refname>man.font.links</refname>
561
+ <refpurpose>Specifies font for links</refpurpose>
562
+ </refnamediv>
563
+
564
+ <refsynopsisdiv>
565
+ <programlisting xml:id="man.font.links.frag">
566
+ &lt;xsl:param name="man.font.links"&gt;B&lt;/xsl:param&gt;
567
+ </programlisting>
568
+ </refsynopsisdiv>
569
+
570
+ <refsection><info><title>Description</title></info>
571
+
572
+ <para>The <parameter>man.font.links</parameter> parameter
573
+ specifies the font for output of links (<tag>ulink</tag> instances
574
+ and any instances of any element with an <tag class="attribute">xlink:href</tag> attribute).</para>
575
+
576
+ <para>The value of <parameter>man.font.links</parameter> must be
577
+ either <literal>B</literal> or <literal>I</literal>, or empty. If
578
+ the value is empty, no font formatting is applied to links.</para>
579
+
580
+ <para>If you set <parameter>man.endnotes.are.numbered</parameter> and/or
581
+ <parameter>man.endnotes.list.enabled</parameter> to zero (disabled), then
582
+ you should probably also set an empty value for
583
+ <parameter>man.font.links</parameter>. But if
584
+ <parameter>man.endnotes.are.numbered</parameter> is non-zero (enabled),
585
+ you should probably keep
586
+ <parameter>man.font.links</parameter> set to
587
+ <literal>B</literal> or <literal>I</literal><footnote><para>The
588
+ main purpose of applying a font format to links in most output
589
+ formats it to indicate that the formatted text is
590
+ &#8220;clickable&#8221;; given that links rendered in man pages are
591
+ not &#8220;real&#8221; hyperlinks that users can click on, it might
592
+ seem like there is never a good reason to have font formatting for
593
+ link contents in man output.</para>
594
+ <para>In fact, if you suppress the
595
+ display of inline link references (by setting
596
+ <parameter>man.endnotes.are.numbered</parameter> to zero), there is no
597
+ good reason to apply font formatting to links. However, if
598
+ <parameter>man.endnotes.are.numbered</parameter> is non-zero, having
599
+ font formatting for links (arguably) serves a purpose: It provides
600
+ &#8220;context&#8221; information about exactly what part of the text
601
+ is being &#8220;annotated&#8221; by the link. Depending on how you
602
+ mark up your content, that context information may or may not
603
+ have value.</para></footnote>.</para>
604
+ </refsection>
605
+
606
+ <refsection><info><title>Related Parameters</title></info>
607
+ <para><parameter>man.endnotes.list.enabled</parameter>,
608
+ <parameter>man.endnotes.are.numbered</parameter></para>
609
+ </refsection>
610
+
611
+ </refentry>
612
+
613
+ <refentry version="5.0" xml:id="man.font.table.headings">
614
+ <refmeta>
615
+ <refentrytitle>man.font.table.headings</refentrytitle>
616
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
617
+ </refmeta>
618
+ <refnamediv>
619
+ <refname>man.font.table.headings</refname>
620
+ <refpurpose>Specifies font for table headings</refpurpose>
621
+ </refnamediv>
622
+
623
+ <refsynopsisdiv>
624
+ <programlisting xml:id="man.font.table.headings.frag">
625
+ &lt;xsl:param name="man.font.table.headings"&gt;B&lt;/xsl:param&gt;
626
+ </programlisting>
627
+ </refsynopsisdiv>
628
+
629
+ <refsection><info><title>Description</title></info>
630
+
631
+ <para>The <parameter>man.font.table.headings</parameter> parameter
632
+ specifies the font for <tag>table</tag> headings. It should be
633
+ a valid roff font, such as <literal>B</literal> or
634
+ <literal>I</literal>.</para>
635
+
636
+ </refsection>
637
+ </refentry>
638
+
639
+ <refentry version="5.0" xml:id="man.font.table.title">
640
+ <refmeta>
641
+ <refentrytitle>man.font.table.title</refentrytitle>
642
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
643
+ </refmeta>
644
+ <refnamediv>
645
+ <refname>man.font.table.title</refname>
646
+ <refpurpose>Specifies font for table headings</refpurpose>
647
+ </refnamediv>
648
+
649
+ <refsynopsisdiv>
650
+ <programlisting xml:id="man.font.table.title.frag">
651
+ &lt;xsl:param name="man.font.table.title"&gt;B&lt;/xsl:param&gt;
652
+ </programlisting>
653
+ </refsynopsisdiv>
654
+
655
+ <refsection><info><title>Description</title></info>
656
+
657
+ <para>The <parameter>man.font.table.title</parameter> parameter
658
+ specifies the font for <tag>table</tag> titles. It should be
659
+ a valid roff font, such as <literal>B</literal> or
660
+ <literal>I</literal>.</para>
661
+
662
+ </refsection>
663
+ </refentry>
664
+
665
+ </reference>
666
+ <reference xml:id="synopsis">
667
+ <title>SYNOPSIS section</title>
668
+ <refentry version="5.0" xml:id="man.funcsynopsis.style">
669
+ <refmeta>
670
+ <refentrytitle>man.funcsynopsis.style</refentrytitle>
671
+ <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
672
+ <refmiscinfo class="other" otherclass="value">ansi</refmiscinfo>
673
+ <refmiscinfo class="other" otherclass="value">kr</refmiscinfo>
674
+ </refmeta>
675
+ <refnamediv>
676
+ <refname>man.funcsynopsis.style</refname>
677
+ <refpurpose>What style of <tag>funcsynopsis</tag> should be generated?</refpurpose>
678
+ </refnamediv>
679
+ <refsynopsisdiv>
680
+ <programlisting xml:id="man.funcsynopsis.style.frag">&lt;xsl:param name="man.funcsynopsis.style"&gt;ansi&lt;/xsl:param&gt;</programlisting>
681
+ </refsynopsisdiv>
682
+ <refsection><info><title>Description</title></info>
683
+ <para>If <parameter>man.funcsynopsis.style</parameter> is
684
+ <literal>ansi</literal>, ANSI-style function synopses are
685
+ generated for a <tag>funcsynopsis</tag>, otherwise K&amp;R-style
686
+ function synopses are generated.</para>
687
+ </refsection>
688
+ </refentry>
689
+
690
+ </reference>
691
+ <reference xml:id="authors">
692
+ <title>AUTHORS and COPYRIGHT sections</title>
693
+ <refentry version="5.0" xml:id="man.authors.section.enabled">
694
+ <refmeta>
695
+ <refentrytitle>man.authors.section.enabled</refentrytitle>
696
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
697
+ </refmeta>
698
+ <refnamediv>
699
+ <refname>man.authors.section.enabled</refname>
700
+ <refpurpose>Display auto-generated AUTHORS section?</refpurpose>
701
+ </refnamediv>
702
+ <refsynopsisdiv>
703
+ <programlisting xml:id="man.authors.section.enabled.frag">
704
+ &lt;xsl:param name="man.authors.section.enabled"&gt;1&lt;/xsl:param&gt;
705
+ </programlisting>
706
+ </refsynopsisdiv>
707
+ <refsection><info><title>Description</title></info>
708
+
709
+ <para>If the value of
710
+ <parameter>man.authors.section.enabled</parameter> is non-zero
711
+ (the default), then an <literal>AUTHORS</literal> section is
712
+ generated near the end of each man page. The output of the
713
+ <literal>AUTHORS</literal> section is assembled from any
714
+ <tag>author</tag>, <tag>editor</tag>, and <tag>othercredit</tag>
715
+ metadata found in the contents of the child <tag>info</tag> or
716
+ <tag>refentryinfo</tag> (if any) of the <tag>refentry</tag>
717
+ itself, or from any <tag>author</tag>, <tag>editor</tag>, and
718
+ <tag>othercredit</tag> metadata that may appear in <tag>info</tag>
719
+ contents of any ancestors of the <tag>refentry</tag>.</para>
720
+
721
+ <para>If the value of
722
+ <parameter>man.authors.section.enabled</parameter> is zero, the
723
+ the auto-generated <literal>AUTHORS</literal> section is
724
+ suppressed.</para>
725
+
726
+ <para>Set the value of
727
+ <parameter>man.authors.section.enabled</parameter> to zero if
728
+ you want to have a manually created <literal>AUTHORS</literal>
729
+ section in your source, and you want it to appear in output
730
+ instead of the auto-generated <literal>AUTHORS</literal>
731
+ section.</para>
732
+ </refsection>
733
+ </refentry>
734
+
735
+ <refentry version="5.0" xml:id="man.copyright.section.enabled">
736
+ <refmeta>
737
+ <refentrytitle>man.copyright.section.enabled</refentrytitle>
738
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
739
+ </refmeta>
740
+ <refnamediv>
741
+ <refname>man.copyright.section.enabled</refname>
742
+ <refpurpose>Display auto-generated COPYRIGHT section?</refpurpose>
743
+ </refnamediv>
744
+ <refsynopsisdiv>
745
+ <programlisting xml:id="man.copyright.section.enabled.frag">
746
+ &lt;xsl:param name="man.copyright.section.enabled"&gt;1&lt;/xsl:param&gt;
747
+ </programlisting>
748
+ </refsynopsisdiv>
749
+ <refsection><info><title>Description</title></info>
750
+
751
+ <para>If the value of
752
+ <parameter>man.copyright.section.enabled</parameter> is non-zero
753
+ (the default), then a <literal>COPYRIGHT</literal> section is
754
+ generated near the end of each man page. The output of the
755
+ <literal>COPYRIGHT</literal> section is assembled from any
756
+ <tag>copyright</tag> and <tag>legalnotice</tag> metadata found in
757
+ the contents of the child <tag>info</tag> or
758
+ <tag>refentryinfo</tag> (if any) of the <tag>refentry</tag>
759
+ itself, or from any <tag>copyright</tag> and
760
+ <tag>legalnotice</tag> metadata that may appear in <tag>info</tag>
761
+ contents of any ancestors of the <tag>refentry</tag>.</para>
762
+
763
+ <para>If the value of
764
+ <parameter>man.copyright.section.enabled</parameter> is zero, the
765
+ the auto-generated <literal>COPYRIGHT</literal> section is
766
+ suppressed.</para>
767
+
768
+ <para>Set the value of
769
+ <parameter>man.copyright.section.enabled</parameter> to zero if
770
+ you want to have a manually created <literal>COPYRIGHT</literal>
771
+ section in your source, and you want it to appear in output
772
+ instead of the auto-generated <literal>COPYRIGHT</literal>
773
+ section.</para>
774
+ </refsection>
775
+ </refentry>
776
+
777
+ </reference>
778
+ <reference xml:id="endnotes">
779
+ <title>Endnotes and link handling</title>
780
+ <refentry version="5.0" xml:id="man.endnotes.list.enabled">
781
+ <refmeta>
782
+ <refentrytitle>man.endnotes.list.enabled</refentrytitle>
783
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
784
+ </refmeta>
785
+ <refnamediv>
786
+ <refname>man.endnotes.list.enabled</refname>
787
+ <refpurpose>Display endnotes list at end of man page?</refpurpose>
788
+ </refnamediv>
789
+
790
+ <refsynopsisdiv>
791
+ <programlisting xml:id="man.endnotes.list.enabled.frag">
792
+ &lt;xsl:param name="man.endnotes.list.enabled"&gt;1&lt;/xsl:param&gt;
793
+ </programlisting>
794
+ </refsynopsisdiv>
795
+
796
+ <refsection><info><title>Description</title></info>
797
+
798
+ <para>If the value of <parameter>man.endnotes.list.enabled</parameter> is
799
+ non-zero (the default), then an endnotes list is added to the end of
800
+ the output man page.</para>
801
+
802
+ <para>If the value of <parameter>man.endnotes.list.enabled</parameter> is
803
+ zero, the list is suppressed &#8212; unless link numbering is enabled (that
804
+ is, if <parameter>man.endnotes.are.numbered</parameter> is non-zero), in
805
+ which case, that setting overrides the
806
+ <parameter>man.endnotes.list.enabled</parameter> setting, and the
807
+ endnotes list is still displayed. The reason is that inline
808
+ numbering of notesources associated with endnotes only makes sense
809
+ if a (numbered) list of endnotes is also generated.</para>
810
+
811
+ <note>
812
+ <para>Leaving
813
+ <parameter>man.endnotes.list.enabled</parameter> at its default
814
+ (non-zero) value ensures that no &#8220;out of line&#8221; information (such
815
+ as the URLs for hyperlinks and images) gets lost in your
816
+ man-page output. It just gets &#8220;rearranged&#8221;.</para>
817
+ <para>So if you&#8217;re thinking about disabling endnotes listing by
818
+ setting the value of
819
+ <parameter>man.endnotes.list.enabled</parameter> to zero:
820
+ Before you do so, first take some time to carefully consider
821
+ the information needs and experiences of your users. The &#8220;out
822
+ of line&#8221; information has value even if the presentation of it
823
+ in text output is not as interactive as it may be in other
824
+ output formats.</para>
825
+ <para>As far as the specific case of URLs: Even though the URLs
826
+ displayed in text output may not be &#8220;real&#8221; (clickable)
827
+ hyperlinks, many X terminals have convenience features for
828
+ recognizing URLs and can, for example, present users with
829
+ an options to open a URL in a browser with the user clicks on
830
+ the URL is a terminal window. And short of those, users with X
831
+ terminals can always manually cut and paste the URLs into a web
832
+ browser.</para>
833
+ <para>Also, note that various &#8220;man to html&#8221; tools, such as the
834
+ widely used <command><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://users.actrix.gen.nz/michael/vhman2html.html">man2html</link></command> (<literal>VH-Man2html</literal>)
835
+ application, automatically mark up URLs with <literal>a@href</literal> markup
836
+ during conversion &#8212; resulting in &#8220;real&#8221; hyperlinks in HTML
837
+ output from those tools.</para>
838
+ </note>
839
+
840
+ <para>To &#8220;turn off&#8221; numbering of endnotes in the
841
+ endnotes list, set <parameter>man.endnotes.are.numbered</parameter>
842
+ to zero. The endnotes list will
843
+ still be displayed; it will just be displayed without the
844
+ numbers<footnote><para>It can still make sense to have
845
+ the list of endnotes displayed even if you have endnotes numbering turned
846
+ off. In that case, your endnotes list basically becomes a &#8220;list
847
+ of references&#8221; without any association with specific text in
848
+ your document. This is probably the best option if you find the inline
849
+ endnotes numbering obtrusive. Your users will still have access to all the &#8220;out of line&#8221;
850
+ such as URLs for hyperlinks.</para></footnote>
851
+ </para>
852
+
853
+ <para>The default heading for the endnotes list is
854
+ <literal>NOTES</literal>. To change that, set a non-empty
855
+ value for the <parameter>man.endnotes.list.heading</parameter>
856
+ parameter.</para>
857
+
858
+ <para>In the case of notesources that are links: Along with the
859
+ URL for each link, the endnotes list includes the contents of the
860
+ link. The list thus includes only non-empty<footnote>
861
+
862
+ <para>A &#8220;non-empty&#8221; link is one that looks like
863
+ this:<literallayout class="monospaced"> &lt;ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"&gt;manpages&lt;/ulink&gt;</literallayout>
864
+ an &#8220;empty link&#8221; is on that looks like this:<literallayout class="monospaced"> &lt;ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/&gt;</literallayout>
865
+ </para></footnote> links.
866
+
867
+ Empty links are never included, and never numbered. They are simply
868
+ displayed inline, without any numbering.</para>
869
+
870
+ <para>In addition, if there are multiple instances of links in a
871
+ <tag>refentry</tag> that have the same URL, the URL is listed only
872
+ once. The contents listed for that link in the endnotes list are
873
+ the contents of the first link which has that URL.</para>
874
+
875
+ <para>If you disable endnotes listing, you should probably also set
876
+ <parameter>man.links.are.underlined</parameter> to zero (to disable
877
+ link underlining).</para>
878
+ </refsection>
879
+ </refentry>
880
+
881
+ <refentry version="5.0" xml:id="man.endnotes.list.heading">
882
+ <refmeta>
883
+ <refentrytitle>man.endnotes.list.heading</refentrytitle>
884
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
885
+ </refmeta>
886
+ <refnamediv>
887
+ <refname>man.endnotes.list.heading</refname>
888
+ <refpurpose>Specifies an alternate name for endnotes list</refpurpose>
889
+ </refnamediv>
890
+
891
+ <refsynopsisdiv>
892
+ <programlisting xml:id="man.endnotes.list.heading.frag">
893
+ &lt;xsl:param name="man.endnotes.list.heading"&gt;&lt;/xsl:param&gt;
894
+ </programlisting>
895
+ </refsynopsisdiv>
896
+
897
+ <refsection><info><title>Description</title></info>
898
+
899
+ <para>If the value of the
900
+ <parameter>man.endnotes.are.numbered</parameter> parameter
901
+ and/or the <parameter>man.endnotes.list.enabled</parameter>
902
+ parameter is non-zero (the defaults for both are non-zero), a
903
+ numbered list of endnotes is generated near the end of each man
904
+ page. The default heading for the list of endnotes is the
905
+ equivalent of the English word <literal>NOTES</literal> in
906
+ the current locale. To cause an alternate heading to be displayed,
907
+ set a non-empty value for the
908
+ <parameter>man.endnotes.list.heading</parameter> parameter &#8212;
909
+ for example, <literal>REFERENCES</literal>.</para>
910
+ </refsection>
911
+ </refentry>
912
+
913
+ <refentry version="5.0" xml:id="man.endnotes.are.numbered">
914
+ <refmeta>
915
+ <refentrytitle>man.endnotes.are.numbered</refentrytitle>
916
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
917
+ </refmeta>
918
+ <refnamediv>
919
+ <refname>man.endnotes.are.numbered</refname>
920
+ <refpurpose>Number endnotes?</refpurpose>
921
+ </refnamediv>
922
+
923
+ <refsynopsisdiv>
924
+ <programlisting xml:id="man.endnotes.are.numbered.frag">
925
+ &lt;xsl:param name="man.endnotes.are.numbered"&gt;1&lt;/xsl:param&gt;
926
+ </programlisting>
927
+ </refsynopsisdiv>
928
+
929
+ <refsection><info><title>Description</title></info>
930
+
931
+ <para>If the value of <parameter>man.endnotes.are.numbered</parameter> is
932
+ non-zero (the default), then for each non-empty<footnote>
933
+ <para>A &#8220;non-empty&#8221; notesource is one that looks like
934
+ this:<literallayout class="monospaced"> &lt;ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"&gt;manpages&lt;/ulink&gt;</literallayout>
935
+ an &#8220;empty&#8221; notesource is on that looks like this:<literallayout class="monospaced"> &lt;ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/&gt;</literallayout>
936
+ </para></footnote> &#8220;notesource&#8221;:
937
+
938
+ <itemizedlist>
939
+ <listitem>
940
+ <para>a number (in square brackets) is displayed inline after the
941
+ rendered inline contents (if any) of the notesource</para>
942
+ </listitem>
943
+ <listitem>
944
+ <para>the contents of the notesource are included in a
945
+ numbered list of endnotes that is generated at the end of
946
+ each man page; the number for each endnote corresponds to
947
+ the inline number for the notesource with which it is
948
+ associated</para>
949
+ </listitem>
950
+ </itemizedlist>
951
+ The default heading for the list of endnotes is
952
+ <literal>NOTES</literal>. To output a different heading, set a value
953
+ for the <parameter>man.endnotes.section.heading</parameter>
954
+ parameter.</para>
955
+
956
+ <note>
957
+ <para>The endnotes list is also displayed (but without
958
+ numbers) if the value of
959
+ <parameter>man.endnotes.list.enabled</parameter> is
960
+ non-zero.</para>
961
+ </note>
962
+
963
+
964
+ <para>If the value of <parameter>man.endnotes.are.numbered</parameter> is
965
+ zero, numbering of endnotess is suppressed; only inline
966
+ contents (if any) of the notesource are displayed inline.
967
+ <important>
968
+ <para>If you are thinking about disabling endnote numbering by setting
969
+ the value of <parameter>man.endnotes.are.numbered</parameter> to zero,
970
+ before you do so, first take some time to carefully
971
+ consider the information needs and experiences of your users. The
972
+ square-bracketed numbers displayed inline after notesources may seem
973
+ obstrusive and aesthetically unpleasing<footnote><para>As far as notesources that are links, ytou might
974
+ think it would be better to just display URLs for non-empty
975
+ links inline, after their content, rather than displaying
976
+ square-bracketed numbers all over the place. But it's not better. In
977
+ fact, it's not even practical, because many (most) URLs for links
978
+ are too long to be displayed inline. They end up overflowing the
979
+ right margin. You can set a non-zero value for
980
+ <parameter>man.break.after.slash</parameter> parameter to deal with
981
+ that, but it could be argued that what you end up with is at least
982
+ as ugly, and definitely more obstrusive, then having short
983
+ square-bracketed numbers displayed inline.</para></footnote>,
984
+
985
+ but in a text-only output format, the
986
+ numbered-notesources/endnotes-listing mechanism is the only
987
+ practical way to handle this kind of content.</para>
988
+
989
+ <para>Also, users of &#8220;text based&#8221; browsers such as
990
+ <command>lynx</command> will already be accustomed to seeing inline
991
+ numbers for links. And various "man to html" applications, such as
992
+ the widely used <command><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://users.actrix.gen.nz/michael/vhman2html.html">man2html</link></command> (<literal>VH-Man2html</literal>)
993
+ application, can automatically turn URLs into "real" HTML hyperlinks
994
+ in output. So leaving <parameter>man.endnotes.are.numbered</parameter>
995
+ at its default (non-zero) value ensures that no information is
996
+ lost in your man-page output. It just gets
997
+ &#8220;rearranged&#8221;.</para>
998
+ </important>
999
+ </para>
1000
+ <para>The handling of empty links is not affected by this
1001
+ parameter. Empty links are handled simply by displaying their URLs
1002
+ inline. Empty links are never auto-numbered.</para>
1003
+
1004
+ <para>If you disable endnotes numbering, you should probably also set
1005
+ <parameter>man.font.links</parameter> to an empty value (to
1006
+ disable font formatting for links.</para>
1007
+ </refsection>
1008
+
1009
+ <refsection><info><title>Related Parameters</title></info>
1010
+ <para><parameter>man.endnotes.list.enabled</parameter>,
1011
+ <parameter>man.font.links</parameter></para>
1012
+ </refsection>
1013
+ </refentry>
1014
+
1015
+ <refentry version="5.0" xml:id="man.base.url.for.relative.links">
1016
+ <refmeta>
1017
+ <refentrytitle>man.base.url.for.relative.links</refentrytitle>
1018
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1019
+ </refmeta>
1020
+ <refnamediv>
1021
+ <refname>man.base.url.for.relative.links</refname>
1022
+ <refpurpose>Specifies a base URL for relative links</refpurpose>
1023
+ </refnamediv>
1024
+
1025
+ <refsynopsisdiv>
1026
+ <programlisting xml:id="man.base.url.for.relative.links.frag">&lt;xsl:param name="man.base.url.for.relative.links"&gt;[set $man.base.url.for.relative.links]/&lt;/xsl:param&gt;</programlisting>
1027
+ </refsynopsisdiv>
1028
+
1029
+ <refsection><info><title>Description</title></info>
1030
+
1031
+ <para>For any &#8220;notesource&#8221; listed in the auto-generated
1032
+ &#8220;NOTES&#8221; section of output man pages (which is generated when
1033
+ the value of the
1034
+ <parameter>man.endnotes.list.enabled</parameter> parameter
1035
+ is non-zero), if the notesource is a link source with a
1036
+ relative URI, the URI is displayed in output with the value
1037
+ of the
1038
+ <parameter>man.base.url.for.relative.links</parameter>
1039
+ parameter prepended to the value of the link URI.</para>
1040
+
1041
+ <note>
1042
+ <para>A link source is an notesource that references an
1043
+ external resource:
1044
+ <itemizedlist>
1045
+ <listitem>
1046
+ <para>a <tag>ulink</tag> element with a <tag class="attribute">url</tag> attribute</para>
1047
+ </listitem>
1048
+ <listitem>
1049
+ <para>any element with an <tag class="attribute">xlink:href</tag> attribute</para>
1050
+ </listitem>
1051
+ <listitem>
1052
+ <para>an <tag>imagedata</tag>, <tag>audiodata</tag>, or
1053
+ <tag>videodata</tag> element</para>
1054
+ </listitem>
1055
+ </itemizedlist>
1056
+ </para>
1057
+ </note>
1058
+
1059
+ <para>If you use relative URIs in link sources in your DocBook
1060
+ <tag>refentry</tag> source, and you leave
1061
+ <parameter>man.base.url.for.relative.links</parameter>
1062
+ unset, the relative links will appear &#8220;as is&#8221; in the &#8220;Notes&#8221;
1063
+ section of any man-page output generated from your source.
1064
+ That&#8217;s probably not what you want, because such relative
1065
+ links are only usable in the context of HTML output. So, to
1066
+ make the links meaningful and usable in the context of
1067
+ man-page output, set a value for
1068
+ <parameter>man.base.url.for.relative.links</parameter> that
1069
+ points to the online version of HTML output generated from
1070
+ your DocBook <tag>refentry</tag> source. For
1071
+ example:
1072
+ <programlisting>&lt;xsl:param name="man.base.url.for.relative.links"
1073
+ &gt;http://www.kernel.org/pub/software/scm/git/docs/&lt;/xsl:param&gt;</programlisting>
1074
+ </para>
1075
+
1076
+ </refsection>
1077
+
1078
+ <refsection><info><title>Related Parameters</title></info>
1079
+ <para><parameter>man.endnotes.list.enabled</parameter></para>
1080
+ </refsection>
1081
+
1082
+ </refentry>
1083
+
1084
+ </reference>
1085
+ <reference xml:id="lists">
1086
+ <title>Lists</title>
1087
+ <refentry version="5.0" xml:id="man.segtitle.suppress">
1088
+ <refmeta>
1089
+ <refentrytitle>man.segtitle.suppress</refentrytitle>
1090
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1091
+ </refmeta>
1092
+ <refnamediv>
1093
+ <refname>man.segtitle.suppress</refname>
1094
+ <refpurpose>Suppress display of segtitle contents?</refpurpose>
1095
+ </refnamediv>
1096
+
1097
+ <refsynopsisdiv>
1098
+ <programlisting xml:id="man.segtitle.suppress.frag">
1099
+ &lt;xsl:param name="man.segtitle.suppress" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
1100
+ </refsynopsisdiv>
1101
+
1102
+ <refsection><info><title>Description</title></info>
1103
+
1104
+ <para>If the value of <parameter>man.segtitle.suppress</parameter> is
1105
+ non-zero, then display of <tag>segtitle</tag> contents is
1106
+ suppressed in output.</para>
1107
+
1108
+ </refsection>
1109
+ </refentry>
1110
+
1111
+ </reference>
1112
+ <reference xml:id="charmap">
1113
+ <title>Character/string substitution</title>
1114
+ <refentry version="5.0" xml:id="man.charmap.enabled">
1115
+ <refmeta>
1116
+ <refentrytitle>man.charmap.enabled</refentrytitle>
1117
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1118
+ </refmeta>
1119
+ <refnamediv>
1120
+ <refname>man.charmap.enabled</refname>
1121
+ <refpurpose>Apply character map before final output?</refpurpose>
1122
+ </refnamediv>
1123
+
1124
+ <refsynopsisdiv>
1125
+ <programlisting xml:id="man.charmap.enabled.frag">
1126
+ &lt;xsl:param name="man.charmap.enabled" select="1"&gt;&lt;/xsl:param&gt;
1127
+ </programlisting>
1128
+ </refsynopsisdiv>
1129
+
1130
+ <refsection><info><title>Description</title></info>
1131
+
1132
+ <para>If the value of the <parameter>man.charmap.enabled</parameter>
1133
+ parameter is non-zero, a "character map" is used to substitute certain
1134
+ Unicode symbols and special characters with appropriate roff/groff
1135
+ equivalents, just before writing each man-page file to the
1136
+ filesystem. If instead the value of
1137
+ <parameter>man.charmap.enabled</parameter> is zero, Unicode characters
1138
+ are passed through "as is".</para>
1139
+
1140
+ <refsection><info><title>Details</title></info>
1141
+
1142
+ <para>For converting certain Unicode symbols and special characters in
1143
+ UTF-8 or UTF-16 encoded XML source to appropriate groff/roff
1144
+ equivalents in man-page output, the DocBook XSL Stylesheets
1145
+ distribution includes a <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook.sourceforge.net/snapshot/xsl/manpages/charmap.groff.xsl">roff character map</link> that is compliant with the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xslt20/#character-maps">XSLT character
1146
+ map</link> format as detailed in the XSLT 2.0 specification. The map
1147
+ contains more than 800 character mappings and can be considered the
1148
+ standard roff character map for the distribution.</para>
1149
+
1150
+ <para>You can use the <parameter>man.charmap.uri</parameter>
1151
+ parameter to specify a URI for the location for an alternate roff
1152
+ character map to use in place of the standard roff character map
1153
+ provided in the distribution.</para>
1154
+
1155
+ <para>You can also use a subset of a character map. For details,
1156
+ see the <parameter>man.charmap.use.subset</parameter>,
1157
+ <parameter>man.charmap.subset.profile</parameter>, and
1158
+ <parameter>man.charmap.subset.profile.english</parameter>
1159
+ parameters.</para>
1160
+
1161
+ </refsection>
1162
+ </refsection>
1163
+ </refentry>
1164
+
1165
+ <refentry version="5.0" xml:id="man.charmap.uri">
1166
+ <refmeta>
1167
+ <refentrytitle>man.charmap.uri</refentrytitle>
1168
+ <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
1169
+ </refmeta>
1170
+ <refnamediv>
1171
+ <refname>man.charmap.uri</refname>
1172
+ <refpurpose>URI for custom roff character map</refpurpose>
1173
+ </refnamediv>
1174
+
1175
+ <refsynopsisdiv>
1176
+ <programlisting xml:id="man.charmap.uri.frag">
1177
+ &lt;xsl:param name="man.charmap.uri"&gt;&lt;/xsl:param&gt;
1178
+ </programlisting>
1179
+ </refsynopsisdiv>
1180
+
1181
+ <refsection><info><title>Description</title></info>
1182
+
1183
+ <para>For converting certain Unicode symbols and special characters in
1184
+ UTF-8 or UTF-16 encoded XML source to appropriate groff/roff
1185
+ equivalents in man-page output, the DocBook XSL Stylesheets
1186
+ distribution includes an <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xslt20/#character-maps">XSLT character
1187
+ map</link>. That character map can be considered the standard roff
1188
+ character map for the distribution.</para>
1189
+
1190
+ <para>If the value of the <parameter>man.charmap.uri</parameter>
1191
+ parameter is non-empty, that value is used as the URI for the location
1192
+ for an alternate roff character map to use in place of the standard
1193
+ roff character map provided in the distribution.</para>
1194
+
1195
+ <warning>
1196
+ <para>Do not set a value for <parameter>man.charmap.uri</parameter>
1197
+ unless you have a custom roff character map that differs from the
1198
+ standard one provided in the distribution.</para>
1199
+ </warning>
1200
+ </refsection>
1201
+ </refentry>
1202
+
1203
+ <refentry version="5.0" xml:id="man.charmap.use.subset">
1204
+ <refmeta>
1205
+ <refentrytitle>man.charmap.use.subset</refentrytitle>
1206
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1207
+ </refmeta>
1208
+ <refnamediv>
1209
+ <refname>man.charmap.use.subset</refname>
1210
+ <refpurpose>Use subset of character map instead of full map?</refpurpose>
1211
+ </refnamediv>
1212
+
1213
+ <refsynopsisdiv>
1214
+ <programlisting xml:id="man.charmap.use.subset.frag">
1215
+ &lt;xsl:param name="man.charmap.use.subset" select="1"&gt;&lt;/xsl:param&gt;
1216
+ </programlisting>
1217
+ </refsynopsisdiv>
1218
+
1219
+ <refsection><info><title>Description</title></info>
1220
+
1221
+ <para>If the value of the
1222
+ <parameter>man.charmap.use.subset</parameter> parameter is non-zero,
1223
+ a subset of the roff character map is used instead of the full roff
1224
+ character map. The profile of the subset used is determined either
1225
+ by the value of the
1226
+ <parameter>man.charmap.subset.profile</parameter>
1227
+ parameter (if the source is not in English) or the
1228
+ <parameter>man.charmap.subset.profile.english</parameter>
1229
+ parameter (if the source is in English).</para>
1230
+
1231
+ <note>
1232
+ <para>You may want to experiment with setting a non-zero value of
1233
+ <parameter>man.charmap.use.subset</parameter>, so that the full
1234
+ character map is used. Depending on which XSLT engine you run,
1235
+ setting a non-zero value for
1236
+ <parameter>man.charmap.use.subset</parameter> may significantly
1237
+ increase the time needed to process your documents. Or it may
1238
+ not. For example, if you set it and run it with xsltproc, it seems
1239
+ to dramatically increase processing time; on the other hand, if you
1240
+ set it and run it with Saxon, it does not seem to increase
1241
+ processing time nearly as much.</para>
1242
+
1243
+ <para>If processing time is not a important concern and/or you can
1244
+ tolerate the increase in processing time imposed by using the full
1245
+ character map, set <parameter>man.charmap.use.subset</parameter> to
1246
+ zero.</para>
1247
+ </note>
1248
+
1249
+ <refsection><info><title>Details</title></info>
1250
+
1251
+ <para>For converting certain Unicode symbols and special characters in
1252
+ UTF-8 or UTF-16 encoded XML source to appropriate groff/roff
1253
+ equivalents in man-page output, the DocBook XSL Stylesheets
1254
+ distribution includes a <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook.sourceforge.net/snapshot/xsl/manpages/charmap.groff.xsl">roff character map</link> that is compliant with the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xslt20/#character-maps">XSLT character
1255
+ map</link> format as detailed in the XSLT 2.0 specification. The map
1256
+ contains more than 800 character mappings and can be considered the
1257
+ standard roff character map for the distribution.</para>
1258
+
1259
+ <note>
1260
+ <para>You can use the <parameter>man.charmap.uri</parameter>
1261
+ parameter to specify a URI for the location for an alternate roff
1262
+ character map to use in place of the standard roff character map
1263
+ provided in the distribution.</para>
1264
+ </note>
1265
+
1266
+ <para>Because it is not terrifically efficient to use the standard
1267
+ 800-character character map in full -- and for most (or all) users,
1268
+ never necessary to use it in full -- the DocBook XSL Stylesheets
1269
+ support a mechanism for using, within any given character map, a
1270
+ subset of character mappings instead of the full set. You can use the
1271
+ <parameter>man.charmap.subset.profile</parameter> or
1272
+ <parameter>man.charmap.subset.profile.english</parameter>
1273
+ parameter to tune the profile of that subset to use.</para>
1274
+
1275
+ </refsection>
1276
+ </refsection>
1277
+ </refentry>
1278
+
1279
+ <refentry version="5.0" xml:id="man.charmap.subset.profile">
1280
+ <refmeta>
1281
+ <refentrytitle>man.charmap.subset.profile</refentrytitle>
1282
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1283
+ </refmeta>
1284
+ <refnamediv>
1285
+ <refname>man.charmap.subset.profile</refname>
1286
+ <refpurpose>Profile of character map subset</refpurpose>
1287
+ </refnamediv>
1288
+
1289
+ <refsynopsisdiv>
1290
+ <programlisting xml:id="man.charmap.subset.profile.frag">
1291
+ &lt;xsl:param name="man.charmap.subset.profile"&gt;
1292
+ @*[local-name() = 'block'] = 'Miscellaneous Technical' or
1293
+ (@*[local-name() = 'block'] = 'C1 Controls And Latin-1 Supplement (Latin-1 Supplement)' and
1294
+ (@*[local-name() = 'class'] = 'symbols' or
1295
+ @*[local-name() = 'class'] = 'letters')
1296
+ ) or
1297
+ @*[local-name() = 'block'] = 'Latin Extended-A'
1298
+ or
1299
+ (@*[local-name() = 'block'] = 'General Punctuation' and
1300
+ (@*[local-name() = 'class'] = 'spaces' or
1301
+ @*[local-name() = 'class'] = 'dashes' or
1302
+ @*[local-name() = 'class'] = 'quotes' or
1303
+ @*[local-name() = 'class'] = 'bullets'
1304
+ )
1305
+ ) or
1306
+ @*[local-name() = 'name'] = 'HORIZONTAL ELLIPSIS' or
1307
+ @*[local-name() = 'name'] = 'WORD JOINER' or
1308
+ @*[local-name() = 'name'] = 'SERVICE MARK' or
1309
+ @*[local-name() = 'name'] = 'TRADE MARK SIGN' or
1310
+ @*[local-name() = 'name'] = 'ZERO WIDTH NO-BREAK SPACE'
1311
+ &lt;/xsl:param&gt;
1312
+ </programlisting>
1313
+ </refsynopsisdiv>
1314
+
1315
+ <refsection><info><title>Description</title></info>
1316
+
1317
+ <para>If the value of the
1318
+ <parameter>man.charmap.use.subset</parameter> parameter is non-zero,
1319
+ and your DocBook source is not written in English (that
1320
+ is, if the <tag class="attribute">lang</tag> or <tag class="attribute">xml:lang</tag> attribute on the root element
1321
+ in your DocBook source or on the first <tag>refentry</tag>
1322
+ element in your source has a value other than
1323
+ <literal>en</literal>), then the character-map subset specified
1324
+ by the <parameter>man.charmap.subset.profile</parameter>
1325
+ parameter is used instead of the full roff character map.</para>
1326
+
1327
+ <para>Otherwise, if the <tag class="attribute">lang</tag> or <tag class="attribute">xml:lang</tag> attribute on the root
1328
+ element in your DocBook
1329
+ source or on the first <tag>refentry</tag> element in your source
1330
+ has the value <literal>en</literal> or if it has no <tag class="attribute">lang</tag> or <tag class="attribute">xml:lang</tag> attribute, then the character-map
1331
+ subset specified by the
1332
+ <parameter>man.charmap.subset.profile.english</parameter>
1333
+ parameter is used instead of
1334
+ <parameter>man.charmap.subset.profile</parameter>.</para>
1335
+
1336
+ <para>The difference between the two subsets is that
1337
+ <parameter>man.charmap.subset.profile</parameter> provides
1338
+ mappings for characters in Western European languages that are
1339
+ not part of the Roman (English) alphabet (ASCII character set).</para>
1340
+
1341
+ <para>The value of <parameter>man.charmap.subset.profile</parameter>
1342
+ is a string representing an XPath expression that matches attribute
1343
+ names and values for <tag namespace="http://docbook.sf.net/xmlns/unichar/1.0">output-character</tag>
1344
+ elements in the character map.</para>
1345
+
1346
+ <para>The attributes supported in the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook.sourceforge.net/snapshot/xsl/manpages/charmap.groff.xsl">standard roff character map included in the distribution</link> are:
1347
+ <variablelist>
1348
+ <varlistentry>
1349
+ <term>character</term>
1350
+ <listitem>
1351
+ <simpara>a raw Unicode character or numeric Unicode
1352
+ character-entity value (either in decimal or hex); all
1353
+ characters have this attribute</simpara>
1354
+ </listitem>
1355
+ </varlistentry>
1356
+ <varlistentry>
1357
+ <term>name</term>
1358
+ <listitem>
1359
+ <simpara>a standard full/long ISO/Unicode character name (e.g.,
1360
+ "OHM SIGN"); all characters have this attribute</simpara>
1361
+ </listitem>
1362
+ </varlistentry>
1363
+ <varlistentry>
1364
+ <term>block</term>
1365
+ <listitem>
1366
+ <simpara>a standard Unicode "block" name (e.g., "General
1367
+ Punctuation"); all characters have this attribute. For the full
1368
+ list of Unicode block names supported in the standard roff
1369
+ character map, see <xref linkend="BlocksAndClasses"/>.</simpara>
1370
+ </listitem>
1371
+ </varlistentry>
1372
+ <varlistentry>
1373
+ <term>class</term>
1374
+ <listitem>
1375
+ <simpara>a class of characters (e.g., "spaces"). Not all
1376
+ characters have this attribute; currently, it is used only with
1377
+ certain characters within the "C1 Controls And Latin-1
1378
+ Supplement" and "General Punctuation" blocks. For details, see
1379
+ <xref linkend="BlocksAndClasses"/>.</simpara>
1380
+ </listitem>
1381
+ </varlistentry>
1382
+ <varlistentry>
1383
+ <term>entity</term>
1384
+ <listitem>
1385
+ <simpara>an ISO entity name (e.g., "ohm"); not all characters
1386
+ have this attribute, because not all characters have ISO entity
1387
+ names; for example, of the 800 or so characters in the standard
1388
+ roff character map included in the distribution, only around 300
1389
+ have ISO entity names.
1390
+ </simpara>
1391
+ </listitem>
1392
+ </varlistentry>
1393
+ <varlistentry>
1394
+ <term>string</term>
1395
+ <listitem>
1396
+ <simpara>a string representing an roff/groff escape-code (with
1397
+ "@esc@" used in place of the backslash), or a simple ASCII
1398
+ string; all characters in the roff character map have this
1399
+ attribute</simpara>
1400
+ </listitem>
1401
+ </varlistentry>
1402
+ </variablelist>
1403
+ </para>
1404
+ <para>The value of <parameter>man.charmap.subset.profile</parameter>
1405
+ is evaluated as an XPath expression at run-time to select a portion of
1406
+ the roff character map to use. You can tune the subset used by adding
1407
+ or removing parts. For example, if you need to use a wide range of
1408
+ mathematical operators in a document, and you want to have them
1409
+ converted into roff markup properly, you might add the following:
1410
+
1411
+ <literallayout class="monospaced"> @*[local-name() = 'block'] ='MathematicalOperators' </literallayout>
1412
+
1413
+ That will cause a additional set of around 67 additional "math"
1414
+ characters to be converted into roff markup. </para>
1415
+
1416
+ <note>
1417
+ <para>Depending on which XSLT engine you use, either the EXSLT
1418
+ <function>dyn:evaluate</function> extension function (for xsltproc or
1419
+ Xalan) or <function>saxon:evaluate</function> extension function (for
1420
+ Saxon) are used to dynamically evaluate the value of
1421
+ <parameter>man.charmap.subset.profile</parameter> at run-time. If you
1422
+ don't use xsltproc, Saxon, Xalan -- or some other XSLT engine that
1423
+ supports <function>dyn:evaluate</function> -- you must either set the
1424
+ value of the <parameter>man.charmap.use.subset</parameter> parameter
1425
+ to zero and process your documents using the full character map
1426
+ instead, or set the value of the
1427
+ <parameter>man.charmap.enabled</parameter> parameter to zero instead
1428
+ (so that character-map processing is disabled completely.</para>
1429
+ </note>
1430
+
1431
+ <para>An alternative to using
1432
+ <parameter>man.charmap.subset.profile</parameter> is to create your
1433
+ own custom character map, and set the value of
1434
+ <parameter>man.charmap.uri</parameter> to the URI/filename for
1435
+ that. If you use a custom character map, you will probably want to
1436
+ include in it just the characters you want to use, and so you will
1437
+ most likely also want to set the value of
1438
+ <parameter>man.charmap.use.subset</parameter> to zero.</para>
1439
+ <para>You can create a
1440
+ custom character map by making a copy of the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook.sourceforge.net/snapshot/xsl/manpages/charmap.groff.xsl">standard roff character map</link> provided in the distribution, and
1441
+ then adding to, changing, and/or deleting from that.</para>
1442
+
1443
+ <caution>
1444
+ <para>If you author your DocBook XML source in UTF-8 or UTF-16
1445
+ encoding and aren't sure what OSes or environments your man-page
1446
+ output might end up being viewed on, and not sure what version of
1447
+ nroff/groff those environments might have, you should be careful about
1448
+ what Unicode symbols and special characters you use in your source and
1449
+ what parts you add to the value of
1450
+ <parameter>man.charmap.subset.profile</parameter>.</para>
1451
+ <para>Many of the escape codes used are specific to groff and using
1452
+ them may not provide the expected output on an OS or environment that
1453
+ uses nroff instead of groff.</para>
1454
+ <para>On the other hand, if you intend for your man-page output to be
1455
+ viewed only on modern systems (for example, GNU/Linux systems, FreeBSD
1456
+ systems, or Cygwin environments) that have a good, up-to-date groff,
1457
+ then you can safely include a wide range of Unicode symbols and
1458
+ special characters in your UTF-8 or UTF-16 encoded DocBook XML source
1459
+ and add any of the supported Unicode block names to the value of
1460
+ <parameter>man.charmap.subset.profile</parameter>.</para>
1461
+ </caution>
1462
+
1463
+
1464
+ <para>For other details, see the documentation for the
1465
+ <parameter>man.charmap.use.subset</parameter> parameter.</para>
1466
+
1467
+ <refsection xml:id="BlocksAndClasses"><info><title>Supported Unicode block names and "class" values</title></info>
1468
+
1469
+
1470
+ <para>Below is the full list of Unicode block names and "class"
1471
+ values supported in the standard roff stylesheet provided in the
1472
+ distribution, along with a description of which codepoints from the
1473
+ Unicode range corresponding to that block name or block/class
1474
+ combination are supported.</para>
1475
+
1476
+ <itemizedlist>
1477
+ <listitem>
1478
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=C1%20Controls%20and%20Latin-1%20Supplement%20(Latin-1%20Supplement)">C1 Controls And Latin-1 Supplement (Latin-1 Supplement)</link> (x00a0 to x00ff)
1479
+ <itemizedlist><info><title>class values</title></info>
1480
+
1481
+ <listitem>
1482
+ <para>symbols</para>
1483
+ </listitem>
1484
+ <listitem>
1485
+ <para>letters</para>
1486
+ </listitem>
1487
+ </itemizedlist></para>
1488
+ </listitem>
1489
+ <listitem>
1490
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Latin%20Extended-A">Latin Extended-A</link> (x0100 to x017f, partial)</para>
1491
+ </listitem>
1492
+ <listitem>
1493
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Spacing%20Modifier%20Letters">Spacing Modifier Letters</link> (x02b0 to x02ee, partial)</para>
1494
+ </listitem>
1495
+ <listitem>
1496
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Greek%20and%20Coptic">Greek and Coptic</link> (x0370 to x03ff, partial)</para>
1497
+ </listitem>
1498
+ <listitem>
1499
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=General%20Punctuation">General Punctuation</link> (x2000 to x206f, partial)
1500
+ <itemizedlist><info><title>class values</title></info>
1501
+
1502
+ <listitem>
1503
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;start=8192&amp;end=8203">spaces</link></para>
1504
+ </listitem>
1505
+ <listitem>
1506
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;start=8208&amp;end=8213">dashes</link></para>
1507
+ </listitem>
1508
+ <listitem>
1509
+ <para>quotes</para>
1510
+ </listitem>
1511
+ <listitem>
1512
+ <para>daggers</para>
1513
+ </listitem>
1514
+ <listitem>
1515
+ <para>bullets</para>
1516
+ </listitem>
1517
+ <listitem>
1518
+ <para>leaders</para>
1519
+ </listitem>
1520
+ <listitem>
1521
+ <para>primes</para>
1522
+ </listitem>
1523
+ </itemizedlist>
1524
+ </para>
1525
+ </listitem>
1526
+ <listitem>
1527
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Superscripts%20and%20Subscripts">Superscripts and Subscripts</link> (x2070 to x209f)</para>
1528
+ </listitem>
1529
+ <listitem>
1530
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Currency%20Symbols">Currency Symbols</link> (x20a0 to x20b1)</para>
1531
+ </listitem>
1532
+ <listitem>
1533
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Letterlike%20Symbols">Letterlike Symbols</link> (x2100 to x214b)</para>
1534
+ </listitem>
1535
+ <listitem>
1536
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Number%20Forms">Number Forms</link> (x2150 to x218f)</para>
1537
+ </listitem>
1538
+ <listitem>
1539
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Arrows">Arrows</link> (x2190 to x21ff, partial)</para>
1540
+ </listitem>
1541
+ <listitem>
1542
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Mathematical%20Operators">Mathematical Operators</link> (x2200 to x22ff, partial)</para>
1543
+ </listitem>
1544
+ <listitem>
1545
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Control%20Pictures">Control Pictures</link> (x2400 to x243f)</para>
1546
+ </listitem>
1547
+ <listitem>
1548
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Enclosed%20Alphanumerics">Enclosed Alphanumerics</link> (x2460 to x24ff)</para>
1549
+ </listitem>
1550
+ <listitem>
1551
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Geometric%20Shapes">Geometric Shapes</link> (x25a0 to x25f7, partial)</para>
1552
+ </listitem>
1553
+ <listitem>
1554
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Miscellaneous%20Symbols">Miscellaneous Symbols</link> (x2600 to x26ff, partial)</para>
1555
+ </listitem>
1556
+ <listitem>
1557
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Dingbats">Dingbats</link> (x2700 to x27be, partial)</para>
1558
+ </listitem>
1559
+ <listitem>
1560
+ <para><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://zvon.org/other/charSearch/PHP/search.php?searchType=103&amp;id=Alphabetic%20Presentation%20Forms">Alphabetic Presentation Forms</link> (xfb00 to xfb04 only)</para>
1561
+ </listitem>
1562
+ </itemizedlist>
1563
+ </refsection>
1564
+ </refsection>
1565
+ </refentry>
1566
+
1567
+ <refentry version="5.0" xml:id="man.charmap.subset.profile.english">
1568
+ <refmeta>
1569
+ <refentrytitle>man.charmap.subset.profile.english</refentrytitle>
1570
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1571
+ </refmeta>
1572
+ <refnamediv>
1573
+ <refname>man.charmap.subset.profile.english</refname>
1574
+ <refpurpose>Profile of character map subset</refpurpose>
1575
+ </refnamediv>
1576
+
1577
+ <refsynopsisdiv>
1578
+ <programlisting xml:id="man.charmap.subset.profile.english.frag">
1579
+ &lt;xsl:param name="man.charmap.subset.profile.english"&gt;
1580
+ @*[local-name() = 'block'] = 'Miscellaneous Technical' or
1581
+ (@*[local-name() = 'block'] = 'C1 Controls And Latin-1 Supplement (Latin-1 Supplement)' and
1582
+ @*[local-name() = 'class'] = 'symbols')
1583
+ or
1584
+ (@*[local-name() = 'block'] = 'General Punctuation' and
1585
+ (@*[local-name() = 'class'] = 'spaces' or
1586
+ @*[local-name() = 'class'] = 'dashes' or
1587
+ @*[local-name() = 'class'] = 'quotes' or
1588
+ @*[local-name() = 'class'] = 'bullets'
1589
+ )
1590
+ ) or
1591
+ @*[local-name() = 'name'] = 'HORIZONTAL ELLIPSIS' or
1592
+ @*[local-name() = 'name'] = 'WORD JOINER' or
1593
+ @*[local-name() = 'name'] = 'SERVICE MARK' or
1594
+ @*[local-name() = 'name'] = 'TRADE MARK SIGN' or
1595
+ @*[local-name() = 'name'] = 'ZERO WIDTH NO-BREAK SPACE'
1596
+ &lt;/xsl:param&gt;
1597
+ </programlisting>
1598
+ </refsynopsisdiv>
1599
+
1600
+ <refsection><info><title>Description</title></info>
1601
+
1602
+ <para>If the value of the
1603
+ <parameter>man.charmap.use.subset</parameter> parameter is
1604
+ non-zero, and your DocBook source is written in English (that
1605
+ is, if its <tag class="attribute">lang</tag> or <tag class="attribute">xml:lang</tag> attribute on the root element
1606
+ in your DocBook source or on the first <tag>refentry</tag>
1607
+ element in your source has the value <literal>en</literal> or if
1608
+ it has no <tag class="attribute">lang</tag> or <tag class="attribute">xml:lang</tag> attribute), then the
1609
+ character-map subset specified by the
1610
+ <parameter>man.charmap.subset.profile.english</parameter>
1611
+ parameter is used instead of the full roff character map.</para>
1612
+
1613
+ <para>Otherwise, if the <tag class="attribute">lang</tag> or <tag class="attribute">xml:lang</tag> attribute
1614
+ on the root element in your DocBook source or on the first
1615
+ <tag>refentry</tag> element in your source has a value other
1616
+ than <literal>en</literal>, then the character-map subset
1617
+ specified by the
1618
+ <parameter>man.charmap.subset.profile</parameter> parameter is
1619
+ used instead of
1620
+ <parameter>man.charmap.subset.profile.english</parameter>.</para>
1621
+
1622
+ <para>The difference between the two subsets is that
1623
+ <parameter>man.charmap.subset.profile</parameter> provides
1624
+ mappings for characters in Western European languages that are
1625
+ not part of the Roman (English) alphabet (ASCII character set).</para>
1626
+
1627
+ <para>The value of <parameter>man.charmap.subset.profile.english</parameter>
1628
+ is a string representing an XPath expression that matches attribute
1629
+ names and values for <tag namespace="http://docbook.sf.net/xmlns/unichar/1.0">output-character</tag> elements in the character map.</para>
1630
+
1631
+ <para>For other details, see the documentation for the
1632
+ <parameter>man.charmap.subset.profile.english</parameter> and
1633
+ <parameter>man.charmap.use.subset</parameter> parameters.</para>
1634
+
1635
+ </refsection>
1636
+ </refentry>
1637
+
1638
+ <refentry version="5.0" xml:id="man.string.subst.map.local.pre">
1639
+ <refmeta>
1640
+ <refentrytitle>man.string.subst.map.local.pre</refentrytitle>
1641
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1642
+ </refmeta>
1643
+ <refnamediv>
1644
+ <refname>man.string.subst.map.local.pre</refname>
1645
+ <refpurpose>Specifies &#8220;local&#8221; string substitutions</refpurpose>
1646
+ </refnamediv>
1647
+
1648
+ <refsynopsisdiv>
1649
+ <programlisting xml:id="man.string.subst.map.local.pre.frag">
1650
+ &lt;xsl:param name="man.string.subst.map.local.pre"&gt;&lt;/xsl:param&gt;
1651
+ </programlisting>
1652
+ </refsynopsisdiv>
1653
+
1654
+ <refsection><info><title>Description</title></info>
1655
+
1656
+ <para>Use the <parameter>man.string.subst.map.local.pre</parameter>
1657
+ parameter to specify any &#8220;local&#8221; string substitutions to perform over
1658
+ the entire roff source for each man page <emphasis>before</emphasis>
1659
+ performing the string substitutions specified by the <parameter>man.string.subst.map</parameter> parameter.</para>
1660
+
1661
+ <para>For details about the format of this parameter, see the
1662
+ documentation for the <parameter>man.string.subst.map</parameter>
1663
+ parameter.</para>
1664
+
1665
+ </refsection>
1666
+ </refentry>
1667
+
1668
+ <refentry version="5.0" xml:id="man.string.subst.map">
1669
+ <refmeta>
1670
+ <refentrytitle>man.string.subst.map</refentrytitle>
1671
+ <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>
1672
+ </refmeta>
1673
+ <refnamediv>
1674
+ <refname>man.string.subst.map</refname>
1675
+ <refpurpose>Specifies a set of string substitutions</refpurpose>
1676
+ </refnamediv>
1677
+
1678
+ <refsynopsisdiv>
1679
+ <programlisting xml:id="man.string.subst.map.frag">
1680
+ &lt;xsl:param name="man.string.subst.map"&gt;
1681
+
1682
+ &lt;!-- * remove no-break marker at beginning of line (stylesheet artifact) --&gt;
1683
+ &lt;ss:substitution oldstring="&#9618;&#9600;" newstring="&#9618;"&gt;&lt;/ss:substitution&gt;
1684
+ &lt;!-- * replace U+2580 no-break marker (stylesheet-added) w/ no-break space --&gt;
1685
+ &lt;ss:substitution oldstring="&#9600;" newstring="\ "&gt;&lt;/ss:substitution&gt;
1686
+
1687
+ &lt;!-- ==================================================================== --&gt;
1688
+
1689
+ &lt;!-- * squeeze multiple newlines before a roff request --&gt;
1690
+ &lt;ss:substitution oldstring="
1691
+
1692
+ ." newstring="
1693
+ ."&gt;&lt;/ss:substitution&gt;
1694
+ &lt;!-- * remove any .sp instances that directly precede a .PP --&gt;
1695
+ &lt;ss:substitution oldstring=".sp
1696
+ .PP" newstring=".PP"&gt;&lt;/ss:substitution&gt;
1697
+ &lt;!-- * remove any .sp instances that directly follow a .PP --&gt;
1698
+ &lt;ss:substitution oldstring=".sp
1699
+ .sp" newstring=".sp"&gt;&lt;/ss:substitution&gt;
1700
+ &lt;!-- * squeeze multiple .sp instances into a single .sp--&gt;
1701
+ &lt;ss:substitution oldstring=".PP
1702
+ .sp" newstring=".PP"&gt;&lt;/ss:substitution&gt;
1703
+ &lt;!-- * squeeze multiple newlines after start of no-fill (verbatim) env. --&gt;
1704
+ &lt;ss:substitution oldstring=".nf
1705
+
1706
+ " newstring=".nf
1707
+ "&gt;&lt;/ss:substitution&gt;
1708
+ &lt;!-- * squeeze multiple newlines after REstoring margin --&gt;
1709
+ &lt;ss:substitution oldstring=".RE
1710
+
1711
+ " newstring=".RE
1712
+ "&gt;&lt;/ss:substitution&gt;
1713
+ &lt;!-- * U+2591 is a marker we add before and after every Parameter in --&gt;
1714
+ &lt;!-- * Funcprototype output --&gt;
1715
+ &lt;ss:substitution oldstring="&#9617;" newstring=" "&gt;&lt;/ss:substitution&gt;
1716
+ &lt;!-- * U+2592 is a marker we add for the newline before output of &lt;sbr&gt;; --&gt;
1717
+ &lt;ss:substitution oldstring="&#9618;" newstring="
1718
+ "&gt;&lt;/ss:substitution&gt;
1719
+ &lt;!-- * --&gt;
1720
+ &lt;!-- * Now deal with some other characters that are added by the --&gt;
1721
+ &lt;!-- * stylesheets during processing. --&gt;
1722
+ &lt;!-- * --&gt;
1723
+ &lt;!-- * bullet --&gt;
1724
+ &lt;ss:substitution oldstring="&#8226;" newstring="\(bu"&gt;&lt;/ss:substitution&gt;
1725
+ &lt;!-- * left double quote --&gt;
1726
+ &lt;ss:substitution oldstring="&#8220;" newstring="\(lq"&gt;&lt;/ss:substitution&gt;
1727
+ &lt;!-- * right double quote --&gt;
1728
+ &lt;ss:substitution oldstring="&#8221;" newstring="\(rq"&gt;&lt;/ss:substitution&gt;
1729
+ &lt;!-- * left single quote --&gt;
1730
+ &lt;ss:substitution oldstring="&#8216;" newstring="\(oq"&gt;&lt;/ss:substitution&gt;
1731
+ &lt;!-- * right single quote --&gt;
1732
+ &lt;ss:substitution oldstring="&#8217;" newstring="\(cq"&gt;&lt;/ss:substitution&gt;
1733
+ &lt;!-- * copyright sign --&gt;
1734
+ &lt;ss:substitution oldstring="&#169;" newstring="\(co"&gt;&lt;/ss:substitution&gt;
1735
+ &lt;!-- * registered sign --&gt;
1736
+ &lt;ss:substitution oldstring="&#174;" newstring="\(rg"&gt;&lt;/ss:substitution&gt;
1737
+ &lt;!-- * ...servicemark... --&gt;
1738
+ &lt;!-- * There is no groff equivalent for it. --&gt;
1739
+ &lt;ss:substitution oldstring="&#8480;" newstring="(SM)"&gt;&lt;/ss:substitution&gt;
1740
+ &lt;!-- * ...trademark... --&gt;
1741
+ &lt;!-- * We don't do "\(tm" because for console output, --&gt;
1742
+ &lt;!-- * groff just renders that as "tm"; that is: --&gt;
1743
+ &lt;!-- * --&gt;
1744
+ &lt;!-- * Product&amp;#x2122; -&gt; Producttm --&gt;
1745
+ &lt;!-- * --&gt;
1746
+ &lt;!-- * So we just make it to "(TM)" instead; thus: --&gt;
1747
+ &lt;!-- * --&gt;
1748
+ &lt;!-- * Product&amp;#x2122; -&gt; Product(TM) --&gt;
1749
+ &lt;ss:substitution oldstring="&#8482;" newstring="(TM)"&gt;&lt;/ss:substitution&gt;
1750
+
1751
+ &lt;/xsl:param&gt;
1752
+ </programlisting>
1753
+ </refsynopsisdiv>
1754
+
1755
+ <refsection><info><title>Description</title></info>
1756
+
1757
+ <para>The <parameter>man.string.subst.map</parameter> parameter
1758
+ contains <link linkend="map">a map</link> that specifies a set of
1759
+ string substitutions to perform over the entire roff source for each
1760
+ man page, either just before generating final man-page output (that
1761
+ is, before writing man-page files to disk) or, if the value of the
1762
+ <parameter>man.charmap.enabled</parameter> parameter is non-zero,
1763
+ before applying the roff character map.</para>
1764
+
1765
+ <para>You can use <parameter>man.string.subst.map</parameter> as a
1766
+ &#8220;lightweight&#8221; character map to perform &#8220;essential&#8221; substitutions --
1767
+ that is, substitutions that are <emphasis>always</emphasis> performed,
1768
+ even if the value of the <parameter>man.charmap.enabled</parameter>
1769
+ parameter is zero. For example, you can use it to replace quotation
1770
+ marks or other special characters that are generated by the DocBook
1771
+ XSL stylesheets for a particular locale setting (as opposed to those
1772
+ characters that are actually in source XML documents), or to replace
1773
+ any special characters that may be automatically generated by a
1774
+ particular customization of the DocBook XSL stylesheets.</para>
1775
+
1776
+ <warning>
1777
+ <para>Do you not change value of the
1778
+ <parameter>man.string.subst.map</parameter> parameter unless you are
1779
+ sure what you are doing. First consider adding your
1780
+ string-substitution mappings to either or both of the following
1781
+ parameters:
1782
+ <variablelist>
1783
+ <varlistentry>
1784
+ <term><parameter>man.string.subst.map.local.pre</parameter></term>
1785
+ <listitem><para>applied before
1786
+ <parameter>man.string.subst.map</parameter></para></listitem>
1787
+ </varlistentry>
1788
+ <varlistentry>
1789
+ <term><parameter>man.string.subst.map.local.post</parameter></term>
1790
+ <listitem><para>applied after
1791
+ <parameter>man.string.subst.map</parameter></para></listitem>
1792
+ </varlistentry>
1793
+ </variablelist>
1794
+ By default, both of those parameters contain no
1795
+ string substitutions. They are intended as a means for you to
1796
+ specify your own local string-substitution mappings.</para>
1797
+
1798
+ <para>If you remove any of default mappings from the value of the
1799
+ <parameter>man.string.subst.map</parameter> parameter, you are
1800
+ likely to end up with broken output. And be very careful about adding
1801
+ anything to it; it&#8217;s used for doing string substitution over the
1802
+ entire roff source of each man page &#8211; it causes target strings to be
1803
+ replaced in roff requests and escapes, not just in the visible
1804
+ contents of the page.</para>
1805
+
1806
+ </warning>
1807
+
1808
+ <refsection xml:id="map">
1809
+ <info>
1810
+ <title>Contents of the substitution map</title>
1811
+ </info>
1812
+ <para>The string-substitution map contains one or more
1813
+ <tag>ss:substitution</tag> elements, each of which has two
1814
+ attributes:
1815
+ <variablelist>
1816
+ <varlistentry>
1817
+ <term>oldstring</term>
1818
+ <listitem>
1819
+ <simpara>string to replace</simpara>
1820
+ </listitem>
1821
+ </varlistentry>
1822
+ <varlistentry>
1823
+ <term>newstring</term>
1824
+ <listitem>
1825
+ <simpara>string with which to replace <tag class="attribute">oldstring</tag></simpara>
1826
+ </listitem>
1827
+ </varlistentry>
1828
+ </variablelist>
1829
+ It may also include XML comments (that is, delimited with
1830
+ "<literal>&lt;!--</literal>" and "<literal>--&gt;</literal>").
1831
+ </para>
1832
+ </refsection>
1833
+
1834
+ </refsection>
1835
+ </refentry>
1836
+
1837
+ <refentry version="5.0" xml:id="man.string.subst.map.local.post">
1838
+ <refmeta>
1839
+ <refentrytitle>man.string.subst.map.local.post</refentrytitle>
1840
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1841
+ </refmeta>
1842
+ <refnamediv>
1843
+ <refname>man.string.subst.map.local.post</refname>
1844
+ <refpurpose>Specifies &#8220;local&#8221; string substitutions</refpurpose>
1845
+ </refnamediv>
1846
+
1847
+ <refsynopsisdiv>
1848
+ <programlisting xml:id="man.string.subst.map.local.post.frag">
1849
+ &lt;xsl:param name="man.string.subst.map.local.post"&gt;&lt;/xsl:param&gt;
1850
+ </programlisting>
1851
+ </refsynopsisdiv>
1852
+
1853
+ <refsection><info><title>Description</title></info>
1854
+
1855
+ <para>Use the <parameter>man.string.subst.map.local.post</parameter>
1856
+ parameter to specify any &#8220;local&#8221; string substitutions to perform over
1857
+ the entire roff source for each man page <emphasis>after</emphasis>
1858
+ performing the string substitutions specified by the <parameter>man.string.subst.map</parameter> parameter.</para>
1859
+
1860
+ <para>For details about the format of this parameter, see the
1861
+ documentation for the <parameter>man.string.subst.map</parameter>
1862
+ parameter.</para>
1863
+
1864
+ </refsection>
1865
+ </refentry>
1866
+
1867
+ </reference>
1868
+ <reference xml:id="refmeta">
1869
+ <title>Refentry metadata gathering</title>
1870
+ <refentry version="5.0" xml:id="refentry.meta.get.quietly">
1871
+ <refmeta>
1872
+ <refentrytitle>refentry.meta.get.quietly</refentrytitle>
1873
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1874
+ </refmeta>
1875
+ <refnamediv>
1876
+ <refname>refentry.meta.get.quietly</refname>
1877
+ <refpurpose>Suppress notes and warnings when gathering refentry metadata?</refpurpose>
1878
+ </refnamediv>
1879
+
1880
+ <refsynopsisdiv>
1881
+ <programlisting xml:id="refentry.meta.get.quietly.frag">
1882
+ &lt;xsl:param name="refentry.meta.get.quietly" select="0"&gt;&lt;/xsl:param&gt;
1883
+ </programlisting>
1884
+ </refsynopsisdiv>
1885
+
1886
+ <refsection><info><title>Description</title></info>
1887
+
1888
+ <para>If zero (the default), notes and warnings about &#8220;missing&#8221; markup
1889
+ are generated during gathering of refentry metadata. If non-zero, the
1890
+ metadata is gathered &#8220;quietly&#8221; -- that is, the notes and warnings are
1891
+ suppressed.</para>
1892
+
1893
+ <tip>
1894
+ <para>If you are processing a large amount of <tag>refentry</tag>
1895
+ content, you may be able to speed up processing significantly by
1896
+ setting a non-zero value for
1897
+ <parameter>refentry.meta.get.quietly</parameter>.</para>
1898
+ </tip>
1899
+
1900
+ </refsection>
1901
+ </refentry>
1902
+
1903
+ <refentry version="5.0" xml:id="refentry.date.profile">
1904
+ <refmeta>
1905
+ <refentrytitle>refentry.date.profile</refentrytitle>
1906
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1907
+ </refmeta>
1908
+ <refnamediv>
1909
+ <refname>refentry.date.profile</refname>
1910
+ <refpurpose>Specifies profile for refentry "date" data</refpurpose>
1911
+ </refnamediv>
1912
+
1913
+ <refsynopsisdiv>
1914
+ <programlisting xml:id="refentry.date.profile.frag">
1915
+ &lt;xsl:param name="refentry.date.profile"&gt;
1916
+ (($info[//date])[last()]/date)[1]|
1917
+ (($info[//pubdate])[last()]/pubdate)[1]
1918
+ &lt;/xsl:param&gt;
1919
+ </programlisting>
1920
+ </refsynopsisdiv>
1921
+
1922
+ <refsection><info><title>Description</title></info>
1923
+
1924
+ <para>The value of <parameter>refentry.date.profile</parameter> is a
1925
+ string representing an XPath expression. It is evaluated at run-time
1926
+ and used only if <parameter>refentry.date.profile.enabled</parameter>
1927
+ is non-zero. Otherwise, the <tag>refentry</tag> metadata-gathering
1928
+ logic "hard coded" into the stylesheets is used.</para>
1929
+
1930
+ <para> The <literal>man(7)</literal> man page describes this content
1931
+ as "the date of the last revision". In man pages, it is the content
1932
+ that is usually displayed in the center footer.</para>
1933
+
1934
+ </refsection>
1935
+ </refentry>
1936
+
1937
+ <refentry version="5.0" xml:id="refentry.date.profile.enabled">
1938
+ <refmeta>
1939
+ <refentrytitle>refentry.date.profile.enabled</refentrytitle>
1940
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
1941
+ </refmeta>
1942
+ <refnamediv>
1943
+ <refname>refentry.date.profile.enabled</refname>
1944
+ <refpurpose>Enable refentry "date" profiling?</refpurpose>
1945
+ </refnamediv>
1946
+
1947
+ <refsynopsisdiv>
1948
+ <programlisting xml:id="refentry.date.profile.enabled.frag">
1949
+ &lt;xsl:param name="refentry.date.profile.enabled"&gt;0&lt;/xsl:param&gt;</programlisting>
1950
+ </refsynopsisdiv>
1951
+
1952
+ <refsection><info><title>Description</title></info>
1953
+
1954
+ <para>If the value of
1955
+ <parameter>refentry.date.profile.enabled</parameter> is non-zero, then
1956
+ during <tag>refentry</tag> metadata gathering, the info profile
1957
+ specified by the customizable
1958
+ <parameter>refentry.date.profile</parameter> parameter is used.</para>
1959
+
1960
+ <para>If instead the value of
1961
+ <parameter>refentry.date.profile.enabled</parameter> is zero (the
1962
+ default), then "hard coded" logic within the DocBook XSL stylesheets
1963
+ is used for gathering <tag>refentry</tag> "date" data.</para>
1964
+
1965
+ <para>If you find that the default <tag>refentry</tag>
1966
+ metadata-gathering behavior is causing incorrect "date" data to show
1967
+ up in your output, then consider setting a non-zero value for
1968
+ <parameter>refentry.date.profile.enabled</parameter> and adjusting the
1969
+ value of <parameter>refentry.date.profile</parameter> to cause correct
1970
+ data to be gathered. </para>
1971
+
1972
+ <para>Note that the terms "source" and "date" have special meanings in
1973
+ this context. For details, see the documentation for the
1974
+ <parameter>refentry.date.profile</parameter> parameter.</para>
1975
+
1976
+ </refsection>
1977
+ </refentry>
1978
+
1979
+ <refentry version="5.0" xml:id="refentry.manual.profile">
1980
+ <refmeta>
1981
+ <refentrytitle>refentry.manual.profile</refentrytitle>
1982
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
1983
+ </refmeta>
1984
+ <refnamediv>
1985
+ <refname>refentry.manual.profile</refname>
1986
+ <refpurpose>Specifies profile for refentry "manual" data</refpurpose>
1987
+ </refnamediv>
1988
+
1989
+ <refsynopsisdiv>
1990
+ <programlisting xml:id="refentry.manual.profile.frag">
1991
+ &lt;xsl:param name="refentry.manual.profile"&gt;
1992
+ (($info[//title])[last()]/title)[1]|
1993
+ ../title/node()
1994
+ &lt;/xsl:param&gt;
1995
+ </programlisting>
1996
+ </refsynopsisdiv>
1997
+
1998
+ <refsection><info><title>Description</title></info>
1999
+
2000
+ <para>The value of <parameter>refentry.manual.profile</parameter> is
2001
+ a string representing an XPath expression. It is evaluated at
2002
+ run-time and used only if
2003
+ <parameter>refentry.manual.profile.enabled</parameter> is
2004
+ non-zero. Otherwise, the <tag>refentry</tag> metadata-gathering logic
2005
+ "hard coded" into the stylesheets is used.</para>
2006
+
2007
+ <para>In man pages, this content is usually displayed in the middle of
2008
+ the header of the page. The <literal>man(7)</literal> man page
2009
+ describes this as "the title of the manual (e.g., <citetitle>Linux
2010
+ Programmer's Manual</citetitle>)". Here are some examples from
2011
+ existing man pages:
2012
+ <itemizedlist>
2013
+ <listitem>
2014
+ <para><citetitle>dpkg utilities</citetitle>
2015
+ (<command>dpkg-name</command>)</para>
2016
+ </listitem>
2017
+ <listitem>
2018
+ <para><citetitle>User Contributed Perl Documentation</citetitle>
2019
+ (<command>GET</command>)</para>
2020
+ </listitem>
2021
+ <listitem>
2022
+ <para><citetitle>GNU Development Tools</citetitle>
2023
+ (<command>ld</command>)</para>
2024
+ </listitem>
2025
+ <listitem>
2026
+ <para><citetitle>Emperor Norton Utilities</citetitle>
2027
+ (<command>ddate</command>)</para>
2028
+ </listitem>
2029
+ <listitem>
2030
+ <para><citetitle>Debian GNU/Linux manual</citetitle>
2031
+ (<command>faked</command>)</para>
2032
+ </listitem>
2033
+ <listitem>
2034
+ <para><citetitle>GIMP Manual Pages</citetitle>
2035
+ (<command>gimp</command>)</para>
2036
+ </listitem>
2037
+ <listitem>
2038
+ <para><citetitle>KDOC Documentation System</citetitle>
2039
+ (<command>qt2kdoc</command>)</para>
2040
+ </listitem>
2041
+ </itemizedlist>
2042
+ </para>
2043
+
2044
+ </refsection>
2045
+ </refentry>
2046
+
2047
+ <refentry version="5.0" xml:id="refentry.manual.profile.enabled">
2048
+ <refmeta>
2049
+ <refentrytitle>refentry.manual.profile.enabled</refentrytitle>
2050
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2051
+ </refmeta>
2052
+ <refnamediv>
2053
+ <refname>refentry.manual.profile.enabled</refname>
2054
+ <refpurpose>Enable refentry "manual" profiling?</refpurpose>
2055
+ </refnamediv>
2056
+
2057
+ <refsynopsisdiv>
2058
+ <programlisting xml:id="refentry.manual.profile.enabled.frag">
2059
+ &lt;xsl:param name="refentry.manual.profile.enabled"&gt;0&lt;/xsl:param&gt;</programlisting>
2060
+ </refsynopsisdiv>
2061
+
2062
+ <refsection><info><title>Description</title></info>
2063
+
2064
+ <para>If the value of
2065
+ <parameter>refentry.manual.profile.enabled</parameter> is
2066
+ non-zero, then during <tag>refentry</tag> metadata gathering, the info
2067
+ profile specified by the customizable
2068
+ <parameter>refentry.manual.profile</parameter> parameter is
2069
+ used.</para>
2070
+
2071
+ <para>If instead the value of
2072
+ <parameter>refentry.manual.profile.enabled</parameter> is zero (the
2073
+ default), then "hard coded" logic within the DocBook XSL stylesheets
2074
+ is used for gathering <tag>refentry</tag> "manual" data.</para>
2075
+
2076
+ <para>If you find that the default <tag>refentry</tag>
2077
+ metadata-gathering behavior is causing incorrect "manual" data to show
2078
+ up in your output, then consider setting a non-zero value for
2079
+ <parameter>refentry.manual.profile.enabled</parameter> and adjusting
2080
+ the value of <parameter>refentry.manual.profile</parameter> to cause
2081
+ correct data to be gathered. </para>
2082
+
2083
+ <para>Note that the term "manual" has a special meanings in this
2084
+ context. For details, see the documentation for the
2085
+ <parameter>refentry.manual.profile</parameter> parameter.</para>
2086
+
2087
+ </refsection>
2088
+ </refentry>
2089
+
2090
+ <refentry version="5.0" xml:id="refentry.source.name.suppress">
2091
+ <refmeta>
2092
+ <refentrytitle>refentry.source.name.suppress</refentrytitle>
2093
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2094
+ </refmeta>
2095
+ <refnamediv>
2096
+ <refname>refentry.source.name.suppress</refname>
2097
+ <refpurpose>Suppress "name" part of refentry "source" contents?</refpurpose>
2098
+ </refnamediv>
2099
+
2100
+ <refsynopsisdiv>
2101
+ <programlisting xml:id="refentry.source.name.suppress.frag">
2102
+ &lt;xsl:param name="refentry.source.name.suppress"&gt;0&lt;/xsl:param&gt;</programlisting>
2103
+ </refsynopsisdiv>
2104
+
2105
+ <refsection><info><title>Description</title></info>
2106
+
2107
+ <para>If the value of
2108
+ <parameter>refentry.source.name.suppress</parameter> is non-zero, then
2109
+ during <tag>refentry</tag> metadata gathering, no "source name" data
2110
+ is added to the <tag>refentry</tag> "source" contents. Instead (unless
2111
+ <parameter>refentry.version.suppress</parameter> is also non-zero),
2112
+ only "version" data is added to the "source" contents.</para>
2113
+
2114
+ <para>If you find that the <tag>refentry</tag> metadata gathering
2115
+ mechanism is causing unwanted "source name" data to show up in your
2116
+ output -- for example, in the footer (or possibly header) of a man
2117
+ page -- then you might consider setting a non-zero value for
2118
+ <parameter>refentry.source.name.suppress</parameter>.</para>
2119
+
2120
+ <para>Note that the terms "source", "source name", and "version" have
2121
+ special meanings in this context. For details, see the documentation
2122
+ for the <parameter>refentry.source.name.profile</parameter>
2123
+ parameter.</para>
2124
+
2125
+ </refsection>
2126
+ </refentry>
2127
+
2128
+ <refentry version="5.0" xml:id="refentry.source.name.profile">
2129
+ <refmeta>
2130
+ <refentrytitle>refentry.source.name.profile</refentrytitle>
2131
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2132
+ </refmeta>
2133
+ <refnamediv>
2134
+ <refname>refentry.source.name.profile</refname>
2135
+ <refpurpose>Specifies profile for refentry "source name" data</refpurpose>
2136
+ </refnamediv>
2137
+
2138
+ <refsynopsisdiv>
2139
+ <programlisting xml:id="refentry.source.name.profile.frag">
2140
+ &lt;xsl:param name="refentry.source.name.profile"&gt;
2141
+ (($info[//productname])[last()]/productname)[1]|
2142
+ (($info[//corpname])[last()]/corpname)[1]|
2143
+ (($info[//corpcredit])[last()]/corpcredit)[1]|
2144
+ (($info[//corpauthor])[last()]/corpauthor)[1]|
2145
+ (($info[//orgname])[last()]/orgname)[1]|
2146
+ (($info[//publishername])[last()]/publishername)[1]
2147
+ &lt;/xsl:param&gt;
2148
+ </programlisting>
2149
+ </refsynopsisdiv>
2150
+
2151
+ <refsection><info><title>Description</title></info>
2152
+
2153
+ <para>The value of <parameter>refentry.source.name.profile</parameter>
2154
+ is a string representing an XPath expression. It is evaluated at
2155
+ run-time and used only if
2156
+ <parameter>refentry.source.name.profile.enabled</parameter> is
2157
+ non-zero. Otherwise, the <tag>refentry</tag> metadata-gathering logic
2158
+ "hard coded" into the stylesheets is used.</para>
2159
+
2160
+ <para>A "source name" is one part of a (potentially) two-part
2161
+ <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>
2162
+ "source" field. In man pages, it is usually displayed in the left
2163
+ footer of the page. It typically indicates the software system or
2164
+ product that the item documented in the man page belongs to. The
2165
+ <literal>man(7)</literal> man page describes it as "the source of
2166
+ the command", and provides the following examples:
2167
+ <itemizedlist>
2168
+ <listitem>
2169
+ <para>For binaries, use something like: GNU, NET-2, SLS
2170
+ Distribution, MCC Distribution.</para>
2171
+ </listitem>
2172
+ <listitem>
2173
+ <para>For system calls, use the version of the kernel that you
2174
+ are currently looking at: Linux 0.99.11.</para>
2175
+ </listitem>
2176
+ <listitem>
2177
+ <para>For library calls, use the source of the function: GNU, BSD
2178
+ 4.3, Linux DLL 4.4.1.</para>
2179
+ </listitem>
2180
+ </itemizedlist>
2181
+ </para>
2182
+
2183
+ <para>In practice, there are many pages that simply have a Version
2184
+ number in the "source" field. So, it looks like what we have is a
2185
+ two-part field,
2186
+ <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>,
2187
+ where:
2188
+ <variablelist>
2189
+ <varlistentry>
2190
+ <term>Name</term>
2191
+ <listitem>
2192
+ <para>product name (e.g., BSD) or org. name (e.g., GNU)</para>
2193
+ </listitem>
2194
+ </varlistentry>
2195
+ <varlistentry>
2196
+ <term>Version</term>
2197
+ <listitem>
2198
+ <para>version number</para>
2199
+ </listitem>
2200
+ </varlistentry>
2201
+ </variablelist>
2202
+ Each part is optional. If the <replaceable>Name</replaceable> is a
2203
+ product name, then the <replaceable>Version</replaceable> is probably
2204
+ the version of the product. Or there may be no
2205
+ <replaceable>Name</replaceable>, in which case, if there is a
2206
+ <replaceable>Version</replaceable>, it is probably the version
2207
+ of the item itself, not the product it is part of. Or, if the
2208
+ <replaceable>Name</replaceable> is an organization name, then there
2209
+ probably will be no <replaceable>Version</replaceable>.</para>
2210
+ </refsection>
2211
+ </refentry>
2212
+
2213
+ <refentry version="5.0" xml:id="refentry.source.name.profile.enabled">
2214
+ <refmeta>
2215
+ <refentrytitle>refentry.source.name.profile.enabled</refentrytitle>
2216
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2217
+ </refmeta>
2218
+ <refnamediv>
2219
+ <refname>refentry.source.name.profile.enabled</refname>
2220
+ <refpurpose>Enable refentry "source name" profiling?</refpurpose>
2221
+ </refnamediv>
2222
+
2223
+ <refsynopsisdiv>
2224
+ <programlisting xml:id="refentry.source.name.profile.enabled.frag">
2225
+ &lt;xsl:param name="refentry.source.name.profile.enabled"&gt;0&lt;/xsl:param&gt;</programlisting>
2226
+ </refsynopsisdiv>
2227
+
2228
+ <refsection><info><title>Description</title></info>
2229
+
2230
+ <para>If the value of
2231
+ <parameter>refentry.source.name.profile.enabled</parameter> is
2232
+ non-zero, then during <tag>refentry</tag> metadata gathering, the info
2233
+ profile specified by the customizable
2234
+ <parameter>refentry.source.name.profile</parameter> parameter is
2235
+ used.</para>
2236
+
2237
+ <para>If instead the value of
2238
+ <parameter>refentry.source.name.profile.enabled</parameter> is zero (the
2239
+ default), then "hard coded" logic within the DocBook XSL stylesheets
2240
+ is used for gathering <tag>refentry</tag> "source name" data.</para>
2241
+
2242
+ <para>If you find that the default <tag>refentry</tag>
2243
+ metadata-gathering behavior is causing incorrect "source name" data to
2244
+ show up in your output, then consider setting a non-zero value for
2245
+ <parameter>refentry.source.name.profile.enabled</parameter> and
2246
+ adjusting the value of
2247
+ <parameter>refentry.source.name.profile</parameter> to cause correct
2248
+ data to be gathered. </para>
2249
+
2250
+ <para>Note that the terms "source" and "source name" have special
2251
+ meanings in this context. For details, see the documentation for the
2252
+ <parameter>refentry.source.name.profile</parameter> parameter.</para>
2253
+
2254
+ </refsection>
2255
+ </refentry>
2256
+
2257
+ <refentry version="5.0" xml:id="refentry.version.suppress">
2258
+ <refmeta>
2259
+ <refentrytitle>refentry.version.suppress</refentrytitle>
2260
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2261
+ </refmeta>
2262
+ <refnamediv>
2263
+ <refname>refentry.version.suppress</refname>
2264
+ <refpurpose>Suppress "version" part of refentry "source" contents?</refpurpose>
2265
+ </refnamediv>
2266
+
2267
+ <refsynopsisdiv>
2268
+ <programlisting xml:id="refentry.version.suppress.frag">
2269
+ &lt;xsl:param name="refentry.version.suppress"&gt;0&lt;/xsl:param&gt;</programlisting>
2270
+ </refsynopsisdiv>
2271
+
2272
+ <refsection><info><title>Description</title></info>
2273
+
2274
+ <para>If the value of <parameter>refentry.version.suppress</parameter>
2275
+ is non-zero, then during <tag>refentry</tag> metadata gathering, no
2276
+ "version" data is added to the <tag>refentry</tag> "source"
2277
+ contents. Instead (unless
2278
+ <parameter>refentry.source.name.suppress</parameter> is also
2279
+ non-zero), only "source name" data is added to the "source"
2280
+ contents.</para>
2281
+
2282
+ <para>If you find that the <tag>refentry</tag> metadata gathering
2283
+ mechanism is causing unwanted "version" data to show up in your output
2284
+ -- for example, in the footer (or possibly header) of a man page --
2285
+ then you might consider setting a non-zero value for
2286
+ <parameter>refentry.version.suppress</parameter>.</para>
2287
+
2288
+ <para>Note that the terms "source", "source name", and "version" have
2289
+ special meanings in this context. For details, see the documentation
2290
+ for the <parameter>refentry.source.name.profile</parameter>
2291
+ parameter.</para>
2292
+
2293
+ </refsection>
2294
+ </refentry>
2295
+
2296
+ <refentry version="5.0" xml:id="refentry.version.profile">
2297
+ <refmeta>
2298
+ <refentrytitle>refentry.version.profile</refentrytitle>
2299
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2300
+ </refmeta>
2301
+ <refnamediv>
2302
+ <refname>refentry.version.profile</refname>
2303
+ <refpurpose>Specifies profile for refentry "version" data</refpurpose>
2304
+ </refnamediv>
2305
+
2306
+ <refsynopsisdiv>
2307
+ <programlisting xml:id="refentry.version.profile.frag">
2308
+ &lt;xsl:param name="refentry.version.profile"&gt;
2309
+ (($info[//productnumber])[last()]/productnumber)[1]|
2310
+ (($info[//edition])[last()]/edition)[1]|
2311
+ (($info[//releaseinfo])[last()]/releaseinfo)[1]
2312
+ &lt;/xsl:param&gt;
2313
+ </programlisting>
2314
+ </refsynopsisdiv>
2315
+
2316
+ <refsection><info><title>Description</title></info>
2317
+
2318
+ <para>The value of <parameter>refentry.version.profile</parameter> is
2319
+ a string representing an XPath expression. It is evaluated at
2320
+ run-time and used only if
2321
+ <parameter>refentry.version.profile.enabled</parameter> is
2322
+ non-zero. Otherwise, the <tag>refentry</tag> metadata-gathering logic
2323
+ "hard coded" into the stylesheets is used.</para>
2324
+
2325
+ <para>A "source.name" is one part of a (potentially) two-part
2326
+ <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>
2327
+ "source" field. For more details, see the documentation for the
2328
+ <parameter>refentry.source.name.profile</parameter> parameter.</para>
2329
+
2330
+ </refsection>
2331
+ </refentry>
2332
+
2333
+ <refentry version="5.0" xml:id="refentry.version.profile.enabled">
2334
+ <refmeta>
2335
+ <refentrytitle>refentry.version.profile.enabled</refentrytitle>
2336
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2337
+ </refmeta>
2338
+ <refnamediv>
2339
+ <refname>refentry.version.profile.enabled</refname>
2340
+ <refpurpose>Enable refentry "version" profiling?</refpurpose>
2341
+ </refnamediv>
2342
+
2343
+ <refsynopsisdiv>
2344
+ <programlisting xml:id="refentry.version.profile.enabled.frag">
2345
+ &lt;xsl:param name="refentry.version.profile.enabled"&gt;0&lt;/xsl:param&gt;</programlisting>
2346
+ </refsynopsisdiv>
2347
+
2348
+ <refsection><info><title>Description</title></info>
2349
+
2350
+ <para>If the value of
2351
+ <parameter>refentry.version.profile.enabled</parameter> is
2352
+ non-zero, then during <tag>refentry</tag> metadata gathering, the info
2353
+ profile specified by the customizable
2354
+ <parameter>refentry.version.profile</parameter> parameter is
2355
+ used.</para>
2356
+
2357
+ <para>If instead the value of
2358
+ <parameter>refentry.version.profile.enabled</parameter> is zero (the
2359
+ default), then "hard coded" logic within the DocBook XSL stylesheets
2360
+ is used for gathering <tag>refentry</tag> "version" data.</para>
2361
+
2362
+ <para>If you find that the default <tag>refentry</tag>
2363
+ metadata-gathering behavior is causing incorrect "version" data to show
2364
+ up in your output, then consider setting a non-zero value for
2365
+ <parameter>refentry.version.profile.enabled</parameter> and adjusting
2366
+ the value of <parameter>refentry.version.profile</parameter> to cause
2367
+ correct data to be gathered. </para>
2368
+
2369
+ <para>Note that the terms "source" and "version" have special
2370
+ meanings in this context. For details, see the documentation for the
2371
+ <parameter>refentry.version.profile</parameter> parameter.</para>
2372
+
2373
+ </refsection>
2374
+ </refentry>
2375
+
2376
+ <refentry version="5.0" xml:id="refentry.manual.fallback.profile">
2377
+ <refmeta>
2378
+ <refentrytitle>refentry.manual.fallback.profile</refentrytitle>
2379
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2380
+ </refmeta>
2381
+ <refnamediv>
2382
+ <refname>refentry.manual.fallback.profile</refname>
2383
+ <refpurpose>Specifies profile of "fallback" for refentry "manual" data</refpurpose>
2384
+ </refnamediv>
2385
+
2386
+ <refsynopsisdiv>
2387
+ <programlisting xml:id="refentry.manual.fallback.profile.frag">
2388
+ &lt;xsl:param name="refentry.manual.fallback.profile"&gt;
2389
+ refmeta/refmiscinfo[not(@class = 'date')][1]/node()&lt;/xsl:param&gt;
2390
+ </programlisting>
2391
+ </refsynopsisdiv>
2392
+
2393
+ <refsection><info><title>Description</title></info>
2394
+
2395
+ <para>The value of
2396
+ <parameter>refentry.manual.fallback.profile</parameter> is a string
2397
+ representing an XPath expression. It is evaluated at run-time and
2398
+ used only if no "manual" data can be found by other means (that is,
2399
+ either using the <tag>refentry</tag> metadata-gathering logic "hard
2400
+ coded" in the stylesheets, or the value of
2401
+ <parameter>refentry.manual.profile</parameter>, if it is
2402
+ enabled).</para>
2403
+
2404
+ <important>
2405
+ <para>Depending on which XSLT engine you run, either the EXSLT
2406
+ <function>dyn:evaluate</function> extension function (for xsltproc or
2407
+ Xalan) or <function>saxon:evaluate</function> extension function (for
2408
+ Saxon) are used to dynamically evaluate the value of
2409
+ <parameter>refentry.manual.fallback.profile</parameter> at
2410
+ run-time. If you don't use xsltproc, Saxon, Xalan -- or some other
2411
+ XSLT engine that supports <function>dyn:evaluate</function> -- you
2412
+ must manually disable fallback processing by setting an empty value
2413
+ for the <parameter>refentry.manual.fallback.profile</parameter>
2414
+ parameter.</para>
2415
+ </important>
2416
+
2417
+ </refsection>
2418
+ </refentry>
2419
+
2420
+ <refentry version="5.0" xml:id="refentry.source.fallback.profile">
2421
+ <refmeta>
2422
+ <refentrytitle>refentry.source.fallback.profile</refentrytitle>
2423
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2424
+ </refmeta>
2425
+ <refnamediv>
2426
+ <refname>refentry.source.fallback.profile</refname>
2427
+ <refpurpose>Specifies profile of "fallback" for refentry "source" data</refpurpose>
2428
+ </refnamediv>
2429
+
2430
+ <refsynopsisdiv>
2431
+ <programlisting xml:id="refentry.source.fallback.profile.frag">
2432
+ &lt;xsl:param name="refentry.source.fallback.profile"&gt;
2433
+ refmeta/refmiscinfo[not(@class = 'date')][1]/node()&lt;/xsl:param&gt;
2434
+ </programlisting>
2435
+ </refsynopsisdiv>
2436
+
2437
+ <refsection><info><title>Description</title></info>
2438
+
2439
+ <para>The value of
2440
+ <parameter>refentry.source.fallback.profile</parameter> is a string
2441
+ representing an XPath expression. It is evaluated at run-time and used
2442
+ only if no "source" data can be found by other means (that is, either
2443
+ using the <tag>refentry</tag> metadata-gathering logic "hard coded" in
2444
+ the stylesheets, or the value of the
2445
+ <parameter>refentry.source.name.profile</parameter> and
2446
+ <parameter>refentry.version.profile</parameter> parameters, if those
2447
+ are enabled).</para>
2448
+
2449
+ <important>
2450
+ <para>Depending on which XSLT engine you run, either the EXSLT
2451
+ <function>dyn:evaluate</function> extension function (for xsltproc or
2452
+ Xalan) or <function>saxon:evaluate</function> extension function (for
2453
+ Saxon) are used to dynamically evaluate the value of
2454
+ <parameter>refentry.source.fallback.profile</parameter> at
2455
+ run-time. If you don't use xsltproc, Saxon, Xalan -- or some other
2456
+ XSLT engine that supports <function>dyn:evaluate</function> -- you
2457
+ must manually disable fallback processing by setting an empty value
2458
+ for the <parameter>refentry.source.fallback.profile</parameter>
2459
+ parameter.</para>
2460
+ </important>
2461
+
2462
+ </refsection>
2463
+ </refentry>
2464
+
2465
+ </reference>
2466
+ <reference xml:id="th">
2467
+ <title>Page header/footer</title>
2468
+ <refentry version="5.0" xml:id="man.th.extra1.suppress">
2469
+ <refmeta>
2470
+ <refentrytitle>man.th.extra1.suppress</refentrytitle>
2471
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2472
+ </refmeta>
2473
+ <refnamediv>
2474
+ <refname>man.th.extra1.suppress</refname>
2475
+ <refpurpose>Suppress extra1 part of header/footer?</refpurpose>
2476
+ </refnamediv>
2477
+
2478
+ <refsynopsisdiv>
2479
+ <programlisting xml:id="man.th.extra1.suppress.frag">
2480
+ &lt;xsl:param name="man.th.extra1.suppress"&gt;0&lt;/xsl:param&gt;</programlisting>
2481
+ </refsynopsisdiv>
2482
+
2483
+ <refsection><info><title>Description</title></info>
2484
+
2485
+ <para>If the value of <parameter>man.th.extra1.suppress</parameter> is
2486
+ non-zero, then the <literal>extra1</literal> part of the
2487
+ <literal>.TH</literal> title line header/footer is suppressed.</para>
2488
+
2489
+ <para>The content of the <literal>extra1</literal> field is almost
2490
+ always displayed in the center footer of the page and is, universally,
2491
+ a date.</para>
2492
+
2493
+ </refsection>
2494
+ </refentry>
2495
+
2496
+ <refentry version="5.0" xml:id="man.th.extra2.suppress">
2497
+ <refmeta>
2498
+ <refentrytitle>man.th.extra2.suppress</refentrytitle>
2499
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2500
+ </refmeta>
2501
+ <refnamediv>
2502
+ <refname>man.th.extra2.suppress</refname>
2503
+ <refpurpose>Suppress extra2 part of header/footer?</refpurpose>
2504
+ </refnamediv>
2505
+
2506
+ <refsynopsisdiv>
2507
+ <programlisting xml:id="man.th.extra2.suppress.frag">
2508
+ &lt;xsl:param name="man.th.extra2.suppress"&gt;0&lt;/xsl:param&gt;</programlisting>
2509
+ </refsynopsisdiv>
2510
+
2511
+ <refsection><info><title>Description</title></info>
2512
+
2513
+ <para>If the value of <parameter>man.th.extra2.suppress</parameter> is
2514
+ non-zero, then the <literal>extra2</literal> part of the
2515
+ <literal>.TH</literal> title line header/footer is suppressed.</para>
2516
+
2517
+ <para>The content of the <literal>extra2</literal> field is usually
2518
+ displayed in the left footer of the page and is typically "source"
2519
+ data, often in the form
2520
+ <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>;
2521
+ for example, "GTK+ 1.2" (from the <literal>gtk-options(7)</literal>
2522
+ man page).</para>
2523
+
2524
+ <note>
2525
+ <para>You can use the
2526
+ <parameter>refentry.source.name.suppress</parameter> and
2527
+ <parameter>refentry.version.suppress</parameter> parameters to
2528
+ independently suppress the <replaceable>Name</replaceable> and
2529
+ <replaceable>Version</replaceable> parts of the
2530
+ <literal>extra2</literal> field.</para>
2531
+ </note>
2532
+
2533
+ </refsection>
2534
+ </refentry>
2535
+
2536
+ <refentry version="5.0" xml:id="man.th.extra3.suppress">
2537
+ <refmeta>
2538
+ <refentrytitle>man.th.extra3.suppress</refentrytitle>
2539
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2540
+ </refmeta>
2541
+ <refnamediv>
2542
+ <refname>man.th.extra3.suppress</refname>
2543
+ <refpurpose>Suppress extra3 part of header/footer?</refpurpose>
2544
+ </refnamediv>
2545
+
2546
+ <refsynopsisdiv>
2547
+ <programlisting xml:id="man.th.extra3.suppress.frag">
2548
+ &lt;xsl:param name="man.th.extra3.suppress"&gt;0&lt;/xsl:param&gt;</programlisting>
2549
+ </refsynopsisdiv>
2550
+
2551
+ <refsection><info><title>Description</title></info>
2552
+
2553
+ <para>If the value of <parameter>man.th.extra3.suppress</parameter> is
2554
+ non-zero, then the <literal>extra3</literal> part of the
2555
+ <literal>.TH</literal> title line header/footer is
2556
+ suppressed.</para>
2557
+
2558
+ <para>The content of the <literal>extra3</literal> field is usually
2559
+ displayed in the middle header of the page and is typically a "manual
2560
+ name"; for example, "GTK+ User's Manual" (from the
2561
+ <literal>gtk-options(7)</literal> man page).</para>
2562
+
2563
+ </refsection>
2564
+ </refentry>
2565
+
2566
+ <refentry version="5.0" xml:id="man.th.title.max.length">
2567
+ <refmeta>
2568
+ <refentrytitle>man.th.title.max.length</refentrytitle>
2569
+ <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2570
+ </refmeta>
2571
+ <refnamediv>
2572
+ <refname>man.th.title.max.length</refname>
2573
+ <refpurpose>Maximum length of title in header/footer</refpurpose>
2574
+ </refnamediv>
2575
+
2576
+ <refsynopsisdiv>
2577
+ <programlisting xml:id="man.th.title.max.length.frag">
2578
+ &lt;xsl:param name="man.th.title.max.length"&gt;20&lt;/xsl:param&gt;
2579
+ </programlisting>
2580
+ </refsynopsisdiv>
2581
+
2582
+ <refsection><info><title>Description</title></info>
2583
+
2584
+ <para>Specifies the maximum permitted length of the title part of the
2585
+ man-page <literal>.TH</literal> title line header/footer. If the title
2586
+ exceeds the maxiumum specified, it is truncated down to the maximum
2587
+ permitted length.</para>
2588
+
2589
+ <refsection><info><title>Details</title></info>
2590
+
2591
+
2592
+ <para>Every man page generated using the DocBook stylesheets has a
2593
+ title line, specified using the <literal>TH</literal> roff
2594
+ macro. Within that title line, there is always, at a minimum, a title,
2595
+ followed by a section value (representing a man "section" -- usually
2596
+ just a number).</para>
2597
+
2598
+ <para>The title and section are displayed, together, in the visible
2599
+ header of each page. Where in the header they are displayed depends on
2600
+ OS the man page is viewed on, and on what version of nroff/groff/man
2601
+ is used for viewing the page. But, at a minimum and across all
2602
+ systems, the title and section are displayed on the right-hand column
2603
+ of the header. On many systems -- those with a modern groff, including
2604
+ Linux systems -- they are displayed twice: both in the left and right
2605
+ columns of the header.</para>
2606
+
2607
+ <para>So if the length of the title exceeds a certain percentage of
2608
+ the column width in which the page is viewed, the left and right
2609
+ titles can end up overlapping, making them unreadable, or breaking to
2610
+ another line, which doesn't look particularly good.</para>
2611
+
2612
+ <para>So the stylesheets provide the
2613
+ <parameter>man.th.title.max.length</parameter> parameter as a means
2614
+ for truncating titles that exceed the maximum length that can be
2615
+ viewing properly in a page header.</para>
2616
+
2617
+ <para>The default value is reasonable but somewhat arbitrary. If you
2618
+ have pages with long titles, you may want to experiment with changing
2619
+ the value in order to achieve the correct aesthetic results.</para>
2620
+ </refsection>
2621
+
2622
+ </refsection>
2623
+ </refentry>
2624
+
2625
+ <refentry version="5.0" xml:id="man.th.extra2.max.length">
2626
+ <refmeta>
2627
+ <refentrytitle>man.th.extra2.max.length</refentrytitle>
2628
+ <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2629
+ </refmeta>
2630
+ <refnamediv>
2631
+ <refname>man.th.extra2.max.length</refname>
2632
+ <refpurpose>Maximum length of extra2 in header/footer</refpurpose>
2633
+ </refnamediv>
2634
+
2635
+ <refsynopsisdiv>
2636
+ <programlisting xml:id="man.th.extra2.max.length.frag">
2637
+ &lt;xsl:param name="man.th.extra2.max.length"&gt;30&lt;/xsl:param&gt;
2638
+ </programlisting>
2639
+ </refsynopsisdiv>
2640
+
2641
+ <refsection><info><title>Description</title></info>
2642
+
2643
+ <para>Specifies the maximum permitted length of the
2644
+ <literal>extra2</literal> part of the man-page part of the
2645
+ <literal>.TH</literal> title line header/footer. If the
2646
+ <literal>extra2</literal> content exceeds the maxiumum specified, it
2647
+ is truncated down to the maximum permitted length.</para>
2648
+
2649
+ <para>The content of the <literal>extra2</literal> field is usually
2650
+ displayed in the left footer of the page and is typically "source"
2651
+ data indicating the software system or product that the item
2652
+ documented in the man page belongs to, often in the form
2653
+ <replaceable>Name</replaceable>&#160;<replaceable>Version</replaceable>;
2654
+ for example, "GTK+ 1.2" (from the <literal>gtk-options(7)</literal>
2655
+ man page).</para>
2656
+
2657
+ <para>The default value for this parameter is reasonable but somewhat
2658
+ arbitrary. If you are processing pages with long "source" information,
2659
+ you may want to experiment with changing the value in order to achieve
2660
+ the correct aesthetic results.</para>
2661
+ </refsection>
2662
+ </refentry>
2663
+
2664
+ <refentry version="5.0" xml:id="man.th.extra3.max.length">
2665
+ <refmeta>
2666
+ <refentrytitle>man.th.extra3.max.length</refentrytitle>
2667
+ <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>
2668
+ </refmeta>
2669
+ <refnamediv>
2670
+ <refname>man.th.extra3.max.length</refname>
2671
+ <refpurpose>Maximum length of extra3 in header/footer</refpurpose>
2672
+ </refnamediv>
2673
+
2674
+ <refsynopsisdiv>
2675
+ <programlisting xml:id="man.th.extra3.max.length.frag">
2676
+ &lt;xsl:param name="man.th.extra3.max.length"&gt;30&lt;/xsl:param&gt;
2677
+ </programlisting>
2678
+ </refsynopsisdiv>
2679
+
2680
+ <refsection><info><title>Description</title></info>
2681
+
2682
+ <para>Specifies the maximum permitted length of the
2683
+ <literal>extra3</literal> part of the man-page <literal>.TH</literal>
2684
+ title line header/footer. If the <literal>extra3</literal> content
2685
+ exceeds the maxiumum specified, it is truncated down to the maximum
2686
+ permitted length.</para>
2687
+
2688
+ <para>The content of the <literal>extra3</literal> field is usually
2689
+ displayed in the middle header of the page and is typically a "manual
2690
+ name"; for example, "GTK+ User's Manual" (from the
2691
+ <literal>gtk-options(7)</literal> man page).</para>
2692
+
2693
+ <para>The default value for this parameter is reasonable but somewhat
2694
+ arbitrary. If you are processing pages with long "manual names" -- or
2695
+ especially if you are processing pages that have both long "title"
2696
+ parts (command/function, etc. names) <emphasis>and</emphasis> long
2697
+ manual names -- you may want to experiment with changing the value in
2698
+ order to achieve the correct aesthetic results.</para>
2699
+ </refsection>
2700
+ </refentry>
2701
+
2702
+ </reference>
2703
+ <reference xml:id="output">
2704
+ <title>Output</title>
2705
+ <refentry version="5.0" xml:id="man.output.manifest.enabled">
2706
+ <refmeta>
2707
+ <refentrytitle>man.output.manifest.enabled</refentrytitle>
2708
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2709
+ </refmeta>
2710
+ <refnamediv>
2711
+ <refname>man.output.manifest.enabled</refname>
2712
+ <refpurpose>Generate a manifest file?</refpurpose>
2713
+ </refnamediv>
2714
+
2715
+ <refsynopsisdiv>
2716
+ <programlisting xml:id="man.output.manifest.enabled.frag">&lt;xsl:param name="man.output.manifest.enabled" select="0"&gt;&lt;/xsl:param&gt;</programlisting>
2717
+ </refsynopsisdiv>
2718
+
2719
+ <refsection><info><title>Description</title></info>
2720
+
2721
+ <para>If non-zero, a list of filenames for man pages generated by
2722
+ the stylesheet transformation is written to the file named by the
2723
+ <parameter>man.output.manifest.filename</parameter> parameter.</para>
2724
+
2725
+ </refsection>
2726
+ </refentry>
2727
+
2728
+ <refentry version="5.0" xml:id="man.output.manifest.filename">
2729
+ <refmeta>
2730
+ <refentrytitle>man.output.manifest.filename</refentrytitle>
2731
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2732
+ </refmeta>
2733
+ <refnamediv>
2734
+ <refname>man.output.manifest.filename</refname>
2735
+ <refpurpose>Name of manifest file</refpurpose>
2736
+ </refnamediv>
2737
+
2738
+ <refsynopsisdiv>
2739
+ <programlisting xml:id="man.output.manifest.filename.frag">&lt;xsl:param name="man.output.manifest.filename"&gt;MAN.MANIFEST&lt;/xsl:param&gt;</programlisting>
2740
+ </refsynopsisdiv>
2741
+
2742
+ <refsection><info><title>Description</title></info>
2743
+
2744
+ <para>The <parameter>man.output.manifest.filename</parameter> parameter
2745
+ specifies the name of the file to which the manpages manifest file
2746
+ is written (if the value of the
2747
+ <parameter>man.output.manifest.enabled</parameter> parameter is
2748
+ non-zero).</para>
2749
+
2750
+ </refsection>
2751
+ </refentry>
2752
+
2753
+ <refentry version="5.0" xml:id="man.output.in.separate.dir">
2754
+ <refmeta>
2755
+ <refentrytitle>man.output.in.separate.dir</refentrytitle>
2756
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2757
+ </refmeta>
2758
+ <refnamediv>
2759
+ <refname>man.output.in.separate.dir</refname>
2760
+ <refpurpose>Output man-page files in separate output directory?</refpurpose>
2761
+ </refnamediv>
2762
+
2763
+ <refsynopsisdiv>
2764
+ <programlisting xml:id="man.output.in.separate.dir.frag">
2765
+ &lt;xsl:param name="man.output.in.separate.dir" select="0"&gt;&lt;/xsl:param&gt;
2766
+ </programlisting>
2767
+ </refsynopsisdiv>
2768
+
2769
+ <refsection><info><title>Description</title></info>
2770
+
2771
+ <para>If the value of <literal>man.output.in.separate.dir</literal>
2772
+ parameter is non-zero, man-page files are output in a separate
2773
+ directory, specified by the <parameter>man.output.base.dir</parameter>
2774
+ parameter; otherwise, if the value of
2775
+ <literal>man.output.in.separate.dir</literal> is zero, man-page files
2776
+ are not output in a separate directory.</para>
2777
+
2778
+ </refsection>
2779
+ </refentry>
2780
+
2781
+ <refentry version="5.0" xml:id="man.output.lang.in.name.enabled">
2782
+ <refmeta>
2783
+ <refentrytitle>man.output.lang.in.name.enabled</refentrytitle>
2784
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2785
+ </refmeta>
2786
+ <refnamediv>
2787
+ <refname>man.output.lang.in.name.enabled</refname>
2788
+ <refpurpose>Include $LANG value in man-page filename/pathname?</refpurpose>
2789
+ </refnamediv>
2790
+
2791
+ <refsynopsisdiv>
2792
+ <programlisting xml:id="man.output.lang.in.name.enabled.frag">
2793
+ &lt;xsl:param name="man.output.lang.in.name.enabled" select="0"&gt;&lt;/xsl:param&gt;
2794
+ </programlisting>
2795
+ </refsynopsisdiv>
2796
+
2797
+ <refsection><info><title>Description</title></info>
2798
+
2799
+ <para>The <parameter>man.output.lang.in.name.enabled</parameter>
2800
+ parameter specifies whether a <literal>$lang</literal> value is
2801
+ included in man-page filenames and pathnames.</para>
2802
+
2803
+ <para>If the value of
2804
+ <parameter>man.output.lang.in.name.enabled</parameter> is non-zero,
2805
+ man-page files are output with the <literal>$lang</literal> value
2806
+ included in their filenames or pathnames as follows;
2807
+
2808
+ <itemizedlist>
2809
+ <listitem>
2810
+ <para>if <parameter>man.output.subdirs.enabled</parameter> is
2811
+ non-zero, each file is output to, e.g., a
2812
+ <filename>man/<replaceable>$lang</replaceable>/man8/foo.8</filename>
2813
+ pathname</para>
2814
+ </listitem>
2815
+ <listitem>
2816
+ <para>if <parameter>man.output.subdirs.enabled</parameter> is
2817
+ zero, each file is output with a
2818
+ <literal>foo.<replaceable>$lang</replaceable>.8</literal>
2819
+ filename</para>
2820
+ </listitem>
2821
+ </itemizedlist>
2822
+ </para>
2823
+
2824
+ </refsection>
2825
+ </refentry>
2826
+
2827
+ <refentry version="5.0" xml:id="man.output.base.dir">
2828
+ <refmeta>
2829
+ <refentrytitle>man.output.base.dir</refentrytitle>
2830
+ <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>
2831
+ </refmeta>
2832
+ <refnamediv>
2833
+ <refname>man.output.base.dir</refname>
2834
+ <refpurpose>Specifies separate output directory</refpurpose>
2835
+ </refnamediv>
2836
+
2837
+ <refsynopsisdiv>
2838
+ <programlisting xml:id="man.output.base.dir.frag">&lt;xsl:param name="man.output.base.dir"&gt;man/&lt;/xsl:param&gt;</programlisting>
2839
+ </refsynopsisdiv>
2840
+
2841
+ <refsection><info><title>Description</title></info>
2842
+
2843
+ <para>The <parameter>man.output.base.dir</parameter> parameter
2844
+ specifies the base directory into which man-page files are output. The
2845
+ <parameter>man.output.subdirs.enabled</parameter> parameter controls
2846
+ whether the files are output in subdirectories within the base
2847
+ directory.</para>
2848
+
2849
+ <note>
2850
+ <para>The values of the <parameter>man.output.base.dir</parameter>
2851
+ and <parameter>man.output.subdirs.enabled</parameter> parameters are
2852
+ used only if the value of
2853
+ <parameter>man.output.in.separate.dir</parameter> parameter is
2854
+ non-zero. If the value of the
2855
+ <parameter>man.output.in.separate.dir</parameter> is zero, man-page
2856
+ files are not output in a separate directory.</para>
2857
+ </note>
2858
+
2859
+ </refsection>
2860
+ </refentry>
2861
+
2862
+ <refentry version="5.0" xml:id="man.output.subdirs.enabled">
2863
+ <refmeta>
2864
+ <refentrytitle>man.output.subdirs.enabled</refentrytitle>
2865
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2866
+ </refmeta>
2867
+ <refnamediv>
2868
+ <refname>man.output.subdirs.enabled</refname>
2869
+ <refpurpose>Output man-page files in subdirectories within base output directory?</refpurpose>
2870
+ </refnamediv>
2871
+
2872
+ <refsynopsisdiv>
2873
+ <programlisting xml:id="man.output.subdirs.enabled.frag">
2874
+ &lt;xsl:param name="man.output.subdirs.enabled" select="1"&gt;&lt;/xsl:param&gt;
2875
+ </programlisting>
2876
+ </refsynopsisdiv>
2877
+
2878
+ <refsection><info><title>Description</title></info>
2879
+
2880
+ <para>The <parameter>man.output.subdirs.enabled</parameter> parameter
2881
+ controls whether man-pages files are output in subdirectories within
2882
+ the base directory specified by the directory specified by the
2883
+ <parameter>man.output.base.dir</parameter> parameter.</para>
2884
+
2885
+ <note>
2886
+ <para>The values of the <parameter>man.output.base.dir</parameter>
2887
+ and <parameter>man.output.subdirs.enabled</parameter> parameters are
2888
+ used only if the value of
2889
+ <parameter>man.output.in.separate.dir</parameter> parameter is
2890
+ non-zero. If the value of the
2891
+ <parameter>man.output.in.separate.dir</parameter> is zero, man-page
2892
+ files are not output in a separate directory.</para>
2893
+ </note>
2894
+
2895
+ </refsection>
2896
+ </refentry>
2897
+
2898
+ <refentry version="5.0" xml:id="man.output.quietly">
2899
+ <refmeta>
2900
+ <refentrytitle>man.output.quietly</refentrytitle>
2901
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2902
+ </refmeta>
2903
+ <refnamediv>
2904
+ <refname>man.output.quietly</refname>
2905
+ <refpurpose>Suppress filename messages emitted when generating output?</refpurpose>
2906
+ </refnamediv>
2907
+
2908
+ <refsynopsisdiv>
2909
+ <programlisting xml:id="man.output.quietly.frag">
2910
+ &lt;xsl:param name="man.output.quietly" select="0"&gt;&lt;/xsl:param&gt;
2911
+ </programlisting>
2912
+ </refsynopsisdiv>
2913
+
2914
+ <refsection><info><title>Description</title></info>
2915
+
2916
+ <para>If zero (the default), for each man-page file created, a message
2917
+ with the name of the file is emitted. If non-zero, the files are
2918
+ output "quietly" -- that is, the filename messages are
2919
+ suppressed.</para>
2920
+
2921
+ <tip>
2922
+ <para>If you are processing a large amount of <tag>refentry</tag>
2923
+ content, you may be able to speed up processing significantly by
2924
+ setting a non-zero value for
2925
+ <parameter>man.output.quietly</parameter>.</para>
2926
+ </tip>
2927
+
2928
+ </refsection>
2929
+ </refentry>
2930
+
2931
+ <refentry version="5.0" xml:id="man.output.encoding">
2932
+ <refmeta>
2933
+ <refentrytitle>man.output.encoding</refentrytitle>
2934
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
2935
+ </refmeta>
2936
+ <refnamediv>
2937
+ <refname>man.output.encoding</refname>
2938
+ <refpurpose>Encoding used for man-page output</refpurpose>
2939
+ </refnamediv>
2940
+
2941
+ <refsynopsisdiv>
2942
+ <programlisting xml:id="man.output.encoding.frag">
2943
+ &lt;xsl:param name="man.output.encoding"&gt;UTF-8&lt;/xsl:param&gt;
2944
+ </programlisting>
2945
+ </refsynopsisdiv>
2946
+
2947
+ <refsection><info><title>Description</title></info>
2948
+
2949
+ <para>This parameter specifies the encoding to use for files generated
2950
+ by the manpages stylesheet. Not all processors support specification
2951
+ of this parameter.</para>
2952
+
2953
+ <important>
2954
+ <para>If the value of the <parameter>man.charmap.enabled</parameter>
2955
+ parameter is non-zero (the default), keeping the
2956
+ <parameter>man.output.encoding</parameter> parameter at its default
2957
+ value (<literal>UTF-8</literal>) or setting it to
2958
+ <literal>UTF-16</literal> <emphasis role="bold">does not cause your
2959
+ man pages to be output in raw UTF-8 or UTF-16</emphasis> -- because
2960
+ any Unicode characters for which matches are found in the enabled
2961
+ character map will be replaced with roff escape sequences before the
2962
+ final man-page files are generated.</para>
2963
+
2964
+ <para>So if you want to generate "real" UTF-8 man pages, without any
2965
+ character substitution being performed on your content, you need to
2966
+ set <parameter>man.charmap.enabled</parameter> to zero (which will
2967
+ completely disable character-map processing). </para>
2968
+
2969
+ <para>You may also need to set
2970
+ <parameter>man.charmap.enabled</parameter> to zero if you want to
2971
+ output man pages in an encoding other than <literal>UTF-8</literal>
2972
+ or <literal>UTF-16</literal>. Character-map processing is based on
2973
+ Unicode character values and may not work with other output
2974
+ encodings.</para>
2975
+ </important>
2976
+
2977
+ </refsection>
2978
+ </refentry>
2979
+
2980
+ <refentry version="5.0" xml:id="man.output.better.ps.enabled">
2981
+ <refmeta>
2982
+ <refentrytitle>man.output.better.ps.enabled</refentrytitle>
2983
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
2984
+ </refmeta>
2985
+ <refnamediv>
2986
+ <refname>man.output.better.ps.enabled</refname>
2987
+ <refpurpose>Enable enhanced print/PostScript output?</refpurpose>
2988
+ </refnamediv>
2989
+ <refsynopsisdiv>
2990
+ <programlisting xml:id="man.output.better.ps.enabled.frag">
2991
+ &lt;xsl:param name="man.output.better.ps.enabled"&gt;0&lt;/xsl:param&gt;
2992
+ </programlisting>
2993
+ </refsynopsisdiv>
2994
+ <refsection><info><title>Description</title></info>
2995
+
2996
+ <para>If the value of the
2997
+ <parameter>man.output.better.ps.enabled</parameter> parameter is
2998
+ non-zero, certain markup is embedded in each generated man page
2999
+ such that PostScript output from the <command>man -Tps</command>
3000
+ command for that page will include a number of enhancements
3001
+ designed to improve the quality of that output.</para>
3002
+
3003
+ <para>If <parameter>man.output.better.ps.enabled</parameter> is
3004
+ zero (the default), no such markup is embedded in generated man
3005
+ pages, and no enhancements are included in the PostScript
3006
+ output generated from those man pages by the <command>man
3007
+ -Tps</command> command.</para>
3008
+
3009
+ <warning>
3010
+ <para>The enhancements provided by this parameter rely on
3011
+ features that are specific to groff (GNU troff) and that are
3012
+ not part of &#8220;classic&#8221; AT&amp;T troff or any of its
3013
+ derivatives. Therefore, any man pages you generate with this
3014
+ parameter enabled will be readable only on systems on which
3015
+ the groff (GNU troff) program is installed, such as GNU/Linux
3016
+ systems. The pages <emphasis role="bold">will not not be
3017
+ readable on systems on with the classic troff (AT&amp;T
3018
+ troff) command is installed</emphasis>.</para>
3019
+ </warning>
3020
+
3021
+ <para>The value of this parameter only affects PostScript output
3022
+ generated from the <command>man</command> command. It has no
3023
+ effect on output generated using the FO backend.</para>
3024
+
3025
+ <tip>
3026
+ <para>You can generate PostScript output for any man page by
3027
+ running the following command:</para>
3028
+ <programlisting> man <replaceable>FOO</replaceable> -Tps &gt; <replaceable>FOO</replaceable>.ps</programlisting>
3029
+ <para>You can then generate PDF output by running the following
3030
+ command:</para>
3031
+ <programlisting> ps2pdf <replaceable>FOO</replaceable>.ps</programlisting>
3032
+ </tip>
3033
+
3034
+ </refsection>
3035
+ </refentry>
3036
+
3037
+ </reference>
3038
+ <reference xml:id="other">
3039
+ <title>Other</title>
3040
+ <refentry version="5.0" xml:id="man.table.footnotes.divider">
3041
+ <refmeta>
3042
+ <refentrytitle>man.table.footnotes.divider</refentrytitle>
3043
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3044
+ </refmeta>
3045
+ <refnamediv>
3046
+ <refname>man.table.footnotes.divider</refname>
3047
+ <refpurpose>Specifies divider string that appears before table footnotes</refpurpose>
3048
+ </refnamediv>
3049
+
3050
+ <refsynopsisdiv>
3051
+ <programlisting xml:id="man.table.footnotes.divider.frag">
3052
+ &lt;xsl:param name="man.table.footnotes.divider"&gt;----&lt;/xsl:param&gt;
3053
+ </programlisting>
3054
+ </refsynopsisdiv>
3055
+
3056
+ <refsection><info><title>Description</title></info>
3057
+
3058
+ <para>In each table that contains footenotes, the string specified by
3059
+ the <parameter>man.table.footnotes.divider</parameter> parameter is
3060
+ output before the list of footnotes for the table.</para>
3061
+
3062
+ </refsection>
3063
+ </refentry>
3064
+
3065
+ <refentry version="5.0" xml:id="man.subheading.divider.enabled">
3066
+ <refmeta>
3067
+ <refentrytitle>man.subheading.divider.enabled</refentrytitle>
3068
+ <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
3069
+ </refmeta>
3070
+ <refnamediv>
3071
+ <refname>man.subheading.divider.enabled</refname>
3072
+ <refpurpose>Add divider comment to roff source before/after subheadings?</refpurpose>
3073
+ </refnamediv>
3074
+
3075
+ <refsynopsisdiv>
3076
+ <programlisting xml:id="man.subheading.divider.enabled.frag">
3077
+ &lt;xsl:param name="man.subheading.divider.enabled"&gt;0&lt;/xsl:param&gt;
3078
+ </programlisting>
3079
+ </refsynopsisdiv>
3080
+
3081
+ <refsection><info><title>Description</title></info>
3082
+
3083
+ <para>If the value of the
3084
+ <parameter>man.subheading.divider.enabled</parameter> parameter is
3085
+ non-zero, the contents of the
3086
+ <parameter>man.subheading.divider</parameter> parameter are used to
3087
+ add a "divider" before and after subheadings in the roff
3088
+ output. <emphasis role="bold">The divider is not visisble in the
3089
+ rendered man page</emphasis>; it is added as a comment, in the source,
3090
+ simply for the purpose of increasing reability of the source.</para>
3091
+
3092
+ <para>If <parameter>man.subheading.divider.enabled</parameter> is zero
3093
+ (the default), the subheading divider is suppressed.</para>
3094
+
3095
+ </refsection>
3096
+ </refentry>
3097
+
3098
+ <refentry version="5.0" xml:id="man.subheading.divider">
3099
+ <refmeta>
3100
+ <refentrytitle>man.subheading.divider</refentrytitle>
3101
+ <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
3102
+ </refmeta>
3103
+ <refnamediv>
3104
+ <refname>man.subheading.divider</refname>
3105
+ <refpurpose>Specifies string to use as divider comment before/after subheadings</refpurpose>
3106
+ </refnamediv>
3107
+
3108
+ <refsynopsisdiv>
3109
+ <programlisting xml:id="man.subheading.divider.frag">
3110
+ &lt;xsl:param name="man.subheading.divider"&gt;========================================================================&lt;/xsl:param&gt;
3111
+ </programlisting>
3112
+ </refsynopsisdiv>
3113
+
3114
+ <refsection><info><title>Description</title></info>
3115
+
3116
+ <para>If the value of the
3117
+ <parameter>man.subheading.divider.enabled</parameter> parameter is
3118
+ non-zero, the contents of the
3119
+ <parameter>man.subheading.divider</parameter> parameter are used to
3120
+ add a "divider" before and after subheadings in the roff
3121
+ output. <emphasis role="bold">The divider is not visisble in the
3122
+ rendered man page</emphasis>; it is added as a comment, in the source,
3123
+ simply for the purpose of increasing reability of the source.</para>
3124
+
3125
+ <para>If <parameter>man.subheading.divider.enabled</parameter> is zero
3126
+ (the default), the subheading divider is suppressed.</para>
3127
+
3128
+ </refsection>
3129
+ </refentry>
3130
+
3131
+ </reference>
3132
+ <appendix xml:id="stylesheet">
3133
+ <title>The Stylesheet</title>
3134
+
3135
+ <para>The <filename>param.xsl</filename> stylesheet is just a
3136
+ wrapper around all of these parameters.</para>
3137
+
3138
+ <programlisting xml:id="top">
3139
+ &lt;xsl:stylesheet exclude-result-prefixes="src" version="1.0"&gt;
3140
+
3141
+ &lt;!-- This file is generated from param.xweb --&gt;
3142
+
3143
+ &lt;!-- ********************************************************************
3144
+ $Id: param.xweb 8235 2009-02-09 16:22:14Z xmldoc $
3145
+ ********************************************************************
3146
+
3147
+ This file is part of the XSL DocBook Stylesheet distribution.
3148
+ See ../README or http://docbook.sf.net/release/xsl/current/ for
3149
+ copyright and other information.
3150
+
3151
+ ******************************************************************** --&gt;
3152
+
3153
+ &lt;src:fragref linkend="man.authors.section.enabled.frag"&gt;&lt;/src:fragref&gt;
3154
+ &lt;src:fragref linkend="man.break.after.slash.frag"&gt;&lt;/src:fragref&gt;
3155
+ &lt;src:fragref linkend="man.base.url.for.relative.links.frag"&gt;&lt;/src:fragref&gt;
3156
+ &lt;src:fragref linkend="man.charmap.enabled.frag"&gt;&lt;/src:fragref&gt;
3157
+ &lt;src:fragref linkend="man.charmap.subset.profile.frag"&gt;&lt;/src:fragref&gt;
3158
+ &lt;src:fragref linkend="man.charmap.subset.profile.english.frag"&gt;&lt;/src:fragref&gt;
3159
+ &lt;src:fragref linkend="man.charmap.uri.frag"&gt;&lt;/src:fragref&gt;
3160
+ &lt;src:fragref linkend="man.charmap.use.subset.frag"&gt;&lt;/src:fragref&gt;
3161
+ &lt;src:fragref linkend="man.copyright.section.enabled.frag"&gt;&lt;/src:fragref&gt;
3162
+ &lt;src:fragref linkend="man.endnotes.are.numbered.frag"&gt;&lt;/src:fragref&gt;
3163
+ &lt;src:fragref linkend="man.endnotes.list.enabled.frag"&gt;&lt;/src:fragref&gt;
3164
+ &lt;src:fragref linkend="man.endnotes.list.heading.frag"&gt;&lt;/src:fragref&gt;
3165
+ &lt;src:fragref linkend="man.font.funcprototype.frag"&gt;&lt;/src:fragref&gt;
3166
+ &lt;src:fragref linkend="man.font.funcsynopsisinfo.frag"&gt;&lt;/src:fragref&gt;
3167
+ &lt;src:fragref linkend="man.font.links.frag"&gt;&lt;/src:fragref&gt;
3168
+ &lt;src:fragref linkend="man.font.table.headings.frag"&gt;&lt;/src:fragref&gt;
3169
+ &lt;src:fragref linkend="man.font.table.title.frag"&gt;&lt;/src:fragref&gt;
3170
+ &lt;src:fragref linkend="man.funcsynopsis.style.frag"&gt;&lt;/src:fragref&gt;
3171
+ &lt;src:fragref linkend="man.hyphenate.computer.inlines.frag"&gt;&lt;/src:fragref&gt;
3172
+ &lt;src:fragref linkend="man.hyphenate.filenames.frag"&gt;&lt;/src:fragref&gt;
3173
+ &lt;src:fragref linkend="man.hyphenate.frag"&gt;&lt;/src:fragref&gt;
3174
+ &lt;src:fragref linkend="man.hyphenate.urls.frag"&gt;&lt;/src:fragref&gt;
3175
+ &lt;src:fragref linkend="man.indent.blurbs.frag"&gt;&lt;/src:fragref&gt;
3176
+ &lt;src:fragref linkend="man.indent.lists.frag"&gt;&lt;/src:fragref&gt;
3177
+ &lt;src:fragref linkend="man.indent.refsect.frag"&gt;&lt;/src:fragref&gt;
3178
+ &lt;src:fragref linkend="man.indent.verbatims.frag"&gt;&lt;/src:fragref&gt;
3179
+ &lt;src:fragref linkend="man.indent.width.frag"&gt;&lt;/src:fragref&gt;
3180
+ &lt;src:fragref linkend="man.justify.frag"&gt;&lt;/src:fragref&gt;
3181
+ &lt;src:fragref linkend="man.output.base.dir.frag"&gt;&lt;/src:fragref&gt;
3182
+ &lt;src:fragref linkend="man.output.encoding.frag"&gt;&lt;/src:fragref&gt;
3183
+ &lt;src:fragref linkend="man.output.in.separate.dir.frag"&gt;&lt;/src:fragref&gt;
3184
+ &lt;src:fragref linkend="man.output.lang.in.name.enabled.frag"&gt;&lt;/src:fragref&gt;
3185
+ &lt;src:fragref linkend="man.output.manifest.enabled.frag"&gt;&lt;/src:fragref&gt;
3186
+ &lt;src:fragref linkend="man.output.manifest.filename.frag"&gt;&lt;/src:fragref&gt;
3187
+ &lt;src:fragref linkend="man.output.better.ps.enabled.frag"&gt;&lt;/src:fragref&gt;
3188
+ &lt;src:fragref linkend="man.output.quietly.frag"&gt;&lt;/src:fragref&gt;
3189
+ &lt;src:fragref linkend="man.output.subdirs.enabled.frag"&gt;&lt;/src:fragref&gt;
3190
+ &lt;src:fragref linkend="man.segtitle.suppress.frag"&gt;&lt;/src:fragref&gt;
3191
+ &lt;src:fragref linkend="man.string.subst.map.frag"&gt;&lt;/src:fragref&gt;
3192
+ &lt;src:fragref linkend="man.string.subst.map.local.post.frag"&gt;&lt;/src:fragref&gt;
3193
+ &lt;src:fragref linkend="man.string.subst.map.local.pre.frag"&gt;&lt;/src:fragref&gt;
3194
+ &lt;src:fragref linkend="man.subheading.divider.enabled.frag"&gt;&lt;/src:fragref&gt;
3195
+ &lt;src:fragref linkend="man.subheading.divider.frag"&gt;&lt;/src:fragref&gt;
3196
+ &lt;src:fragref linkend="man.table.footnotes.divider.frag"&gt;&lt;/src:fragref&gt;
3197
+ &lt;src:fragref linkend="man.th.extra1.suppress.frag"&gt;&lt;/src:fragref&gt;
3198
+ &lt;src:fragref linkend="man.th.extra2.max.length.frag"&gt;&lt;/src:fragref&gt;
3199
+ &lt;src:fragref linkend="man.th.extra2.suppress.frag"&gt;&lt;/src:fragref&gt;
3200
+ &lt;src:fragref linkend="man.th.extra3.max.length.frag"&gt;&lt;/src:fragref&gt;
3201
+ &lt;src:fragref linkend="man.th.extra3.suppress.frag"&gt;&lt;/src:fragref&gt;
3202
+ &lt;src:fragref linkend="man.th.title.max.length.frag"&gt;&lt;/src:fragref&gt;
3203
+ &lt;src:fragref linkend="refentry.date.profile.enabled.frag"&gt;&lt;/src:fragref&gt;
3204
+ &lt;src:fragref linkend="refentry.date.profile.frag"&gt;&lt;/src:fragref&gt;
3205
+ &lt;src:fragref linkend="refentry.manual.fallback.profile.frag"&gt;&lt;/src:fragref&gt;
3206
+ &lt;src:fragref linkend="refentry.manual.profile.enabled.frag"&gt;&lt;/src:fragref&gt;
3207
+ &lt;src:fragref linkend="refentry.manual.profile.frag"&gt;&lt;/src:fragref&gt;
3208
+ &lt;src:fragref linkend="refentry.meta.get.quietly.frag"&gt;&lt;/src:fragref&gt;
3209
+ &lt;src:fragref linkend="refentry.source.fallback.profile.frag"&gt;&lt;/src:fragref&gt;
3210
+ &lt;src:fragref linkend="refentry.source.name.profile.enabled.frag"&gt;&lt;/src:fragref&gt;
3211
+ &lt;src:fragref linkend="refentry.source.name.profile.frag"&gt;&lt;/src:fragref&gt;
3212
+ &lt;src:fragref linkend="refentry.source.name.suppress.frag"&gt;&lt;/src:fragref&gt;
3213
+ &lt;src:fragref linkend="refentry.version.profile.enabled.frag"&gt;&lt;/src:fragref&gt;
3214
+ &lt;src:fragref linkend="refentry.version.profile.frag"&gt;&lt;/src:fragref&gt;
3215
+ &lt;src:fragref linkend="refentry.version.suppress.frag"&gt;&lt;/src:fragref&gt;
3216
+ &lt;/xsl:stylesheet&gt;
3217
+ </programlisting>
3218
+
3219
+ </appendix>
3220
+ </book>