From f1798258a0e9229335dd83d8a8e768107661f7c6 Mon Sep 17 00:00:00 2001
From: John Fieber <jfieber@FreeBSD.org>
Date: Sat, 18 Jan 1997 02:31:36 +0000
Subject: [PATCH] 1) Start making tweaks for new things in Docbook 3.0 2)
 Handle <keycombo> more or less correctly 3) Start dealing with <cmdsynopsis>
 (it is pretty ugly!) 4) Handle titles and attributions in blockquote. 5)
 Handle <accel> (accelerator keys in <guimenu> and friends) 6) Probably some
 other things...

---
 share/sgml/transpec/docbook-html.ts | 191 +++++++++++++++++++++++++++-
 1 file changed, 187 insertions(+), 4 deletions(-)

diff --git a/share/sgml/transpec/docbook-html.ts b/share/sgml/transpec/docbook-html.ts
index 73e21988bef..07bc30d03e3 100644
--- a/share/sgml/transpec/docbook-html.ts
+++ b/share/sgml/transpec/docbook-html.ts
@@ -1,6 +1,6 @@
 <!--
 
-  $FreeBSD$
+  $Id: docbook-html.ts,v 1.2 1996/12/17 01:48:30 jfieber Exp $
 
   Copyright (C) 1997
        John R. Fieber.  All rights reserved.
@@ -78,6 +78,9 @@ ${_action &r.blkpe;t}</end>'>
 <!ENTITY m.b '<start>&lt;B></start>
 <end>&lt;/B></end>'>
 
+<!ENTITY m.u '<start>&lt;U></start>
+<end>&lt;/U></end>'>
+
 <!-- Rule names (instant(1) only allows cryptic numbers). -->
 
 <!ENTITY r.pass "1">
@@ -105,6 +108,9 @@ ${_action &r.blkpe;t}</end>'>
 <!ENTITY r.blkps "50">
 <!ENTITY r.blkpe "51">
 
+<!ENTITY r.hyphen "60">
+<!ENTITY r.nl "61">
+
 <!ENTITY cmap SYSTEM "/usr/share/sgml/transpec/html.cmap">
 <!ENTITY sdata SYSTEM "/usr/share/sgml/transpec/html.sdata">
 
@@ -161,20 +167,31 @@ ${_action &r.blkpe;t}</end>'>
 <rule> <!-- Keycap used with a meta key to activate a graphical user interface -->
 <match>
 <gi>ACCEL
+<action>
+&m.u;
 </rule>
 
 <rule> <!-- Acknowledgements in an Article -->
 <match>
 <gi>ACKNO
+<action>
+<start>^&lt;P></start>
+<end>&lt;/P>^</end>
 </rule>
 
 <rule> <!-- Pronounceable contraction of initials -->
 <match>
 <gi>ACRONYM
+<content>^[^a-z]*$</content>
 <action>
 <replace>&lt;SMALL>${_! echo "${+content}" | tr "[:lower:]" "[:upper:]"}&lt;/SMALL></replace>
 </rule>
 
+<rule> <!-- Pronounceable contraction of initials -->
+<match>
+<gi>ACRONYM
+</rule>
+
 <rule> <!-- Function invoked in response to a user event -->
 <match>
 <gi>ACTION
@@ -183,6 +200,11 @@ ${_action &r.blkpe;t}</end>'>
 <rule> <!-- Real-world address -->
 <match>
 <gi>ADDRESS
+<action>
+<start>${_action &r.blkps;t}
+&lt;P></start>
+<end>&lt;/P>
+${_action &r.blkpe;t}</end>
 </rule>
 
 <rule> <!-- Author's institutional affiliation -->
@@ -192,6 +214,13 @@ ${_action &r.blkpe;t}</end>'>
 <start>&lt;BR></start>
 </rule>
 
+<rule> <!-- Prose explanation of a nonprose element -->
+<match>
+<gi>ALT
+<action>
+&m.i;
+</rule>
+
 <rule> <!-- Spot in text -->
 <match>
 <gi>ANCHOR
