[Konversation-devel] [Bug 131290] New: Scripting documentation is inadequate

[David]

------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
         
http://bugs.kde.org/show_bug.cgi?id=131290         
           Summary: Scripting documentation is inadequate
           Product: konversation
           Version: unspecified
          Platform: Ubuntu Packages
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: wishlist
          Priority: NOR
         Component: general
        AssignedTo: konversation-devel kde org
        ReportedBy: danzel localhost geek nz


Version:           0.19 #3100 (using KDE KDE 3.5.2)
Installed from:    Ubuntu Packages
OS:                Linux

The scripting page in the Konversation Handbook provides inadequate information to create a script that does anything more than message.

I wanted to have konversation automatically log me into X on undernet when connecting. The commands box in edit menu was a prime candidate for performing the commands but it can only store one line of text and I need 2.
After a bit of looking in the docs I decided that I would need to write a script, but I could not figure out how to perform a mode change from a script. Luckily cartman from #konversation told me where the dcop list was and I was able to figure out how to do it:
dcop $PORT Konversation say $SERVER "x channels undernet org" "login NICK PASSWORD";
dcop $PORT Konversation raw $SERVER "mode NICK +x";
(Possibly not very secure, but I'm only using it on a single user machine)

Could a list of the dcop calls and some short examples of using the different ones be added into the handbook? It would make the scripting page in the handbook alot more useful :)