Giter Site home page Giter Site logo

drfiemost / kdelibs Goto Github PK

View Code? Open in Web Editor NEW

This project forked from kde/kdelibs

0.0 1.0 0.0 162.88 MB

The KDE4 Library

License: Other

Emacs Lisp 0.01% CMake 2.42% HTML 0.50% Shell 0.04% Python 0.17% C++ 93.66% C 1.66% QML 0.01% Perl 0.37% Lex 0.03% Yacc 0.21% CSS 0.05% Objective-C 0.03% XSLT 0.11% Java 0.46% JavaScript 0.23% QMake 0.01% Ruby 0.05% Roff 0.01% Jolie 0.01%

kdelibs's Introduction

In this file:

* About kdelibs
* Licensing
* Common Mistakes
* Upgrading
* Compile Problems
* More Info


About kdelibs
-------------
This is version 4.14.38 of the KDE libraries.

This package includes libraries that are central to the development and
execution of a KDE program, as well as internationalization files for these
libraries, misc HTML documentation, theme modules, and regression tests.

Here is an alphabetical list of all individual libraries:

* dnssd
    Interface to the DNS-SD (Zeroconf) support.

* interfaces
    kparts interface for text editors, mediaplayer and scripting.

* kate
    KPart for 'kate', the KDE advanced text editor.

* kde3support
    This contains libraries that were part of KDE3, but have been replaced for KDE4

* kdecore
    This is the core collection of KDE stuff. Non GUI classes reside here.

* kdesu
    Library for password entering and handling

* kdeui
    The main collection of misc. user interface classes (widgets).

* kdewidgets
    For developers: KDE's custom widgets for Qt Designer.

* kfile
    File management widgets and dialogs.

* khtml
    The next generation HTML rendering widget designed for Konqueror.  This
    supports HTML 4, CSS, and a variety of other web related standards.

* kimgio
    An all purpose extension to the qimgio class that supports various
    image formats.

* kio
    Classes that fetch and decode URLs are contained here. This library also
    contains "ksycoca", the system configure cache containing services,
    applications, servicetypes and mimetypes.

* kjs
    Implementation of ECMAScript (aka JavaScript).

* kjsembed
    A binding of the ECMAScript language to interface with KDE code.

* knewstuff
    Allows applications to easily download data from the Internet to add
    new information to the program. e.g. wallpapers, translation packs, etc.

* knotify
    Handles user notifications, including sounds, logging to files, etc.

* kparts
    KDE component model.

* kpty
    Abstraction layer for virtual consoles.

* kross
    Scripting host for KDE applications.

* kutils
    Utility library for printing, chatting and more.

* nepomuk
    Semantic information retrieval and tagging.

* plasma
    Framework for the KDE 4 desktop shell and its widgets.

* security
    Certificate management and cryptography settings.

* solid
    Hardware detection.

* sonnet
    Tools for natural language processing, including spell and grammar check.
    Includes gui widgets.

* threadweaver
    Job-based threading library.

And here is an alphabetical list of all further parts of kdelibs:

* cmake
    Build system used throughout KDE.

* doc
    Documentation in docbook format.

* includes
    Qt-style include file wrappers.

* kconf_update
    Auto-Updater for config files.

* kded
    The KDE daemon checks for newly installed software, update files
    or hostname changes and takes according actions.

* kdoctools
    Contains mostly stuff convert XML docbook files via XSLT into
    human readable stuff.

* kioslave
    I/O subprocesses to handle files, ftp, http, gzip and bzip2 streams.

* kinit
    Process launcher (kdeinit), used for fast KDE startup and to launch kioslaves.

* licenses
    Contains texts of all used licenses.

* mimetypes
    Database of mime types.

Licensing
---------
The libraries themselves have been covered (since Saturday, June 21st, 1997)
by the GNU Library General Public License (LGPL). Any other programs (such
as the examples) are covered by the GNU General Public License (GPL). All
the gory details for the LGPL reside in COPYING.LIB, and for the GPL reside
in COPYING.

Various parts are also covered under a BSD style license, detailed in
licenses/BSD. Currently, code covered under such license is copyrighted by
Theo de Raadt.

When in doubt, check the individual file, they should all have license
headings and other identifying marks.


