Finish renaming tdevelop components

1 files changed, 219 insertions, 0 deletions

diff --git a/lib/interfaces/tdevproject.h b/lib/interfaces/tdevproject.h
new file mode 100644
index 00000000..fa320edf
--- /dev/null
+++ b/lib/interfaces/tdevproject.h
@@ -0,0 +1,219 @@
+/* This file is part of the KDE project
+   Copyright (C) 2001 Matthias Hoelzer-Kluepfel <hoelzer@kde.org>
+   Copyright (C) 2001-2002 Bernd Gehrmann <bernd@kdevelop.org>
+   Copyright (C) 2002-2003 Roberto Raggi <roberto@kdevelop.org>
+   Copyright (C) 2002 Simon Hausmann <hausmann@kde.org>
+   Copyright (C) 2003 Jens Dagerbo <jens.dagerbo@swipnet.se>
+   Copyright (C) 2003 Mario Scalas <mario.scalas@libero.it>
+   Copyright (C) 2003-2004 Alexander Dymo <adymo@kdevelop.org>
+
+   This library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Library General Public
+   License as published by the Free Software Foundation; either
+   version 2 of the License, or (at your option) any later version.
+
+   This library is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+   Library General Public License for more details.
+
+   You should have received a copy of the GNU Library General Public License
+   along with this library; see the file COPYING.LIB.  If not, write to
+   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+   Boston, MA 02110-1301, USA.
+*/
+#ifndef TDEVPROJECT_H
+#define TDEVPROJECT_H
+
+#include "tdevplugin.h"
+#include "domutil.h"
+
+#include <tqstringlist.h>
+#include <tqmap.h>
+
+/**
+@file tdevproject.h
+KDevelop project interface.
+*/
+
+class TQTimer;
+
+/**
+KDevelop project interface.
+Plugins implementing the TDevProject interfaces are used to manage projects.
+
+Project can be considered as a way of grouping files (in text editors) or
+as a way of providing support for a build system (like it is done in TDevelop IDE buildtools).
+*/
+class TDevProject: public TDevPlugin
+{
+    Q_OBJECT
+    
+public:
+    /**Constructs a project plugin.
+    @param info Important information about the plugin - plugin internal and generic
+    (GUI) name, description, a list of authors, etc. That information is used to show
+    plugin information in various places like "about application" dialog, plugin selector
+    dialog, etc. Plugin does not take ownership on info object, also its lifetime should
+    be equal to the lifetime of the plugin.
+    @param parent The parent object for the plugin. Parent object must implement @ref TDevApi
+    interface. Otherwise the plugin will not be constructed.
+    @param name The internal name which identifies the plugin.*/
+    TDevProject(const TDevPluginInfo *info, TQObject *parent=0, const char *name=0);
+    /**Destructor.*/
+    virtual ~TDevProject();
+
+    /**Options of the project plugin.*/
+    enum Options {
+        UsesOtherBuildSystem = 0        /**<Project uses unknown or unspecified build system or build system is not used at all.*/,
+        UsesAutotoolsBuildSystem = 1    /**<Project uses autotools for building.*/,
+        UsesTQMakeBuildSystem =2         /**<Project uses qmake for building.*/
+    };
+
+    /**This method is invoked when the project is opened
+    (i.e. actually just after this class has been
+    instantiated).
+    @param dirName The project directory, which should afterwards be returned by
+    the projectDirectory() method.
+    @param projectName The project name, which is equivalent
+    to the project file name without the suffix.*/
+    virtual void openProject(const TQString &dirName, const TQString &projectName);
+
+    /**This method is invoked when the project is about to be closed.*/
+    virtual void closeProject() = 0;
+
+    /**Reimplement this method to set project plugin options. Default implementation
+    returns TDevProject::UsesOtherBuildSystem.*/
+    virtual Options options() const;
+
+    /**@return The canonical absolute directory of the project. Canonical means that
+    a path does not contain symbolic links or redundant "." or ".." elements.*/
+    virtual TQString projectDirectory() const = 0;
+
+    /**Returns the name of the project.*/
+    virtual TQString projectName() const = 0;
+
+    /**@return The environment variables that sould be set before running mainProgram().*/
+    virtual DomUtil::PairList runEnvironmentVars() const = 0;
+
+    /**@return The path to main binary program of the project.
+    @param relative if true then the path returned is relative to the project directory.*/
+    virtual TQString mainProgram() const = 0;
+
+    /**Absolute path (directory) from where the mainProgram() should be run.*/
+    virtual TQString runDirectory() const = 0;
+
+    /**The command line arguments that the mainProgram() should be run with.*/
+    virtual TQString runArguments() const = 0;
+
+    /**The command line arguments that the mainProgram() should be debugged with.*/
+    virtual TQString debugArguments() const = 0;
+
+    /**Returns the path (relative to the project directory)
+    of the active directory. All newly automatically generated
+    classes and files are usually added here.*/
+    virtual TQString activeDirectory() const = 0;
+
+    /**@return The canonical build directory of the project.
+    If the separate build directory is not supported, this should
+    return the same as projectDiretory(). Canonical means that
+    a path does not contain symbolic links or redundant "." or ".." elements.*/
+    virtual TQString buildDirectory() const = 0;
+
+    /**@return The list of all files in the project. The names are relative to
+    the project directory.*/
+    virtual TQStringList allFiles() const = 0;
+
+    /**@return The list of files that are part of the distribution but not under
+    project control. Used mainly to package and publish extra files among with the project.*/
+    virtual TQStringList distFiles() const = 0;
+
+    /**Adds a list of files to the project. Provided for convenience when adding many files.
+    @param fileList The list of file names relative to the project directory.*/
+    virtual void addFiles(const TQStringList &fileList) = 0;
+
+    /**Adds a file to the project.
+    @param fileName The file name relative to the project directory.*/
+    virtual void addFile(const TQString &fileName)= 0;
+
+    /**Removes a list of files from the project. Provided for convenience when removing many files.
+    @param fileList The list of file names relative to the project directory.*/
+    virtual void removeFiles(const TQStringList& fileList)= 0;
+
+    /**Removes a file from the project.
+    @param fileName The file name relative to the project directory.*/
+    virtual void removeFile(const TQString &fileName) = 0;
+
+    /**Notifies the project about changes to the files. Provided for
+    convenience when changing many files.
+    @param fileList The list of file names relative to the project directory..*/
+    virtual void changedFiles(const TQStringList &fileList);
+
+    /**Notifies the project of a change to one of the files.
+    @param fileName The file name relative to the project directory.*/
+    virtual void changedFile(const TQString &fileName);
+
+    /**@return true if the file @p absFileName is a part of the project.
+    @param absFileName Absolute name of a file to check.*/
+    virtual bool isProjectFile(const TQString &absFileName);
+
+    /**@return The path (relative to the project directory) of the file @p absFileName.
+    @param absFileName Absolute name of a file.*/
+    virtual TQString relativeProjectFile(const TQString &absFileName);
+
+    /**@return The list of files known to the project through symlinks.*/
+    virtual TQStringList symlinkProjectFiles();
+
+protected:
+
+    /** Default implementation of runDirectory method.
+     *  Uses 'projectPluginName' to obtain configuration from
+     *  project DOM and returns:
+     *
+     *   if /<projectPluginName>/run/directoryradio == executable
+     *        The directory where the executable is.
+     *   if /<projectPluginName>/run/directoryradio == build
+     *        The build directory.
+     *   if /kdevautoproject/run/directoryradio == custom
+     *        The custom directory absolute path.
+     * Derived classes are supposed to explicitly call this implementation
+     */
+    TQString defaultRunDirectory(const TQString& projectPluginName) const;
+
+private slots:
+    void buildFileMap();
+    void slotBuildFileMap();
+    void slotAddFilesToFileMap(const TQStringList & fileList );
+    void slotRemoveFilesFromFileMap(const TQStringList & fileList );
+
+signals:
+    /**Emitted when a new list of files has been added to the
+    project. Provided for convenience when many files were added.
+    @param fileList The file names relative to the project directory.*/
+    void addedFilesToProject(const TQStringList& fileList);
+
+    /**Emitted when a list of files has been removed from the project.
+    Provided for convenience when many files were removed.
+    @param fileList The file names relative to the project directory.*/
+    void removedFilesFromProject(const TQStringList& fileList);
+
+    /**Emitted when a list of files has changed in the project.
+    @param fileList The file names relative to the project directory.*/
+    void changedFilesInProject(const TQStringList& fileList);
+
+    /**Emitted when one compile related command (make, make install, make ...) ends sucessfuly.
+    Used to reparse the files after a sucessful compilation.*/
+    void projectCompiled();
+
+    /**Emitted when the active directory of the project changes
+     * @param olddir The old active directory
+     * @param newdir The new active directory
+     */
+    void activeDirectoryChanged( const TQString& olddir, const TQString& newdir );
+
+private:
+    class Private;
+    Private *d;
+};
+
+#endif