@@ -235,6 +264,56 @@ ${_followrel child TITLE &r.pass;} -->^</start>
 <rule> <!-- Argument in a CmdSynopsis -->
 <match>
 <gi>ARG
+<attval>CHOICE OPT
+<attval>REP NOREPEAT
+<action>
+<start>^[</start>
+<end>]^</end>
+</rule>
+
+<rule> <!-- Argument in a CmdSynopsis -->
+<match>
+<gi>ARG
+<attval>CHOICE OPT
+<action>
+<start>^[</start>
+<end>&amp;nbsp;...&amp;nbsp;]^</end>
+</rule>
+
+<rule> <!-- Argument in a CmdSynopsis -->
+<match>
+<gi>ARG
+<attval>CHOICE REQ
+<attval>REP NOREPEAT
+<action>
+<start>^{</start>
+<end>}^</end>
+</rule>
+
+<rule> <!-- Argument in a CmdSynopsis -->
+<match>
+<gi>ARG
+<attval>CHOICE REQ
+<action>
+<start>^{</start>
+<end>&amp;nbsp;...&amp;nbsp;}^</end>
+</rule>
+
+<rule> <!-- Argument in a CmdSynopsis -->
+<match>
+<gi>ARG
+<attval>REP REPEAT
+<action>
+<start>^</start>
+<end>&amp;nbsp;...^</end>
+</rule>
+
+<rule> <!-- Argument in a CmdSynopsis -->
+<match>
+<gi>ARG
+<action>
+<start>^</start>
+<end>^</end>
 </rule>
 
 <rule> <!-- Metainformation for an Article -->
@@ -242,7 +321,7 @@ ${_followrel child TITLE &r.pass;} -->^</start>
 <gi>ARTHEADER
 </rule>
 
-<rule> <!-- Article -->
+<rule> <!-- Article --> 
 <match>
 <gi>ARTICLE
 </rule>
@@ -252,6 +331,13 @@ ${_followrel child TITLE &r.pass;} -->^</start>
 <gi>ARTPAGENUMS
 </rule>
 
+<rule> <!-- Attribution of content for a BlockQuote or Epigraph -->
+<match>
+<gi>ATTRIBUTION
+<action>
+<ignore>all
+</rule>
+
 <rule> <!-- Author of a document -->
 <match>
 <gi>AUTHOR
@@ -300,6 +386,34 @@ ${_followrel child TITLE &r.pass;} -->^</start>
 <gi>BIBLIOMISC
 </rule>
 
+<rule> <!-- Entry in a Bibliography -->
+<match>
+<gi>BIBLIOMIXED
+</rule>
+
+<rule> <!-- Container for related bibliographic information -->
+<match>
+<gi>BIBLIOMSET
+</rule>
+
+<rule> <!-- Container for related bibliographic information -->
+<match>
+<gi>BIBLIOSET
+</rule>
+
+<rule> <!-- Quotation set off from the main text, rather than occurring in-line -->
+<match>
+<gi>BLOCKQUOTE
+<relation>child ATTRIBUTION
+<action>
+<start>${_action &r.blkps;t}
+${_action &r.anchor;t}&lt;BLOCKQUOTE></start>
+<end>&lt;P ALIGN=RIGHT>&lt;I>--
+${_followrel child ATTRIBUTION &r.pass;}&lt;/I>&lt;/P>
+&lt;/BLOCKQUOTE>
+${_action &r.blkpe;t}</end>
+</rule>
+
 <rule> <!-- Quotation set off from the main text, rather than occurring in-line -->
 <match>
 <gi>BLOCKQUOTE
@@ -742,8 +856,7 @@ ${_action &r.blkpe;t}</end>
 <match>
 <gi>FOREIGNPHRASE
 <action>
-<start>&lt;EM></start>
-<end>&lt;/EM></end>
+&m.i;
 </rule>
 
 <rule> <!-- Paragraph with a Title -->
