<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugs.kde.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugs.kde.org/"
          
          maintainer="sysadmin@kde.org"
>

    <bug>
          <bug_id>433636</bug_id>
          
          <creation_ts>2021-02-26 07:25:34 +0000</creation_ts>
          <short_desc>Add &quot;howto&quot; use intructions in Krunner plugin descriptions</short_desc>
          <delta_ts>2021-12-26 14:53:19 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>4</classification_id>
          <classification>Plasma</classification>
          <product>krunner</product>
          <component>general</component>
          <version>5.21.1</version>
          <rep_platform>Neon</rep_platform>
          <op_sys>Linux</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>NOR</priority>
          <bug_severity>task</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Dan Dascalescu">ddascalescu+kde</reporter>
          <assigned_to name="Alexander Lohnau">alexander.lohnau</assigned_to>
          <cc>nate</cc>
    
    <cc>plasma-bugs-null</cc>
    
    <cc>spm5243</cc>
          
          <cf_commitlink>https://invent.kde.org/plasma/plasma-workspace/commit/c8c72bf66a403b408fa9d6559ed5887e358bd490</cf_commitlink>
          <cf_versionfixedin>5.24</cf_versionfixedin>
          <cf_sentryurl></cf_sentryurl>
          <votes>0</votes>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>2006660</commentid>
    <comment_count>0</comment_count>
    <who name="Dan Dascalescu">ddascalescu+kde</who>
    <bug_when>2021-02-26 07:25:34 +0000</bug_when>
    <thetext>SUMMARY
While some KRunner plugins are pretty obvious use use, and others show themselves automatically (e.g. calculator) or have setting (e.g. the trigger word for Spell Checker), it&apos; unclear how to use certain KRunner plugins.

For example, what does &quot;Date and Time&quot; do? The description says &quot;The current date and time, locally or in any timezone&quot;, but I don&apos;t see that displayed anywhere when I invoke KRunner. I tried typing &quot;next monday&quot; or other natural format dates, thinking I&apos;d get a result like &quot;3/1/2021&quot;, but no.

Another example is KWin - &quot;Interact with the Plasma Compositor&quot; - how exactly? 

Same for &quot;Plasma Desktop Shell&quot;

Lastly, &quot;Desktop Sessions (Fast user switching)&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>2057329</commentid>
    <comment_count>1</comment_count>
    <who name="Octopuss">spm5243</who>
    <bug_when>2021-08-30 09:16:45 +0000</bug_when>
    <thetext>Exactly! Lack of documentation is a huge problem. Going to https://userbase.kde.org is a waste of time also - the info here a ten years outdated!

As an example: The page https://userbase.kde.org/Plasma/Krunner refer plugin &quot;Be on time&quot; but there is no such plugin neither commands &quot;date&quot;/&quot;time&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>2067276</commentid>
    <comment_count>2</comment_count>
    <who name="Bug Janitor Service">bug-janitor</who>
    <bug_when>2021-10-08 16:09:23 +0000</bug_when>
    <thetext>A possibly relevant merge request was started @ https://invent.kde.org/frameworks/krunner/-/merge_requests/77</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>2067278</commentid>
    <comment_count>3</comment_count>
    <who name="Bug Janitor Service">bug-janitor</who>
    <bug_when>2021-10-08 16:16:28 +0000</bug_when>
    <thetext>A possibly relevant merge request was started @ https://invent.kde.org/plasma/plasma-workspace/-/merge_requests/1102</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>2086584</commentid>
    <comment_count>4</comment_count>
    <who name="Alexander Lohnau">alexander.lohnau</who>
    <bug_when>2021-12-18 10:54:57 +0000</bug_when>
    <thetext>Git commit 14829aefb9de56bda2003a713441828105cc805a by Alexander Lohnau.
Committed on 18/12/2021 at 10:50.
Pushed by alex into branch &apos;master&apos;.

RunerContext: Allow runners to update the query string

Before this was only possible when the match type is set to InformationalMatch.
This did not include the cursorPosition feature and the text needed to be specified
before the match is added.

To make sure the method can be called in AbstractRunner::run it is marked as const.

The usecase is a help functionality where the placeholder for the query should get focused
so that the user can overwrite it by typing: https://phabricator.kde.org/F10042697

M  +18   -0    src/runnercontext.cpp
M  +15   -0    src/runnercontext.h
M  +6    -1    src/runnermanager.cpp

https://invent.kde.org/frameworks/krunner/commit/14829aefb9de56bda2003a713441828105cc805a</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>2088188</commentid>
    <comment_count>5</comment_count>
    <who name="Alexander Lohnau">alexander.lohnau</who>
    <bug_when>2021-12-26 10:57:38 +0000</bug_when>
    <thetext>Git commit c8c72bf66a403b408fa9d6559ed5887e358bd490 by Alexander Lohnau.
Committed on 25/12/2021 at 16:53.
Pushed by alex into branch &apos;master&apos;.

Add helprunner to show usage information for KRunner plugins
Related: bug 369136

M  +2    -1    lookandfeel/contents/runcommand/RunCommand.qml
M  +1    -0    runners/CMakeLists.txt
A  +2    -0    runners/helprunner/CMakeLists.txt
A  +81   -0    runners/helprunner/helprunner.cpp     [License: LGPL(v2.1+)]
A  +27   -0    runners/helprunner/helprunner.h     [License: LGPL(v2.1+)]
A  +17   -0    runners/helprunner/helprunner.json

https://invent.kde.org/plasma/plasma-workspace/commit/c8c72bf66a403b408fa9d6559ed5887e358bd490</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>