<html dir="ltr"><head></head><body style="text-align:left; direction:ltr;"><div>Thank you for the guidance Yuri. I found the repo, have the XML checker and HTML generator running, and am learning the documentation markup. I'll submit a merge request in the next few days. Thank you for the help!</div><div><br></div><div>-Pete</div><div><br></div><pre>------------------------------</pre><pre><br></pre><pre>Message: 6</pre><pre>Date: Wed, 23 Dec 2020 09:10:44 +0200</pre><pre>From: Yuri Chornoivan <</pre><a href="mailto:yurchor@ukr.net"><pre>yurchor@ukr.net</pre></a><pre>></pre><pre>To: For people writing documentation for KDE <</pre><a href="mailto:kde-doc-english@kde.org"><pre>kde-doc-english@kde.org</pre></a><pre>></pre><pre>Subject: Re: Task Switcher doc update</pre><pre>Message-ID: <</pre><a href="mailto:4182827.oiOCzB1nmG@localhost.localdomain"><pre>4182827.oiOCzB1nmG@localhost.localdomain</pre></a><pre>></pre><pre>Content-Type: text/plain; charset="UTF-8"</pre><pre><br></pre><pre>середа, 23 грудня 2020 р. 05:43:59 EET Peter Wilding написано:</pre><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><pre>Hello, this is my first attempt at contributing to the documentation, so</pre><pre>please redirect me as needed.</pre></blockquote><pre><br></pre><pre>Hi,</pre><pre><br></pre><pre>Yes, this is the right place. :)</pre><pre><br></pre><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><pre>According to the documentation on how to</pre><pre>contribute documentation, the easiest way to get started is to send a</pre><pre>plaintext update to this list, so that's what I'm doing! I would be</pre><pre>happy to contribute directly via git, but I could use some help finding</pre><pre>the repo that contains this particular set of documentation.</pre></blockquote><pre><br></pre><pre>It is here.</pre><pre><br></pre><a href="https://invent.kde.org/plasma/kwin/-/blob/master/doc/kwintabbox/index.docbook"><pre>https://invent.kde.org/plasma/kwin/-/blob/master/doc/kwintabbox/index.docbook</pre></a><pre><br></pre><pre><br></pre><pre>Actually, you can edit it just in place then create a merge request.</pre><pre><br></pre><pre>Just if you want to do it by yourself,</pre><pre><br></pre><pre>1. Register on gitlab (the "Sign in" button in the top right corner of the </pre><pre>page).</pre><pre>2. Click on the "Edit" button and create your own fork of the repo.</pre><pre>3. Implement your vision of the manual.</pre><pre>4. Create a merge request with some appropriate title.</pre><pre> </pre><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><pre>For the Task Switcher (System Settings -> Task Switcher), I found the</pre><pre>existing documentation to be a bit sparse. After a lot of trial and</pre><pre>error I have a pretty good understanding of how all the Task Switcher</pre><pre>settings work, and so I wrote up new documentation to reflect this</pre><pre>information. </pre></blockquote><pre><br></pre><pre>Many thanks for your work.</pre><pre><br></pre><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><pre>The new text is below -- please let me know what next</pre><pre>steps would be.</pre></blockquote><pre><br></pre><pre>It depends on what is the best way for you.</pre><pre><br></pre><pre>1. I can create a merge request for your work.</pre><pre><br></pre><pre>2. You can adopt the docs yourself and create a merge request to discuss </pre><pre>(please remove the second "way" in "way way" then).</pre><pre><br></pre><pre>So what is your choice? ;)</pre><pre><br></pre><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><pre>Thank you all!</pre><pre><br></pre><pre>-Pete</pre></blockquote><pre><br></pre><pre>Thanks again for your contribution, best regards and Merry Christmas,</pre><pre>Yuri</pre><pre><br></pre><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><pre>---------------------</pre><pre>The Task Switcher allows the user to easily switch between currently</pre><pre>open windows using the keyboard. It is highly configurable, and allows</pre><pre>the user to control its behavior, visual appearance, keyboard shortcuts,</pre><pre>and window filtering.</pre><pre><br></pre><pre>The Task Switcher is often invoked using the key combination Alt + Tab,</pre><pre>but this can be changed. When it is invoked, it shows a list of all the</pre><pre>currently open windows, optionally filtered and augmented according to</pre><pre>the configuration settings. For example, the list may be filtered to</pre><pre>show only windows that meet certain criteria, such as windows that are</pre><pre>currently visible. Once the window list is shown, the user can cycle</pre><pre>through all the listed windows by repeatedly hitting the Task Switcher</pre><pre>key combination. Releasing the Task Switcher key combination will</pre><pre>activate the window that was selected in the list.</pre><pre><br></pre><pre>Because the Task Switcher offers so many configuration options, two</pre><pre>distinct collections of configuration settings can be defined. These</pre><pre>collections are called 'Main' and 'Alternative', and each can have a set</pre><pre>of unique key combinations assigned to them.</pre><pre><br></pre><pre>The configuration options for each of the Main and Alternative</pre><pre>collections are presented in four groupings, as follows:</pre><pre>-Visualization</pre><pre>-Shortcuts</pre><pre>-Content</pre><pre>-Filter Windows By</pre><pre><br></pre><pre>These four configuration groupings are described below.</pre><pre><br></pre><pre>Visualization</pre><pre>This group of configuration options controls how the list of windows is</pre><pre>displayed on the screen. The default visualization is called Breeze,</pre><pre>which lists all open windows along the left-hand side of the screen. </pre><pre>Other visualizations include Cover Switch (a 3D carousel), Flip Switch</pre><pre>(a 3D stack of cards), and Medium Rounded (a Microsoft Windows-style</pre><pre>list of icons). Many more visualizations can be downloaded and</pre><pre>installed by clicking the Get New Task Switchers... button at the bottom</pre><pre>right of the dialog box.</pre><pre><br></pre><pre>Once a visualization has been selected from the drop-down list, the</pre><pre>button to the right of the list can be clicked to see a preview or to</pre><pre>configure visualization-specific options.</pre><pre><br></pre><pre>The 'Show Selected Window' checkbox determines how clearly the user will</pre><pre>see which window will be activated. If this box is checked, then all</pre><pre>windows will be dimmed except for the one that is currently highlighted</pre><pre>in the Task Switcher.</pre><pre><br></pre><pre>Note: There may be cases where the desired Task Switcher visualization</pre><pre>cannot be shown. One of these situations can be when a process called</pre><pre>'compositing' is turned off or disabled. If this ever happens, the</pre><pre>window list will still be shown, but in a very simple format.</pre><pre><br></pre><pre>Shortcuts</pre><pre>Up to four keyboard shortcuts can be defined to invoke the Task Switcher.</pre><pre>In the All Windows section, the Forward and Reverse shortcuts will cycle</pre><pre>forward and backward through the full list of windows.</pre><pre>In the Current Application section, the Forward and Reverse shortcuts</pre><pre>can be set to cycle through the windows of the current application. For</pre><pre>example, if you have three Dolphin file browser windows open, then you</pre><pre>would be able to use these shortcuts to just cycle among the three</pre><pre>Dolphin windows.</pre><pre>To change a keyboard shortcut, click in the 'Forward' or 'Reverse' box</pre><pre>and type the desired shortcut combination. Be sure to use a modifier</pre><pre>key like Control or Alt as part of the shortcut, otherwise you might not</pre><pre>be able to cycle through the window list properly.</pre><pre><br></pre><pre>Note: To invoke the Task Switcher without using the keyboard, you can</pre><pre>define screen edge actions in the Screen Edges module (go to System</pre><pre>Settings and then select Screen Edges).</pre><pre><br></pre><pre>Content</pre><pre>The content of the window list itself is partially controlled by the</pre><pre>options in this section.</pre><pre><br></pre><pre>The 'Sort Order' drop-down list specifies whether the windows should be</pre><pre>listed in 'Stacking Order' or 'Recently Used' order. Stacking Order is</pre><pre>the order in which the windows appear on the screen, while Recently Used</pre><pre>order is the order in which the windows have been used. Recently Used</pre><pre>order makes it very easy to switch between the two most frequently used</pre><pre>windows because they will always appear in the top 2 positions in the list.</pre><pre><br></pre><pre>The 'Include Show Desktop icon' option will add a Show Desktop option to</pre><pre>the window list. This allows the user to easily select the Desktop as</pre><pre>the 'window' to show.</pre><pre><br></pre><pre>The 'Only one window per application' option reduces clutter by only</pre><pre>showing one window for each open application. If an application has</pre><pre>multiple windows open, then its most recently activated window will be</pre><pre>shown in the list and the others will not be shown.</pre><pre><br></pre><pre>Filter Windows By</pre><pre>This section contains options for additional filtering of the list of</pre><pre>windows that are shown by the Task Switcher.</pre><pre><br></pre><pre>Virtual Desktops</pre><pre>When checked, this option filters the list of windows according to which</pre><pre>virtual desktop is currently active. If you consistently put specific</pre><pre>windows on specific virtual desktops, then this filtering option can</pre><pre>make it easy to switch to windows within or across those virtual desktops.</pre><pre><br></pre><pre>Activities</pre><pre>When checked, this option filters the list of windows according to which</pre><pre>Activity is currently active. As with Virtual Desktop filtering, this</pre><pre>option can make it easier to switch to applications within or across all</pre><pre>Activities.</pre><pre><br></pre><pre>Screens</pre><pre>When checked, this option filters the list of windows according to which</pre><pre>Screen is currently active. For this option, the active screen is the</pre><pre>one that the mouse pointer is currently on, not the screen that the</pre><pre>currently active window is on. This option can be useful to users who</pre><pre>want to quickly switch between windows that are on the same monitor in a</pre><pre>multi-monitor setup.</pre><pre><br></pre><pre>Minimization</pre><pre>When checked, this option filters the list of windows according to</pre><pre>whether they are hidden or not.</pre><pre><br></pre><pre><br></pre><pre>All of the options described above work together to provide very</pre><pre>fine-grained control of the Task Switcher's behavior and appearance. </pre><pre>For example, you could define the 'Main' settings collection to be</pre><pre>invoked with the Alt+Tab key combination, to show the open windows in a</pre><pre>carousel, to only show one window per application, and to only list</pre><pre>windows that are on the current desktop and on the currently active</pre><pre>screen. This can provide very fast context-sensitive window switching</pre><pre>if you have both 'work' and 'home' virtual desktops, and then keep all</pre><pre>of your spreadsheets for work and home on the same monitor.</pre><pre><br></pre><pre>The availability of the 'Alternative' Task Switcher configuration gives</pre><pre>you a second way way to easily filter and browse through the window</pre><pre>lists. This should make it easier to navigate through large numbers of</pre><pre>windows spread across multiple virtual desktops, screen, and activities.</pre><pre>-------------------</pre></blockquote><pre><br></pre><pre><br></pre><pre><br></pre><pre><br></pre><pre><br></pre><pre><br></pre><pre>------------------------------</pre><pre><br></pre><pre>Message: 7</pre><pre>Date: Wed, 23 Dec 2020 09:50:41 GMT</pre><pre>From: Bill Dietrich <</pre><a href="mailto:bill@billdietrich.me"><pre>bill@billdietrich.me</pre></a><pre>></pre><pre>To: </pre><a href="mailto:kde-doc-english@kde.org"><pre>kde-doc-english@kde.org</pre></a><pre><br></pre><pre>Subject: KDEConnect settings Help page</pre><pre>Message-ID: <</pre><a href="mailto:7f46cfb7-cae5-6cb2-e038-d56739929a4f@billdietrich.me"><pre>7f46cfb7-cae5-6cb2-e038-d56739929a4f@billdietrich.me</pre></a><pre>></pre><pre>Content-Type: text/plain; charset="utf-8"; Format="flowed"</pre><pre><br></pre><pre>The page should explain how to disable the KDEConnect</pre><pre>service entirely. I don't want the listener running</pre><pre>at all.</pre><pre><br></pre><pre>Thanks,</pre><pre><br></pre><pre>Bill Dietrich</pre><pre>-------------- next part --------------</pre><pre>A non-text attachment was scrubbed...</pre><pre>Name: OpenPGP_0xF790D4D71624804B.asc</pre><pre>Type: application/pgp-keys</pre><pre>Size: 2429 bytes</pre><pre>Desc: not available</pre><pre>URL: <</pre><a href="http://mail.kde.org/pipermail/kde-doc-english/attachments/20201223/af897e48/attachment-0001.key"><pre>http://mail.kde.org/pipermail/kde-doc-english/attachments/20201223/af897e48/attachment-0001.key</pre></a><pre>></pre><pre>-------------- next part --------------</pre><pre>A non-text attachment was scrubbed...</pre><pre>Name: OpenPGP_signature</pre><pre>Type: application/pgp-signature</pre><pre>Size: 665 bytes</pre><pre>Desc: OpenPGP digital signature</pre><pre>URL: <</pre><a href="http://mail.kde.org/pipermail/kde-doc-english/attachments/20201223/af897e48/attachment-0001.sig"><pre>http://mail.kde.org/pipermail/kde-doc-english/attachments/20201223/af897e48/attachment-0001.sig</pre></a><pre>></pre><pre><br></pre><pre>------------------------------</pre><pre><br></pre><pre>Message: 8</pre><pre>Date: Wed, 23 Dec 2020 11:54:06 +0000 (UTC)</pre><pre>From: Antoni Bella Pérez <</pre><a href="mailto:null@kde.org"><pre>null@kde.org</pre></a><pre>></pre><pre>To: </pre><a href="mailto:kde-commits@kde.org"><pre>kde-commits@kde.org</pre></a><pre><br></pre><pre>Cc: </pre><a href="mailto:kde-doc-english@kde.org"><pre>kde-doc-english@kde.org</pre></a><pre><br></pre><pre>Subject: [games/knavalbattle] doc: Doc: Dump releaseinfo number</pre><pre>Message-ID: <</pre><a href="mailto:20201223115406.1F3081242E99@leptone.kde.org"><pre>20201223115406.1F3081242E99@leptone.kde.org</pre></a><pre>></pre><pre>Content-Type: text/plain; charset="utf-8"</pre><pre><br></pre><pre>Git commit a729f0ce9ac2a10aef86b8fba0bfd6f8d964a063 by Antoni Bella Pérez.</pre><pre>Committed on 23/12/2020 at 11:53.</pre><pre>Pushed by bellaperez into branch 'master'.</pre><pre><br></pre><pre>Doc: Dump releaseinfo number</pre><pre><br></pre><pre>M +1 -1 doc/index.docbook</pre><pre><br></pre><a href="https://invent.kde.org/games/knavalbattle/commit/a729f0ce9ac2a10aef86b8fba0bfd6f8d964a063"><pre>https://invent.kde.org/games/knavalbattle/commit/a729f0ce9ac2a10aef86b8fba0bfd6f8d964a063</pre></a><pre><br></pre><pre><br></pre><pre>diff --git a/doc/index.docbook b/doc/index.docbook</pre><pre>index 73b566d..9350748 100644</pre><pre>--- a/doc/index.docbook</pre><pre>+++ b/doc/index.docbook</pre><pre>@@ -52,7 +52,7 @@</pre><pre> </copyright></pre><pre> </pre><pre> <date>2020-12-10</date></pre><pre>-<releaseinfo>2.1 (Applications 16.04)</releaseinfo></pre><pre>+<releaseinfo>Applications 20.12</releaseinfo></pre><pre> </pre><pre> <abstract></pre><pre> <para></pre><pre><br></pre><pre><br></pre><pre>------------------------------</pre><pre><br></pre><pre>Subject: Digest Footer</pre><pre><br></pre><pre>_______________________________________________</pre><pre>kde-doc-english mailing list</pre><a href="mailto:kde-doc-english@kde.org"><pre>kde-doc-english@kde.org</pre></a><pre><br></pre><a href="https://mail.kde.org/mailman/listinfo/kde-doc-english"><pre>https://mail.kde.org/mailman/listinfo/kde-doc-english</pre></a><pre><br></pre><pre><br></pre><pre><br></pre><pre>------------------------------</pre><pre><br></pre><pre>End of kde-doc-english Digest, Vol 212, Issue 21</pre><pre>************************************************</pre></body></html>