Branch: master

b274e655 2015-02-22 02:42:30 Timothy Pearson
Remove obsolete KDE2PORTING.html file
R KDE2PORTING.html
diff --git a/KDE2PORTING.html b/KDE2PORTING.html
deleted file mode 100644
index 181a5bc..0000000
--- a/KDE2PORTING.html
+++ /dev/null
@@ -1,925 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Level 2//EN//2.0">
-<HTML>
-<HEAD>
-	<TITLE>Guide to Porting Applications to KDE 2.0</TITLE>
-</HEAD>
-<BODY>
-
-<H2>Porting Applications to KDE 2.0</H2>
-<H3>Last Modified on November 28, 2000</H3>
-This document contains the changes you have to apply to programs written for
-KDE1.1 when you want to port them to KDE2.0.<P>
-
-As a start you should have a look at doc/porting.doc in the Qt package,
-or <a href="http://doc.trolltech.com/porting.html">this page online</a>.<P>
-
-<H3><A NAME="TOC">Table of Contents</A></H3>
-
-<UL>
-<LI><A HREF="#gettingstarted">Getting Started</A></LI>
-<LI><A HREF="#general">Global changes</A></LI>
-<LI><A HREF="#automoc">automoc/am_edit, Makefile.am tags</A></LI>
-<LI><A HREF="#TDEApplication">TDEApplication</A></LI>
-<LI><A HREF="#TDECmdLineArgs">TDECmdLineArgs</A></LI>
-<LI><A HREF="#TDELocale">TDELocale</A></LI>
-<LI><A HREF="#TDEGlobal">TDEGlobal: access to KDE global objects.</A></LI>
-<LI><A HREF="#TDEIconLoader">TDEIconLoader</A></LI>
-<LI><A HREF="#KTMainWindow">KTMainWindow</A></LI>
-<LI><A HREF="#KHelpMenu">KHelpMenu</A></LI>
-<LI><A HREF="#TDEToolBar">TDEToolBar</A></LI>
-<LI><A HREF="#launching">Starting other programs</A></LI>
-<LI><A HREF="#tdehtmlw">tdehtmlw</A></LI>
-<LI><A HREF="#KIntegerLine">KIntegerLine, KIntLineEdit</A></LI>
-<LI><A HREF="#KDNDIcon">KDNDIcon, KDNDDropZone, KDNDWidget, tdecore/drag.h</A></LI>
-<LI><A HREF="#TDEConfigBase">TDEConfigBase, TDEConfig, KSimpleConfig</A></LI>
-<LI><A HREF="#libkfm">libkfm</A></LI>
-<LI><A HREF="#KDialog">KDialog</A></LI>
-<LI><A HREF="#kcharsets">kcharsets</A></LI>
-<LI><A HREF="#KWizard">KWizard, KNoteBook</A></LI>
-<LI><A HREF="#KSpinBox">KSpinBox, KNumericSpinBox</A></LI>
-<LI><A HREF="#TDEClipboard">TDEClipboard</A></LI>
-<LI><A HREF="#KPanner">KPanner, KNewPanner</A></LI>
-<LI><A HREF="#KTreeList">KTreeList, KTreeListItem</A></LI>
-<LI><A HREF="#KMsgBox">KMsgBox</A></LI>
-<LI><A HREF="#KCombo">KCombo</A></LI>
-<LI><A HREF="#KQuickHelp">KQuickHelp</A></LI>
-<LI><A HREF="#KPixmapgradientFill">KPixmap::gradientFill</A></LI>
-<LI><A HREF="#KTabListBox">KTabListBox</A></LI>
-<LI><A HREF="#TDEToolBarButton">TDEToolBarButton &amp; TDERadioGroup</A></LI>
-<LI><A HREF="#TDEAccel">TDEAccel</A></LI>
-<LI><A HREF="#kstring">kstring.h / KString</A></LI>
-<LI><A HREF="#ktopwidget">ktopwidget.h / KTopWidget</A></LI>
-<LI><A HREF="#kbutton">kbutton.h / KButton</A></LI>
-<LI><A HREF="#kbuttonbox">kbuttonbox.h / KButtonBox</A></LI>
-<LI><A HREF="#kcolorgroup">kcolorgroup.h / KColorGroup</A></LI>
-<LI><A HREF="#kled">kled.h, kledlamp.h / KLed, KLedLamp</A></LI>
-<LI><A HREF="#KDockWidget">KDockWidget</A></LI>
-<LI><A HREF="#KPixmap">KPixmap, KPixmapEffect</A></LI>
-<LI><A HREF="#KControlCenter">Trinity Control Center</A></LI>
-<LI><A HREF="#KWMModuleApplication">KWMModuleApplication libtdeui/kwmmapp.h</A></LI>
-<LI><A HREF="#KDebug">KDebug</A></LI>
-<LI><A HREF="#KFileDialog">KFileDialog - General Stuff</A></LI>
-<LI><A HREF="#KFileDialogPreview">KFileDialog - Preview Mode</A></LI>
-<LI><A HREF="#ImageEffects">Image Effects</A></LI>
-<LI><A HREF="#KAudio">KAudio (kaudio.h)</A></LI>
-<LI><A HREF="#KImageIO">KImageIO (kimgio.h)</A></LI>
-</UL>
-
-<H3><A NAME="gettingstarted">Getting started</A></H3>
-
-  The first step to get your KDE application to compile under KDE 2.0,
-  is to detect KDE 2.0 and Qt 2.x at configure time. The easiest way to
-  get a working autoconf/automake framework, is to either use 
-  <a href="http://www.kdevelop.org">KDevelop</a> or
-  <a href="http://home.earthlink.net/~granroth/kapptemplate/index.html">kapptemplate</a>
-  (available in CVS under the module "tdesdk"), to generate a new
-  application template. Replace the generated source files by yours
-  and adapt Makefile.am accordingly.
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="general">Global changes</A></H3>
-
-  We did our best to clean up the header files of tdelibs, so they do
-  not include unnecessary bloat for your application. As a consequence, you
-  may notice that some header files are missing from your source files as
-  they have been included before by kapp.h for example. There is a script
-  in tdesdk/scripts called "fixheaders" that takes care of most of these
-  cases. Just call "make -k 2&gt;&amp;1 | perl .../fixheaders" and it will try
-  to look after the error messages and add includes as it recognize the
-  errors.<P>
-
-  Also, if your code does not compile and complains about missing member
-  functions, you should check for methods that started with get...().
-  These methods have been renamed to xy*() for consistency.<P>
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="automoc">automoc/am_edit, Makefile.am tags</A></H3>
-
-  On the subject of the compilation framework, automoc has been removed from
-  the admin directory. It has been replaced by am_edit which provides a lot of
-  additional features.<P>
-  METASOURCES=AUTO still does the job of generating the appropriate moc files,
-  but in addition, you should use KDE_ICON for the icons representing the application
-  (and naming those icons conforming to lo16-app-&lt;appname&gt;.png), and install
-  the application-specific icons under $(kde_datadir)/&lt;appname&gt;/pics.
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="TDEApplication">TDEApplication</A></H3>
-
-  doesn't hold any longer a TDELocale instance. With this getLocale()
-  and isLocaleInstantiated are now replaced by TDEGlobal::locale()<P>
-
-  it also doesn't hold a KiconLoader instance. As this also getIconLoader()
-  has been removed. Replace kapp-&gt;getIconLoader()-&gt;loadIcon() with
-  BarIcon() or use TDEGlobal::iconLoader() instead of getIconLoader()<P>
-
-  kde_*dir() have been removed as they require a unique top level directory
-  for all applications (TDEDIR). This concept doesn't exist in KDE 2.0
-  any more, it has been replaced with "multiple levels of directories",
-  set in TDEDIRS, so that it's possible to have global settings and
-  group settings, applied before user settings.<P>
-
-  Replace code that uses kde_*dir() + filename with calls to
-  locate(filetype, filename) where filetype is what * used to be
-  in kde_*dir(). locate is defined as function in kstddirs.h to call
-  TDEGlobal::dirs()-&gt;findResource.<P>
-
-  Use locateLocal to get the path of a writable file. For instance,
-  TDEApplication::localconfigdir()+filename is now locateLocal( "config", filename ),
-  but for most cases, simply using TDEGlobal::config() is enough, if you're happy
-  with saving the application's configuration into appnamerc, or
-  KSimpleConfig cfg("anothercfgfile") to create a config file with another name.<P>
-
-  generalFont() and fixedFont() are deprecated and will be removed soon.
-  Please use TDEGlobalSettings::generalFont() and TDEGlobalSettings::fixedFont() instead.<P>
-
-  appName() is deprecated. Please use TQApplication::name() or instanceName
-  instead.<P>
-
-  The methods tempSaveName() and checkRecoverFile() return QString
-  now. The returned values must _not_ be free()d.<P>
-
-  helpMenu() has been moved to TDEMainWindow. aboutKDE(), aboutApp() and
-  appHelpActivated() have all been removed See section for TDEMainWindow
-  for more info.<P>
-
-  The TDEApplication constructor has changed. Command line arguments and
-  program name should no longer be passed to TDEApplication but to 
-  TDECmdLineArgs. TDECmdLineArgs performs command line parsing and a command
-  line help. See below for more info.<P>
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="TDECmdLineArgs">TDECmdLineArgs</A></H3>
-
-  TDECmdLineArgs is a new class that handles command line parsing and
-  command line help. It is now required that your application
-  specifies at least:<P>
-  <UL>
-	<LI>Its name.
-	<LI>A short description what it does. (e.g. 1 line)
-	<LI>A version.
-	<LI>All command line options that it supports.
-  </UL>
- 
-  TDECmdLineArgs itself will add the command line options supported by Qt 
-  and TDEApplication.<P>
-
-  You can also use the TDEAboutData class to specify name, description and 
-  version.<P>
-
-  In return for this information you can query TDECmdLineArgs whether an 
-  certain option was specified on the command line and your application 
-  now automatically supports --help and --version. It aborts with a
-  useful error message when the command line contains a syntax error.
-  See tdelibs/tdecore/tdecmdlineargs.h for more info.<P>
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="TDELocale">TDELocale</A></H3>
-
-  i18n is no longer a macro<P>
-
-  TDEApplication::getApplication()-&gt;getLocale()-&gt;translate<P>
-
-  but a function on its own. klocale is obsolete and replace every call
-  to klocale-&gt;translate with i18n.<P>
-
-  The return value of i18n is also no longer a const char*,
-  but a unicode TQString.<P>
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="TDEGlobal">TDEGlobal: access to KDE global objects.</A></H3>
-
-TDEGlobal allows centralized access to KDE global objects without including
-extraneous headers. object creation is deferred if possible.<P>
-
-All methods are static and headers for returned types are not included. You
-must have created a TDEApplication object before the methods can be used.<P>
-<TABLE BORDER="0">
-<TR>
-  <TD COLSPAN="2">
-    <PRE>
-      #include &lt;tdeglobal.h&gt;
-      #include &lt;tdeconfig.h&gt;      // Needed to use TDEConfig
-      #include &lt;tdelocale.h&gt;      // Needed to use TDELocale
-      #include &lt;kiconloader.h&gt;  // Needed to use TDEIconLoader
-    </PRE>
-  </TD>
-</TR>
-<TR>
-  <TD>
-    <PRE>
-    ...
-        	TDEConfig *appcfg = TDEGlobal::config();
-	        TQString mystr	 = i18n( "This is a string" );
-
-
-		TDEIconLoader *loader = TDEGlobal::iconLoader();
-    </PRE>
-  </TD>
-</TR>
-</TABLE>
-
-<H4><P ALIGN="RIGHT"><A HREF="#TOC">Return to the Table of Contents</A></P></H4>
-
-<H3><A NAME="TDEIconLoader">TDEIconLoader</A></H3>
-
-TDEIconLoader in 1.1 used to mix icons for applications and for toolbars.
-This has changed, so you may notice that your application doesn't find
-the right icons. loadIcon (used by BarIcon) returns only toolbar icons.<P>
-If you need icons for applications, use loadApplicationIcon.<P>
-loadMiniIcon and loadApplicationMiniIcon have been removed, instead
-loadApplicationIcon now takes a "size" argument where you can specify the
-size of the icon (small, medium, large).<P>
-The other big change you may notice, is that ICON and Icon have been
-removed as they caused big confusion for not loading application icons
-(see above). For this we added BarIcon which does the same as ICON before.
-The third change in this row is that loadIcon doesn't need the extension
-anymore, but looks for standard extensions (png, xpm) itself. If you hard-
-coded .xpm, loadIcon will issue a warning at runtime, but will still work
 ** Diff limit reached (max: 250 lines) **