@@ -1028,23 +1141,58 @@ ${_action &r.blkpe;t}</end>
             necessarily the same thing as a KeyCode -->
 <match>
 <gi>KEYCAP
+<relation>parent KEYCOMBO
+<action>
+<end>${_relation sibling+1 KEYCAP &r.hyphen;}${_relation sibling+1 KEYSYM &r.hyphen;}${_relation sibling+1 MOUSEBUTTON &r.hyphen;}${_relation sibling+1 KEYCOMBO &r.nl;}</end>
+</rule>
+
+<rule> <!-- Text printed on a physical key on a computer keyboard, not
+            necessarily the same thing as a KeyCode -->
+<match>
+<gi>KEYCAP
+<action>
+&m.tt;
 </rule>
 
 <rule> <!-- Computer's numeric designation of a key on a computer
             keyboard -->
 <match>
 <gi>KEYCODE
+<action>
+&m.tt;
 </rule>
 
 <rule> <!-- Combination of input actions -->
 <match>
 <gi>KEYCOMBO
+<relation>parent KEYCOMBO
+<relation>sibling+1 KEYCOMBO
+<action>
+<end>^</end>
+</rule>
+
+<rule> <!-- Combination of input actions -->
+<match>
+<gi>KEYCOMBO
+<action>
+&m.tt;
 </rule>
 
 <rule> <!-- Key symbol name, which is not necessarily the same thing as a
             Keycap -->
 <match>
 <gi>KEYSYM
+<relation>parent KEYCOMBO
+<action>
+<end>${_relation sibling+1 KEYCAP &r.hyphen;}${_relation sibling+1 KEYSYM &r.hyphen;}${_relation sibling+1 MOUSEBUTTON &r.hyphen;}${_relation sibling+1 KEYCOMBO &r.nl;}</end>
+</rule>
+
+<rule> <!-- Key symbol name, which is not necessarily the same thing as a
+            Keycap -->
+<match>
+<gi>KEYSYM
+<action>
+&m.tt;
 </rule>
 
 <rule> <!-- Statement of legal obligations or requirements -->
@@ -1181,6 +1329,16 @@ ${_action &r.blkpe;t}</end>
 <rule> <!-- Conventional name of a mouse button -->
 <match>
 <gi>MOUSEBUTTON
+<relation>parent KEYCOMBO
+<action>
+<end>${_relation sibling+1 KEYCAP &r.hyphen;}${_relation sibling+1 KEYSYM &r.hyphen;}${_relation sibling+1 MOUSEBUTTON &r.hyphen;}${_relation sibling+1 KEYCOMBO &r.nl;}</end>
+</rule>
+
+<rule> <!-- Conventional name of a mouse button -->
+<match>
+<gi>MOUSEBUTTON
+<action>
+&m.tt;
 </rule>
 
 <rule> <!-- Error message and its subparts, along with explanatory text, in a
@@ -2085,6 +2243,15 @@ with its
 <do>&r.admon;
 </rule>
 
+<rule> <!-- Text of a heading or the title of a block-oriented element -->
+<match>
+<gi>TITLE
+<relation>parent BLOCKQUOTE
+<action>
+<start>^&lt;H4>&hlofont;</start>
+<end>&hlcfont;&lt;/H4>^</end>
+</rule>
+
 <!-- Titles in the preface -->
 
 <rule> <!-- Text of a heading or the title of a block-oriented element -->
@@ -2621,4 +2788,20 @@ ${_find top gi FOOTNOTE &r.fnotei;}
 <replace>^&lt;P></replace>
 </rule>
 
+<!-- Simply output a hyphen -->
+<rule id="&r.hyphen;">
+<match>
+<gi>_hyphen
+<action>
+<replace>-</replace>
+</rule>
+
+<!-- Force a linebreak -->
+<rule id="&r.nl;">
+<match>
+<gi>_hyphen
+<action>
+<replace>^</replace>
+</rule>
+
 </transpec>