Common Mistakes
---------------
If cmake claims Qt cannot be found, look at http://qt.nokia.com/
to get a copy of Qt, version 4.7 or newer. If you have peeked there
already, grab the SVN module qt-copy from anonsvn.kde.org, or a snapshot
thereof.  Alternatively the svn module qt-copy from svn.kde.org can also be
used.

If you know you have the latest Qt 4,  another reason it may not be able to
'find' QT is because it's finding an older version of QT 4.  Make sure that
your PATH is set appropriately  to find the qmake from the latest Qt 4, and
LD_LIBRARY_PATH is set to include $QTDIR/lib.

Debugging
---------
You can set the CMAKE_BUILD_TYPE option with the cmake, if you want to have
debug code in your KDE libs. If you have the space and can stand code that's
somewhat slower, this is worth it. The extra information really
helps debugging and thus bugfixing.

Available options as of CMake 2.4.5:
 Release:        Compile with no debugging information, optimization enabled.
 Debug:          Minimal optimization, with debugging information.
 RelWithDebInfo: Normal optimization, with debugging information.
 MinSizeRel:     No debugging information, with optimization for smallest size.

e.g.: "cmake -DCMAKE_BUILD_TYPE=Debug" when running cmake.

See also the file DEBUG.


Upgrading
---------
KDE 4 applications will try to migrate settings from your KDE 3 installation
where possible.


Compile Problems
----------------
Often, KDE compile failures are not KDE's fault, but the fault of the
compiler or the distribution used. For that reason, please have a look at
http://techbase.kde.org/Getting_Started/Build/FAQ for known issues in certain
OS environments before reporting bugs or going mad :).

KDE 4 requires gcc 3.3 or better as the compiler.

How to report
-------------
Reporting bugs is an art. Why?  Because bug reports can help and hinder.

They hinder if the developers are just buried in an avalanche of bug reports.
They spend hours figuring out which bug reports are valid and which aren't,
which bug reports are due to bugs or due to installation problems.

They can be of tremendous help to notify developers on problems in areas that
they normally don't have access (e.g. KDE on AIX) to.

So, here are some tips on bug reporting:

* Make sure your bug is due to KDE ... and not due to a packaging problem of
  your OS distributor. For example, most "I can not install the XYZ.rpm"
  problem are due to packaging issues. Refer with such questions to your
  OS Distributor and his appropriate mailing list or bug reporting tool.

* The chance is high that your bug has already been dealt with ... so look
  if there is a newer version of kdelibs available. Reporting bugs for
  older, deprecated versions usually don't get that much attention :-)

* Also the chance is high that another one experienced your problem. The
  bug report wizard at http://bugs.kde.org/ will help you to find out if your
  problem has already been reported.

* KDE Applications come with a Report Bug option in the Help menu that will
  fill out many of the forms on the bug reporter tool at http://bugs.kde.org/
  for you.

* The best bug report for a project based on voluntary work is of course one
  that comes with a patch that solves the problem. :-)


More info
---------
http://www.kde.org/ is a good starting point for info on KDE. If you are a
developer, you may also point your browser to http://techbase.kde.org/.
There is a plethora of mailing lists available, you can gain an overview
quickly by looking at http://lists.kde.org/.

kdelibs's People

Contributors

adriaandegroot avatar ahartmetz avatar aseigo avatar carewolf avatar chehrlic avatar christoph-cullmann avatar coolo avatar cpfeiffer avatar dfaure avatar dhaumann avatar ehamberg avatar er-vin avatar ereslibre avatar llunak avatar mattkretz avatar montel avatar neundorf avatar notmart avatar ossilator avatar rhabacker avatar staniek avatar steveire avatar swesterfeld avatar thiagomacieira avatar tokoe avatar tronical avatar trueg avatar tsdgeos avatar uwolfer avatar winterz avatar

Watchers

 avatar

kdelibs's Issues

Remove deprecated stuff

Check KDE_NO_DEPRECATED

i.e.

  • KArrowButton
  • KEditListBox (used in k3b, libkcddb and lokalize)
  • KDiskFreeSpace
  • KMimeTypeResolver
  • KLibLoader
  • KCrashBookmarkImporter
  • ...

kdelibs/dnssd
ServiceTypeBrowser::isRunning

kdelibs/kparts
BrowserRun::askSave
BrowserRun::askEmbedOrSave
Plugin::loadPlugin( QObject * parent, const char* libname )
Plugin::loadPlugin( QObject * parent, const QByteArray &libname )

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.