From 5159cd2beb2e87806a5b54e9991b7895285c9d3e Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 27 Jan 2013 01:04:16 -0600 Subject: Rename a number of libraries and executables to avoid conflicts with KDE4 --- tdeconf_update/CMakeLists.txt | 34 ++ tdeconf_update/Mainpage.dox | 31 ++ tdeconf_update/Makefile.am | 33 ++ tdeconf_update/README.tdeconf_update | 251 +++++++++ tdeconf_update/tdeconf_update.cpp | 959 +++++++++++++++++++++++++++++++++++ 5 files changed, 1308 insertions(+) create mode 100644 tdeconf_update/CMakeLists.txt create mode 100644 tdeconf_update/Mainpage.dox create mode 100644 tdeconf_update/Makefile.am create mode 100644 tdeconf_update/README.tdeconf_update create mode 100644 tdeconf_update/tdeconf_update.cpp (limited to 'tdeconf_update') diff --git a/tdeconf_update/CMakeLists.txt b/tdeconf_update/CMakeLists.txt new file mode 100644 index 000000000..fffb66e80 --- /dev/null +++ b/tdeconf_update/CMakeLists.txt @@ -0,0 +1,34 @@ +################################################# +# +# (C) 2010 Serghei Amelian +# serghei (DOT) amelian (AT) gmail.com +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +include_directories( + ${TQT_INCLUDE_DIRS} + ${CMAKE_BINARY_DIR}/tdecore + ${CMAKE_SOURCE_DIR}/tdecore +) + +link_directories( + ${TQT_LIBRARY_DIRS} +) + + +##### tdeconf_update ############################## + +set( target tdeconf_update ) + +set( ${target}_SRCS + tdeconf_update.cpp +) + +tde_add_tdeinit_executable( ${target} AUTOMOC + SOURCES ${${target}_SRCS} + LINK tdecore-shared +) diff --git a/tdeconf_update/Mainpage.dox b/tdeconf_update/Mainpage.dox new file mode 100644 index 000000000..2557fe1c0 --- /dev/null +++ b/tdeconf_update/Mainpage.dox @@ -0,0 +1,31 @@ +/** @mainpage ./tdeconf_update + +tdeconf_update is a tool designed to update config files. Over time applications +sometimes need to rearrange the way configuration options are stored. Since +such an update shouldn't influence the configuration options that the user +has selected, the application must take care that the options stored in the +old way will still be honored. + +What used to happen is that the application looks up both the old and the +new configuration option and then decides which one to use. This method has +several drawbacks: +- The application may need to read more configuration files than strictly + needed, resulting in a slower startup. +- The application becomes bigger with code that will only be used once. + +tdeconf_update addresses these problems by offering a framework to update +configuration files without adding code to the application itself. + +See the README file for more information. + +@authors +Waldo Bastian \ + +@maintainers +[Unknown/None] + +@licenses +@lgpl + +*/ +// vim:ts=4:sw=4:expandtab:filetype=doxygen diff --git a/tdeconf_update/Makefile.am b/tdeconf_update/Makefile.am new file mode 100644 index 000000000..9041aad8a --- /dev/null +++ b/tdeconf_update/Makefile.am @@ -0,0 +1,33 @@ +# This file is part of the KDE libraries +# Copyright (C) 2001 Waldo Bastian + +# 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. + +INCLUDES= -I../kded $(all_includes) + +bin_PROGRAMS = +lib_LTLIBRARIES = +tdeinit_LTLIBRARIES = tdeconf_update.la + +tdeconf_update_la_SOURCES = tdeconf_update.cpp +tdeconf_update_la_LIBADD = $(LIB_TDECORE) $(LIB_QT) +tdeconf_update_la_LDFLAGS = $(all_libraries) -module -avoid-version + +METASOURCES = AUTO + +# Internal +# noinst_HEADERS = tdeconf_update.h + diff --git a/tdeconf_update/README.tdeconf_update b/tdeconf_update/README.tdeconf_update new file mode 100644 index 000000000..340f71eaa --- /dev/null +++ b/tdeconf_update/README.tdeconf_update @@ -0,0 +1,251 @@ +README tdeconf_update + +Version: 1.1 +Author: Waldo Bastian , + +What it does +============ + +tdeconf_update is a tool designed to update config files. Over time applications +sometimes need to rearrange the way configuration options are stored. Since +such an update shouldn't influence the configuration options that the user +has selected, the application must take care that the options stored in the +old way will still be honored. + +What used to happen is that the application looks up both the old and the +new configuration option and then decides which one to use. This method has +several drawbacks: +* The application may need to read more configuration files than strictly +needed, resulting in a slower startup. +* The application becomes bigger with code that will only be used once. + +tdeconf_update addresses these problems by offering a framework to update +configuration files without adding code to the application itself. + + +How it works +============ + +Applications can install so called "update files" under +$TDEDIR/share/apps/tdeconf_update. An update file has ".upd" as extension and +contains instructions for transferring/converting configuration information +from one place to another. + +Updating the configuration happens automatically, either when KDE gets started +or when kded detects a new update file in the above mentioned location. + +Update files are separated into sections. Each section has an Id. When a +section describing a configuration change has been applied, the Id will be +stored in the file "tdeconf_updaterc". This information is used to make sure +that a configuration update is only performed once. + +If you overwrite an existing update file with a new version that contains a +new section, only the update instructions from this extra section will be +performed. + +File format of the update file +============================== + +Empty lines or lines that start with '#' are considered comments. +Commas (,) are used to seperate fields and may not occur as part +of any field and all of the keywords are case-sensitive, i.e. you +cannot say "key" instead of "Key" for example. + +For the rest the file is parsed and executed sequentially from top to bottom. +Each line can contain one entry. The following entries are recognized: + + +Id= + +With identifying the group of update entries that follows. Once a group +of entries have been applied, their is stored and this group of entries +will not be applied again. + + +File=, +File= + +Specifies that configuration information is read from and written +to . If you only specify , the information is read from +as well as written to . + +Script=