[XXE] Command emphasis

[Hussein Shafie]

Chris Taylor wrote:
> One thing my boss does not like is that the 'convert to emphasis' pulldown
> does not include some options we use. These currently are 'command' and
> 'commandsynopsis' though there may be more. Is there another place to get
> them apart from the 'a' pulldown?

--> When an element is not found in the "a" pulldown, you normally need 
to use the ``standard procedure'' (which is quicker than selecting an 
item from a pulldown using the mouse):

[1] Select some text by dragging your mouse over it.
[2] Use Edit|Convert. Shortcut is: Ctrl-T (*T* like *T*ransform).
[3] Select the element from the list by typing the name of the element 
to make use of the autocompletion.
[4] Press Enter as soon as the element of choice is selected.

--> You may customize the items of the "a" pulldown. But in principle, 
the end user is not supposed to do this.

* The clean and maintainable method is explained here: 
http://www.xmlmind.com/xmleditor/_distrib/doc/configure/customizing.html

* The quick and dirty method consists in directly editing
XXE_install_dir/addon/config/docbook/toolBar.incl

---
   <toolBar>
     <button toolTip="Convert to emphasis"
             icon="../common/icons2/emphasis_menu.gif">
       <menu>
         <item label="emphasis"
               command="convert"
               parameter="[implicitElement] emphasis" />
         <item label="emphasis[bold]"
               command="docb.convertWithAttribute"
               parameter="emphasis role bold" />
        <item label="firstterm" command="convert"
              parameter="[implicitElement] firstterm" />
         <item label="replaceable" command="convert"
               parameter="[implicitElement] replaceable" />
         <separator />
         <item label="literal" command="convert"
               parameter="[implicitElement] literal" />
        <item label="filename" command="convert"
              parameter="[implicitElement] filename" />
         <separator />
---

Suffice to remove what you don't need and to add more <separator/>s 
and/or <item/>s.

Example:
---
   <item label="literal" command="convert"
         parameter="[implicitElement] command" />
---

---
PS: Unlike command, cmdsynopsis is a container block and therefore 
should not be added to the "a" pulldown.