Warning, /plasma/kwin/doc/kwindecoration/index.docbook is written in an unsupported language. File is not indexed.

 <?xml version="1.0" ?>
 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
 "dtd/kdedbx45.dtd" [
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
 ]>
 
 <article id="kwindecoration" lang="&language;">
 <articleinfo>
 <authorgroup>
 <author>&Rik.Hemsley; &Rik.Hemsley.mail;</author>
 <author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <date>2021-04-09</date>
 <releaseinfo>Plasma 5.21</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>Systemsettings</keyword>
 <keyword>kwin</keyword>
 <keyword>window</keyword>
 <keyword>border</keyword>
 <keyword>theme</keyword>
 <keyword>style</keyword>
 </keywordset>
 </articleinfo>
 <sect1 id="window-deco">
 <title>Window Decorations</title>
 
 <para>This module allows you to select a style for the buttons and borders around
 the windows.</para>
 
 <sect2>
 <title>Window Decorations</title>
 
 <para>
 <screenshot>
 <screeninfo>Window Decoration Configuration Module</screeninfo>
   <mediaobject>
     <imageobject>
       <imagedata fileref="main.png" format="PNG"/>
     </imageobject>
     <textobject>
       <phrase>Window Decoration Configuration Module</phrase>
     </textobject>
   </mediaobject>
 </screenshot>
 </para>
 
 <para>Choose a window decoration style from the preview list, using the 
 search field at the top of the screen or download a new style using the 
 <guibutton>Get New Window Decorations</guibutton> button.</para>
 
 <para>The default window decoration is called <quote>Breeze</quote>.</para>
 
 <para>Each style has a different look, but also a different
 <quote>feel</quote>. Some have (sometimes invisible)
 <quote>resize</quote> borders all around the edge, which make resizing
 easier but moving more difficult. Some have no borders on certain
 edges.</para>
 
 <para>You are encouraged to experiment with the different styles until
 you find one which best suits your pattern of work.</para>
 
 <para>In the preview of each style you find a <inlinemediaobject><imageobject>
 <imagedata fileref="configure.png" format="PNG"/></imageobject></inlinemediaobject> 
 configure button to open configuration dialogs for the decoration.</para>
 
 <para>The options in this configuration dialog are applied to all windows. 
 Some window decorations (&eg; <quote>Breeze</quote>)
 provide a <guilabel>Window-Specific Overrides</guilabel> tab.
 On this tab you can change the border size and the visibility 
 of the window titlebar for particular windows.</para>
 
 <para>Different options for particular windows you find in the &systemsettings;
 module <ulink url="help:/kcontrol/windowspecific">Window Rules</ulink>.
 </para>
 
 <tip>
 <para>For accessibility purposes, some window decorations support
 extra wide borders.  If this is available, you can also choose a
 <guilabel>Window border size</guilabel> here.  The large borders are easier to see for low
 vision users, and easier to grab for people with limited mobility or
 difficulty using a mouse.</para>
 </tip>
 
 </sect2>
 
 <sect2>
 <title>Decorations</title>
 
 <para>In this dialog you can change the decoration of the window. 
 
 The available options depend on the selected style.
 </para>
 <para>
 <screenshot>
 <screeninfo>Breeze Decoration Options</screeninfo>
   <mediaobject>
     <imageobject>
       <imagedata fileref="decoration.png" format="PNG"/>
     </imageobject>
     <textobject>
       <phrase>Breeze Decoration Options</phrase>
     </textobject>
   </mediaobject>
 </screenshot>
 </para>
 </sect2>
 
 <sect2>
 <title>Titlebar Buttons</title>
 
 <para>This tab allows you to customize the button location on the titlebar. 
 You can drag buttons &eg; the <guilabel>Application menu</guilabel> into the 
 titlebar, remove them or drag around the
 buttons until you have the order that makes you comfortable.
 </para>
 
 <screenshot>
 <screeninfo>Button Options</screeninfo>
   <mediaobject>
     <imageobject>
       <imagedata fileref="button.png" format="PNG"/>
     </imageobject>
     <textobject>
       <phrase>Button Options</phrase>
     </textobject>
   </mediaobject>
 </screenshot>
 
 <para>Enable <guilabel>Close windows by double clicking the menu button</guilabel>
 to have an additional option to the Close button or if you have removed the Close button from the titlebar.
 </para>
 
 <para>Check the <guilabel>Show titlebar buttons tooltips</guilabel> item if you
 want to see the default tooltips when you hover the titlebar buttons with the mouse pointer.
 </para>
 
 </sect2>
 
 </sect1>
 
 </article>