Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

5 files changed, 586 insertions, 0 deletions

diff --git a/kstart/LICENSE.readme b/kstart/LICENSE.readme
new file mode 100644
index 000000000..1cc95fd53
--- /dev/null
+++ b/kstart/LICENSE.readme
@@ -0,0 +1,124 @@
+kstart --- the KDE legacy application starter
+
+Copyright (C) 1997, 1998  by Matthias Ettrich <[email protected]>
+
+                               The "Artistic License"
+
+                                      Preamble
+
+        The intent of this document is to state the conditions under which a
+        Package may be copied, such that the Copyright Holder maintains some
+        semblance of artistic control over the development of the package,
+        while giving the users of the package the right to use and
+        distribute the Package in a more-or-less customary fashion, plus the
+        right to make reasonable modifications.
+
+        Definitions:
+
+           * "Package" refers to the collection of files distributed by the
+             Copyright Holder, and derivatives of that collection of files
+             created through textual modification.
+
+           * "Standard Version" refers to such a Package if it has not been
+             modified, or has been modified in accordance with the wishes of
+             the Copyright Holder.
+
+           * "Copyright Holder" is whoever is named in the copyright or
+             copyrights for the package.
+
+           * "You" is you, if you're thinking about copying or distributing
+             this Package.
+
+           * "Reasonable copying fee" is whatever you can justify on the
+             basis of media cost, duplication charges, time of people
+             involved, and so on. (You will not be required to justify it to
+             the Copyright Holder, but only to the computing community at
+             large as a market that must bear the fee.)
+
+           * "Freely Available" means that no fee is charged for the item
+             itself, though there may be fees involved in handling the item.
+             It also means that recipients of the item may redistribute it
+             under the same conditions they received it.
+
+        1. You may make and give away verbatim copies of the source form of
+        the Standard Version of this Package without restriction, provided
+        that you duplicate all of the original copyright notices and
+        associated disclaimers.
+
+        2. You may apply bug fixes, portability fixes and other
+        modifications derived from the Public Domain or from the Copyright
+        Holder. A Package modified in such a way shall still be considered
+        the Standard Version.
+
+        3. You may otherwise modify your copy of this Package in any way,
+        provided that you insert a prominent notice in each changed file
+        stating how and when you changed that file, and provided that you do
+        at least ONE of the following:
+
+             a) place your modifications in the Public Domain or
+             otherwise make them Freely Available, such as by posting
+             said modifications to Usenet or an equivalent medium, or
+             placing the modifications on a major archive site such as
+             ftp.uu.net, or by allowing the Copyright Holder to include
+             your modifications in the Standard Version of the Package.
+
+             b) use the modified Package only within your corporation
+             or organization.
+
+             c) rename any non-standard executables so the names do not
+             conflict with standard executables, which must also be
+             provided, and provide a separate manual page for each
+             non-standard executable that clearly documents how it
+             differs from the Standard Version.
+
+             d) make other distribution arrangements with the Copyright
+             Holder.
+
+        4. You may distribute the programs of this Package in object code or
+        executable form, provided that you do at least ONE of the following:
+
+             a) distribute a Standard Version of the executables and
+             library files, together with instructions (in the manual
+             page or equivalent) on where to get the Standard Version.
+
+             b) accompany the distribution with the machine-readable
+             source of the Package with your modifications.
+
+             c) accompany any non-standard executables with their
+             corresponding Standard Version executables, giving the
+             non-standard executables non-standard names, and clearly
+             documenting the differences in manual pages (or
+             equivalent), together with instructions on where to get
+             the Standard Version.
+
+             d) make other distribution arrangements with the Copyright
+             Holder.
+
+        5. You may charge a reasonable copying fee for any distribution of
+        this Package. You may charge any fee you choose for support of this
+        Package. You may not charge a fee for this Package itself. However,
+        you may distribute this Package in aggregate with other (possibly
+        commercial) programs as part of a larger (possibly commercial)
+        software distribution provided that you do not advertise this
+        Package as a product of your own.
+
+        6. The scripts and library files supplied as input to or produced as
+        output from the programs of this Package do not automatically fall
+        under the copyright of this Package, but belong to whomever
+        generated them, and may be sold commercially, and may be aggregated
+        with this Package.
+
+        7. C or perl subroutines supplied by you and linked into this
+        Package shall not be considered part of this Package.
+
+        8. The name of the Copyright Holder may not be used to endorse or
+        promote products derived from this software without specific prior
+        written permission.
+
+        9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+        IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+                                      The End
+
+
diff --git a/kstart/Makefile.am b/kstart/Makefile.am
new file mode 100644
index 000000000..01aeca492
--- /dev/null
+++ b/kstart/Makefile.am
@@ -0,0 +1,21 @@
+####### Fiddle here
+
+AM_CPPFLAGS = -DQT_NO_CAST_ASCII -DQT_CLEAN_NAMESPACE -DQT_NO_COMPAT
+
+INCLUDES = $(all_includes)
+
+#######	Files
+
+bin_PROGRAMS	= kstart
+kstart_SOURCES	= kstart.cpp
+kstart_LDFLAGS  = $(all_libraries) $(KDE_RPATH)
+kstart_LDADD    = $(LIB_KDECORE)
+METASOURCES =	kstart.moc 
+
+noinst_HEADERS = kstart.h version.h
+
+messages:
+	$(XGETTEXT) $(kstart_SOURCES) -o $(podir)/kstart.pot
+
+EXTRA_DIST = CHANGES LICENSE.readme
+
diff --git a/kstart/kstart.cpp b/kstart/kstart.cpp
new file mode 100644
index 000000000..83105c86d
--- /dev/null
+++ b/kstart/kstart.cpp
@@ -0,0 +1,404 @@
+/*
+ * kstart.C. Part of the KDE project.
+ *
+ * Copyright (C) 1997-2000 Matthias Ettrich <[email protected]>
+ *
+ * First port to NETWM by David Faure <[email protected]>
+ * Send to system tray by Richard Moore <[email protected]>
+ */
+
+#include "kstart.moc"
+#include "version.h"
+
+#include <fcntl.h>
+#include <stdlib.h>
+
+#include <qregexp.h>
+#include <qtimer.h>
+
+#include <kdebug.h>
+#include <kprocess.h>
+#include <klocale.h>
+#include <kwin.h>
+#include <kwinmodule.h>
+#include <kapplication.h>
+#include <kaboutdata.h>
+#include <kcmdlineargs.h>
+#include <kstartupinfo.h>
+#include <kxmessages.h>
+
+#include <netwm.h>
+
+
+// some globals
+
+static KProcess proc;
+static QCString windowtitle = 0;
+static QCString windowclass = 0;
+static int desktop = 0;
+static bool activate = false;
+static bool iconify = false;
+static bool toSysTray = false;
+static bool fullscreen = false;
+static unsigned long state = 0;
+static unsigned long mask = 0;
+static NET::WindowType windowtype = NET::Unknown;
+static KWinModule* kwinmodule;
+
+KStart::KStart()
+    :QObject()
+{
+    NETRootInfo i( qt_xdisplay(), NET::Supported );
+    bool useRule = !toSysTray && i.isSupported( NET::WM2KDETemporaryRules );
+
+    if( useRule )
+        sendRule();
+    else {
+        // connect to window add to get the NEW windows
+        connect(kwinmodule, SIGNAL(windowAdded(WId)), SLOT(windowAdded(WId)));
+        if (windowtitle)
+    	    kwinmodule->doNotManage( windowtitle );
+    }
+    // propagate the app startup notification info to the started app
+    KStartupInfoId id;
+    id.initId( kapp->startupId());
+    id.setupStartupEnv();
+
+    //finally execute the comand
+    if( proc.start(KProcess::DontCare) ) {
+        KStartupInfoData data;
+        data.addPid( proc.pid() );
+        QCString bin = proc.args().first();
+        data.setName( bin );
+        data.setBin( bin.mid( bin.findRev( '/' ) + 1 ));
+        KStartupInfo::sendChange( id, data );
+    }
+    else
+        KStartupInfo::sendFinish( id ); // failed to start
+
+  QTimer::singleShot( useRule ? 0 : 120 * 1000, kapp, SLOT( quit()));
+}
+
+void KStart::sendRule() {
+    KXMessages msg;
+    QCString message;
+    if( windowtitle )
+        message += "title=" + windowtitle + "\ntitlematch=3\n"; // 3 = regexp match
+    if( windowclass )
+        message += "wmclass=" + windowclass + "\nwmclassmatch=1\n" // 1 = exact match
+            + "wmclasscomplete="
+            // if windowclass contains a space (i.e. 2 words, use whole WM_CLASS)
+            + ( windowclass.contains( ' ' ) ? "true" : "false" ) + "\n";
+    if( windowtitle || windowclass ) {
+        // always ignore these window types
+        message += "types=" + QCString().setNum( -1U &
+            ~( NET::TopMenuMask | NET::ToolbarMask | NET::DesktopMask | NET::SplashMask | NET::MenuMask )) + "\n";
+    } else {
+        // accept only "normal" windows
+        message += "types=" + QCString().setNum( NET::NormalMask | NET::DialogMask ) + "\n";
+    }
+    if ( ( desktop > 0 && desktop <= kwinmodule->numberOfDesktops() )
+         || desktop == NETWinInfo::OnAllDesktops ) {
+	message += "desktop=" + QCString().setNum( desktop ) + "\ndesktoprule=3\n";
+    }
+    if (activate)
+        message += "fsplevel=0\nfsplevelrule=2\n";
+    if (iconify)
+        message += "minimize=true\nminimizerule=3\n";
+    if ( windowtype != NET::Unknown ) {
+        message += "type=" + QCString().setNum( windowtype ) + "\ntyperule=2";
+    }
+    if ( state ) {
+        if( state & NET::KeepAbove )
+            message += "above=true\naboverule=3\n";
+        if( state & NET::KeepBelow )
+            message += "below=true\nbelowrule=3\n";
+        if( state & NET::SkipTaskbar )
+            message += "skiptaskbar=true\nskiptaskbarrule=3\n";
+        if( state & NET::SkipPager )
+            message += "skippager=true\nskippagerrule=3\n";
+        if( state & NET::MaxVert )
+            message += "maximizevert=true\nmaximizevertrule=3\n";
+        if( state & NET::MaxHoriz )
+            message += "maximizehoriz=true\nmaximizehorizrule=3\n";
+        if( state & NET::FullScreen )
+            message += "fullscreen=true\nfullscreenrule=3\n";
+    }
+
+    msg.broadcastMessage( "_KDE_NET_WM_TEMPORARY_RULES", message, -1, false );
+    kapp->flushX();
+}
+
+const int SUPPORTED_WINDOW_TYPES_MASK = NET::NormalMask | NET::DesktopMask | NET::DockMask
+    | NET::ToolbarMask | NET::MenuMask | NET::DialogMask | NET::OverrideMask | NET::TopMenuMask
+    | NET::UtilityMask | NET::SplashMask;
+
+void KStart::windowAdded(WId w){
+
+    KWin::WindowInfo info = KWin::windowInfo( w );
+
+    // always ignore these window types
+    if( info.windowType( SUPPORTED_WINDOW_TYPES_MASK ) == NET::TopMenu
+        || info.windowType( SUPPORTED_WINDOW_TYPES_MASK ) == NET::Toolbar
+        || info.windowType( SUPPORTED_WINDOW_TYPES_MASK ) == NET::Desktop )
+        return;
+
+    if ( windowtitle ) {
+	QString title = info.name().lower();
+	QRegExp r( windowtitle.lower());
+	if (r.match(title) == -1)
+	    return; // no match
+    }
+    if ( windowclass ) {
+        XClassHint hint;
+        if( !XGetClassHint( qt_xdisplay(), w, &hint ))
+            return;
+        QCString cls = windowclass.contains( ' ' )
+            ? QCString( hint.res_name ) + ' ' + hint.res_class : QCString( hint.res_class );
+        cls = cls.lower();
+        XFree( hint.res_name );
+	XFree( hint.res_class );
+        if( cls != windowclass )
+            return;
+    }
+    if( !windowtitle && !windowclass ) {
+        // accept only "normal" windows
+        if( info.windowType( SUPPORTED_WINDOW_TYPES_MASK ) != NET::Unknown
+            && info.windowType( SUPPORTED_WINDOW_TYPES_MASK ) != NET::Normal
+            && info.windowType( SUPPORTED_WINDOW_TYPES_MASK ) != NET::Dialog )
+            return;
+    }
+    applyStyle( w );
+    QApplication::exit();
+}
+
+
+extern Atom qt_wm_state; // defined in qapplication_x11.cpp
+static bool wstate_withdrawn( WId winid )
+{
+    Atom type;
+    int format;
+    unsigned long length, after;
+    unsigned char *data;
+    int r = XGetWindowProperty( qt_xdisplay(), winid, qt_wm_state, 0, 2,
+				FALSE, AnyPropertyType, &type, &format,
+				&length, &after, &data );
+    bool withdrawn = TRUE;
+    if ( r == Success && data && format == 32 ) {
+	Q_UINT32 *wstate = (Q_UINT32*)data;
+	withdrawn  = (*wstate == WithdrawnState );
+	XFree( (char *)data );
+    }
+    return withdrawn;
+}
+
+
+void KStart::applyStyle(WId w ) {
+
+    if ( toSysTray || state || iconify || windowtype != NET::Unknown || desktop >= 1 ) {
+
+	XWithdrawWindow(qt_xdisplay(), w, qt_xscreen());
+	QApplication::flushX();
+
+	while ( !wstate_withdrawn(w) )
+	    ;
+    }
+
+    NETWinInfo info( qt_xdisplay(), w, qt_xrootwin(), NET::WMState );
+
+    if ( ( desktop > 0 && desktop <= kwinmodule->numberOfDesktops() )
+         || desktop == NETWinInfo::OnAllDesktops )
+	info.setDesktop( desktop );
+
+    if (iconify) {
+	XWMHints * hints = XGetWMHints(qt_xdisplay(), w );
+	if (hints ) {
+	    hints->flags |= StateHint;
+	    hints->initial_state = IconicState;
+	    XSetWMHints( qt_xdisplay(), w, hints );
+	    XFree(hints);
+	}
+    }
+
+    if ( windowtype != NET::Unknown ) {
+	info.setWindowType( windowtype );
+    }
+
+    if ( state )
+	info.setState( state, mask );
+
+    if ( toSysTray ) {
+	QApplication::beep();
+	KWin::setSystemTrayWindowFor( w,  qt_xrootwin() );
+    }
+
+    if ( fullscreen ) {
+	QRect r = QApplication::desktop()->geometry();
+	XMoveResizeWindow( qt_xdisplay(), w, r.x(), r.y(), r.width(), r.height() );
+    }
+
+
+    XSync(qt_xdisplay(), False);
+
+    XMapWindow(qt_xdisplay(), w );
+    XSync(qt_xdisplay(), False);
+
+    if (activate)
+      KWin::forceActiveWindow( w );
+
+    QApplication::flushX();
+}
+
+// David, 05/03/2000
+static KCmdLineOptions options[] =
+{
+  { "!+command", I18N_NOOP("Command to execute"), 0 },
+  // "!" means: all options after command are treated as arguments to the command
+  { "window <regexp>", I18N_NOOP("A regular expression matching the window title"), 0 },
+  { "windowclass <class>", I18N_NOOP("A string matching the window class (WM_CLASS property)\n"
+                  "The window class can be found out by running\n"
+                  "'xprop | grep WM_CLASS' and clicking on a window\n"
+                  "(use either both parts separated by a space or only the right part).\n"
+                  "NOTE: If you specify neither window title nor window class,\n"
+                  "then the very first window to appear will be taken;\n"
+                  "omitting both options is NOT recommended."), 0 },
+  { "desktop <number>", I18N_NOOP("Desktop on which to make the window appear"), 0 },
+  { "currentdesktop", I18N_NOOP("Make the window appear on the desktop that was active\nwhen starting the application"), 0 },
+  { "alldesktops", I18N_NOOP("Make the window appear on all desktops"), 0 },
+  { "iconify", I18N_NOOP("Iconify the window"), 0 },
+  { "maximize", I18N_NOOP("Maximize the window"), 0 },
+  { "maximize-vertically", I18N_NOOP("Maximize the window vertically"), 0 },
+  { "maximize-horizontally", I18N_NOOP("Maximize the window horizontally"), 0 },
+  { "fullscreen", I18N_NOOP("Show window fullscreen"), 0 },
+  { "type <type>", I18N_NOOP("The window type: Normal, Desktop, Dock, Tool, \nMenu, Dialog, TopMenu or Override"), 0 },
+  { "activate", I18N_NOOP("Jump to the window even if it is started on a \n"
+                          "different virtual desktop"), 0 },
+  { "ontop", 0, 0 },
+  { "keepabove", I18N_NOOP("Try to keep the window above other windows"), 0 },
+  { "onbottom", 0, 0 },
+  { "keepbelow", I18N_NOOP("Try to keep the window below other windows"), 0 },
+  { "skiptaskbar", I18N_NOOP("The window does not get an entry in the taskbar"), 0 },
+  { "skippager", I18N_NOOP("The window does not get an entry on the pager"), 0 },
+  { "tosystray", I18N_NOOP("The window is sent to the system tray in Kicker"), 0 },
+  KCmdLineLastOption
+};
+
+int main( int argc, char *argv[] )
+{
+  // David, 05/03/2000
+  KAboutData aboutData( "kstart", I18N_NOOP("KStart"), KSTART_VERSION,
+      I18N_NOOP(""
+       "Utility to launch applications with special window properties \n"
+       "such as iconified, maximized, a certain virtual desktop, a special decoration\n"
+       "and so on." ),
+      KAboutData::License_GPL,
+       "(C) 1997-2000 Matthias Ettrich ([email protected])" );
+
+  aboutData.addAuthor( "Matthias Ettrich", 0, "[email protected]" );
+  aboutData.addAuthor( "David Faure", 0, "[email protected]" );
+  aboutData.addAuthor( "Richard J. Moore", 0, "[email protected]" );
+
+  KCmdLineArgs::init( argc, argv, &aboutData );
+
+  KCmdLineArgs::addCmdLineOptions( options ); // Add our own options.
+
+  KApplication app;
+
+  KCmdLineArgs *args = KCmdLineArgs::parsedArgs();
+
+  if ( args->count() == 0 )
+      KCmdLineArgs::usage(i18n("No command specified"));
+
+  for(int i=0; i < args->count(); i++)
+    proc << args->arg(i);
+
+  kwinmodule = new KWinModule;
+
+  desktop = args->getOption( "desktop" ).toInt();
+  if ( args->isSet ( "alldesktops")  )
+      desktop = NETWinInfo::OnAllDesktops;
+  if ( args->isSet ( "currentdesktop")  )
+      desktop = kwinmodule->currentDesktop();
+
+  windowtitle = args->getOption( "window" );
+  windowclass = args->getOption( "windowclass" );
+  if( windowclass )
+      windowclass = windowclass.lower();
+  
+  if( windowtitle.isEmpty() && windowclass.isEmpty())
+      kdWarning() << "Omitting both --window and --windowclass arguments is not recommended" << endl;
+
+  QCString s = args->getOption( "type" );
+  if ( !s.isEmpty() ) {
+      s = s.lower();
+      if ( s == "desktop" )
+	  windowtype = NET::Desktop;
+      else if ( s == "dock" )
+	  windowtype = NET::Dock;
+      else if ( s == "tool" )
+	  windowtype = NET::Tool;
+      else if ( s == "menu" )
+	  windowtype = NET::Menu;
+      else if ( s == "dialog" )
+	  windowtype = NET::Dialog;
+      else if ( s == "override" )
+	  windowtype = NET::Override;
+      else if ( s == "topmenu" )
+	  windowtype = NET::TopMenu;
+      else
+	  windowtype = NET::Normal;
+  }
+
+  if ( args->isSet( "keepabove" ) ) {
+      state |= NET::KeepAbove;
+      mask |= NET::KeepAbove;
+  } else if ( args->isSet( "keepbelow" ) ) {
+      state |= NET::KeepBelow;
+      mask |= NET::KeepBelow;
+  }
+  
+  if ( args->isSet( "skiptaskbar" ) ) {
+      state |= NET::SkipTaskbar;
+      mask |= NET::SkipTaskbar;
+  }
+
+  if ( args->isSet( "skippager" ) ) {
+      state |= NET::SkipPager;
+      mask |= NET::SkipPager;
+  }
+
+  activate = args->isSet("activate");
+
+  if ( args->isSet("maximize") ) {
+      state |= NET::Max;
+      mask |= NET::Max;
+  }
+  if ( args->isSet("maximize-vertically") ) {
+      state |= NET::MaxVert;
+      mask |= NET::MaxVert;
+  }
+  if ( args->isSet("maximize-horizontally") ) {
+      state |= NET::MaxHoriz;
+      mask |= NET::MaxHoriz;
+  }
+
+  iconify = args->isSet("iconify");
+  toSysTray = args->isSet("tosystray");
+  if ( args->isSet("fullscreen") ) {
+      NETRootInfo i( qt_xdisplay(), NET::Supported );
+      if( i.isSupported( NET::FullScreen )) {
+          state |= NET::FullScreen;
+          mask |= NET::FullScreen;
+      } else {
+          windowtype = NET::Override;
+          fullscreen = true;
+      }
+  }
+
+  fcntl(ConnectionNumber(qt_xdisplay()), F_SETFD, 1);
+  args->clear();
+
+  KStart start;
+
+  return app.exec();
+}
diff --git a/kstart/kstart.h b/kstart/kstart.h
new file mode 100644
index 000000000..0b5013387
--- /dev/null
+++ b/kstart/kstart.h
@@ -0,0 +1,36 @@
+/*
+ * kstart.h Part of the KDE project.
+ *
+ * Copyright (C) 1997-2000 Matthias Ettrich <[email protected]>
+ *
+ * Port to NETWM by David Faure <[email protected]>
+ *
+ */
+
+#ifndef KSTART_H
+#define KSTART_H
+
+
+#include <qobject.h>
+
+class KWinModule;
+
+class KStart: public QObject {
+  Q_OBJECT
+
+public:
+  KStart();
+  ~KStart(){};
+  
+public slots:
+  void windowAdded(WId);
+
+private:
+
+  void applyStyle(WId );
+  void sendRule();
+
+};
+
+#endif
+
diff --git a/kstart/version.h b/kstart/version.h
new file mode 100644
index 000000000..3c866e946
--- /dev/null
+++ b/kstart/version.h
@@ -0,0 +1 @@
+#define KSTART_VERSION "kstart version 1.92"