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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

17 files changed, 344 insertions, 0 deletions

diff --git a/kdoctools/customization/tr/catalog b/kdoctools/customization/tr/catalog
new file mode 100644
index 000000000..ae049f70c
--- /dev/null
+++ b/kdoctools/customization/tr/catalog
@@ -0,0 +1,36 @@
+PUBLIC "-//KDE//ENTITIES Turkish Documentation V1.0//TR"
+       "lang.entities"
+
+PUBLIC "-//KDE//DOCUMENT GNU Free Documentation Notice//TR"
+       "entities/fdl-notice.docbook"
+PUBLIC "-//KDE//DOCUMENT GNU General Public License Notice//TR"
+       "entities/gpl-notice.docbook"
+PUBLIC "-//KDE//DOCUMENT GNU Lesser General Public License Notice//TR"
+       "entities/lgpl-notice.docbook"
+
+PUBLIC "-//GNU//DOCUMENT GNU General Public License V2//TR"
+       "common/gpl-translated"
+PUBLIC "-//GNU//DOCUMENT GNU Lesser General Public License V2.1//TR"
+       "common/lgpl-translated"
+PUBLIC "-//GNU//DOCUMENT GNU Free Documentation License V1.1//TR"
+       "common/fdl-translated"
+PUBLIC "-//KDE//DOCUMENT GPL Licence Declaration//TR"
+       "entities/underGPL.docbook" 
+PUBLIC "-//KDE//DOCUMENT FDL Licence Declaration//TR"
+       "entities/underFDL.docbook"
+PUBLIC "-//KDE//DOCUMENT BSD Licence Declaration//TR"
+       "entities/underBSDLicense.docbook"
+PUBLIC "-//KDE//DOCUMENT Artistic Licence Declaration//TR"
+       "entities/underArtisticLicense.docbook"
+PUBLIC "-//KDE//DOCUMENT X11 Licence Declaration//TR"
+       "entities/underX11License.docbook"
+PUBLIC "-//KDE//DOCUMENT Report Bugs//TR"
+       "entities/report-bugs.docbook"
+PUBLIC "-//KDE//DOCUMENT Updating Documentation//TR"
+       "entities/update-doc.docbook"
+PUBLIC "-//KDE//DOCUMENT Help Menu Documentation//TR"
+       "entities/help-menu.docbook"
+PUBLIC "-//KDE//DOCUMENT Installation General Information//TR"
+       "entities/install-intro.docbook"
+PUBLIC "-//KDE//DOCUMENT Compilation Instructions//TR"
+       "entities/install-compile.docbook"
diff --git a/kdoctools/customization/tr/entities/fdl-notice.docbook b/kdoctools/customization/tr/entities/fdl-notice.docbook
new file mode 100644
index 000000000..abf10aba6
--- /dev/null
+++ b/kdoctools/customization/tr/entities/fdl-notice.docbook
@@ -0,0 +1,55 @@
+<!-- This file can be used to include the notice in documentation
+     <!DOCTYPE book ... [
+      <!ENTITY % FDLIS "INCLUDE">
+      <!ENTITY FDLISTitles "title 1, title 2, title 3">
+      <!ENTITY % FDLFCT "INCLUDE">
+      <!ENTITY FDLFCTTitles "title 4, title 5, title 6">
+      <!ENTITY % FDLBCT "INCLUDE">
+      <!ENTITY FDLBCTTitles "title 7, title 7b">
+      <!ENTITY % ents "-//KDE//ENTITIES Application-Variable Entities V1.0//EN">
+      %ents;
+      ...
+     ]>
+    ...
+     <bookinfo>
+       <legalnotice>
+         <para>Copyright (C) 20yy  [name of author]</para>
+         &FDLnotice;
+       </legalnotice>
+     </bookinfo>
+    ...
+
+    Alternatively, you can include the text literally.
+
+    Include a copy of the license in the documentation distribution.
+ -->
+<para>
+Bu belgeyi kopyalama, da��tma ve/veya de�i�tirme izni GNU Serbest Belge Lisans� (GFDL),
+S�r�m 1.1 veya Free Software Foundation taraf�ndan daha sonra yay�nlanan
+herhangi bir s�r�m alt�nda, &FDLInvariantSections;, &FDLFrontCoverText; ve
+&FDLBackCoverText; ile verilmektedir. Lisans�n bir kopyas� <xref linkend="gnu-fdl"/> ba��ndan
+bulunabilir.
+</para>
+
+<!-- If you have no Invariant Sections, don't add any FDLIS entities.
+     If you have no Front-Cover Texts, don't add any FDLFCT; likewise
+     for Back-Cover Texts (the SGML setup takes care of complying with
+     the GNU requirements).  Adding the entities: if you use any, then
+     add FDL* with value "INCLUDE" and FDL*Titles with a list of
+     titles.  You will get the default GNU template text if you don't
+     specify the FDL*Titles entity after specifying the FDL* entity.
+     This will only have effect when you specify %FDLSlots; _after_
+     the entity definitions.
+
+     If your document contains nontrivial examples of program code, we
+     recommend releasing these examples in parallel under your choice
+     of free software license, such as the GNU General Public License,
+     to permit their use in free software.
+ -->
+<!--
+Local variables:
+mode: sgml
+sgml-general-insert-case: lower
+sgml-parent-document: ("index.docbook" "book" "bookinfo" "legalnotice" "para")
+End:
+-->
diff --git a/kdoctools/customization/tr/entities/gpl-notice.docbook b/kdoctools/customization/tr/entities/gpl-notice.docbook
new file mode 100644
index 000000000..1883bea86
--- /dev/null
+++ b/kdoctools/customization/tr/entities/gpl-notice.docbook
@@ -0,0 +1,33 @@
+<!-- This file can be used to include the notice in documentation
+     <!DOCTYPE book ... >
+    ...
+     <bookinfo>
+       <legalnotice>
+         <para>Copyright (C) 20yy  [name of author]</para>
+         &GPLnotice;
+       </legalnotice>
+     </bookinfo>
+    ...
+
+    Alternatively, you can include the text literally.
+ -->
+<para> Bu, bir serbest; bu yaz�l�m� Free Software Foundation taraf�ndan
+yay�nlanan GNU Genel Kamu Lisans�'n�n (GPL) ikinci s�r�m� veya daha �st s�r�mlerinin
+�artlar�na ba�l� olarak de�i�tirebilir veya yeniden da��tabilirsiniz. </para>
+
+<para>Bu yaz�l�m faydal� olaca�� �mit edilerek fakat HERHANG� B�R GARANT�
+vermeksizin da��t�lmaktad�r. SATILAB�L�RL��� veya HERHANG� B�R AMACA UYGUNLU�U i�in
+z�mni garanti dahi ta��maz. Daha fazla bilgi i�in GNU  Genel Kamu Lisans�'na
+bak�n�z. </para>
+
+<para>Bu yaz�l�mla beraber GNU Genel Kamu Lisans�'n�n bir kopyas�n� alm��
+olmal�s�n�z; e�er almam��san�z l�tfen a�a��daki adrese yaz�n:  Free
+Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+02110-1301 USA</para>
+
+<!--
+Local variables:
+mode: sgml
+sgml-general-insert-case: lower
+End:
+-->
diff --git a/kdoctools/customization/tr/entities/help-menu.docbook b/kdoctools/customization/tr/entities/help-menu.docbook
new file mode 100644
index 000000000..7b10f52a6
--- /dev/null
+++ b/kdoctools/customization/tr/entities/help-menu.docbook
@@ -0,0 +1,58 @@
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul"><keycap>F1</keycap></keycombo>
+</shortcut>
+<guimenu>Help</guimenu>
+<guimenuitem>Contents...</guimenuitem>
+</menuchoice>
+</term>
+<listitem><para><action>Invokes the KDE Help system</action> starting at the
+&kappname; help pages. (this document).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>
+</shortcut>
+<guimenu>Help</guimenu>
+<guimenuitem>What's This?</guimenuitem>
+</menuchoice>
+</term>
+<listitem><para><action>Changes the mouse cursor to a combination arrow and
+question mark.</action>  Clicking on items within &kappname; will open a help
+window (if one exists for the particular item) explaining the item's
+function.</para></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>Report Bug...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens the Bug report dialog</action> where you can
+report a bug or request a <quote>wishlist</quote> feature.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>About &kappname;</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>This will display version and author
+information.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>About KDE</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>This displays the KDE version and other basic
+information.</action></para></listitem>
+</varlistentry>
+</variablelist>
diff --git a/kdoctools/customization/tr/entities/install-compile.docbook b/kdoctools/customization/tr/entities/install-compile.docbook
new file mode 100644
index 000000000..dccdc4081
--- /dev/null
+++ b/kdoctools/customization/tr/entities/install-compile.docbook
@@ -0,0 +1,12 @@
+<para>In order to compile and install &kappname; on your system, type the
+following in the base directory of the &kappname; distribution:</para>
+
+<screen><prompt>%</prompt> <userinput><command>./configure</command></userinput>
+<prompt>%</prompt> <userinput><command>make</command></userinput>
+<prompt>%</prompt> <userinput><command>make</command> install</userinput>
+</screen>
+
+<para>Since &kappname; uses <command>autoconf</command> and
+<command>automake</command> you should have no trouble compiling it. Should you
+run into problems please report them to the &kde; mailing lists.</para>
+
diff --git a/kdoctools/customization/tr/entities/install-intro.docbook b/kdoctools/customization/tr/entities/install-intro.docbook
new file mode 100644
index 000000000..b6332c952
--- /dev/null
+++ b/kdoctools/customization/tr/entities/install-intro.docbook
@@ -0,0 +1,6 @@
+<!-- requires that packagename is defined in the documentation prologue -->
+<para>&kappname; is part of the &kde; project &kde-http;.</para>
+
+<para>&kappname; can be found in the &package; package on 
+&kde-ftp;, the main &FTP; site of the &kde;
+project.</para>
diff --git a/kdoctools/customization/tr/entities/lgpl-notice.docbook b/kdoctools/customization/tr/entities/lgpl-notice.docbook
new file mode 100644
index 000000000..fceef772c
--- /dev/null
+++ b/kdoctools/customization/tr/entities/lgpl-notice.docbook
@@ -0,0 +1,32 @@
+<!-- This file can be used to include the notice in documentation
+     <!DOCTYPE book ... >
+    ...
+     <bookinfo>
+       <legalnotice>
+         <para>Copyright (C) 20yy  [name of author]</para>
+         &LGPLnotice;
+       </legalnotice>
+     </bookinfo>
+    ...
+
+    Alternatively, you can include the text literally.
+ -->
+<para>Bu kitapl�k serbest yaz�l�md�r; bu kitapl��� Free Software Foundation taraf�ndan
+yay�nlanan GNU Kitapl�k Genel Kamu Lisans�'n�n (LGPL) ikinci s�r�m� veya daha �st s�r�mlerinin
+�artlar�na ba�l� olarak de�i�tirebilir veya yeniden da��tabilirsiniz. </para>
+
+<para>Bu kitapl�k faydal� olaca�� �mit edilerek fakat HERHANG� B�R GARANT�
+vermeksizin da��t�lmaktad�r. SATILAB�L�RL��� veya HERHANG� B�R AMACA UYGUNLU�U i�in
+z�mni garanti dahi ta��maz. Daha fazla bilgi i�in GNU Kitapl�k Genel Kamu Lisans�'na
+bak�n�z. </para>
+
+<para>Bu kitapl�kla beraber GNU Kitapl�k Genel Kamu Lisans�'n�n bir kopyas�n� alm��
+olmal�s�n�z; e�er almam��san�z l�tfen a�a��daki adrese yaz�n:  Free
+Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+02110-1301 USA</para>
+<!--
+Local variables:
+mode: sgml
+sgml-general-insert-case: lower
+End:
+-->
diff --git a/kdoctools/customization/tr/entities/report-bugs.docbook b/kdoctools/customization/tr/entities/report-bugs.docbook
new file mode 100644
index 000000000..c9f2992f2
--- /dev/null
+++ b/kdoctools/customization/tr/entities/report-bugs.docbook
@@ -0,0 +1 @@
+<!-- -->
diff --git a/kdoctools/customization/tr/entities/underArtisticLicense.docbook b/kdoctools/customization/tr/entities/underArtisticLicense.docbook
new file mode 100644
index 000000000..9a5420bfe
--- /dev/null
+++ b/kdoctools/customization/tr/entities/underArtisticLicense.docbook
@@ -0,0 +1,2 @@
+<para>Bu yaz�l�m <ulink
+url="common/artistic-license.html">Sanatsal Lisans</ulink> alt�nda da��t�lmaktad�r.</para>
diff --git a/kdoctools/customization/tr/entities/underBSDLicense.docbook b/kdoctools/customization/tr/entities/underBSDLicense.docbook
new file mode 100644
index 000000000..9056ce150
--- /dev/null
+++ b/kdoctools/customization/tr/entities/underBSDLicense.docbook
@@ -0,0 +1,2 @@
+<para>Bu yaz�l�m, <ulink
+url="common/bsd-license.html">BSD Lisans�</ulink> alt�nda da��t�lmaktad�r.</para>
diff --git a/kdoctools/customization/tr/entities/underFDL.docbook b/kdoctools/customization/tr/entities/underFDL.docbook
new file mode 100644
index 000000000..a1ebad3a9
--- /dev/null
+++ b/kdoctools/customization/tr/entities/underFDL.docbook
@@ -0,0 +1,4 @@
+<para id="gnu-fdl" xreflabel="the section entitled &quot;GNU Free Documentation
+License&quot;">Bu belge <ulink
+url="common/fdl-license.html">GNU Serbest Belge Lisansı (GFDL)</ulink> altında
+dağıtılmaktadır.</para>
diff --git a/kdoctools/customization/tr/entities/underGPL.docbook b/kdoctools/customization/tr/entities/underGPL.docbook
new file mode 100644
index 000000000..74e7f95dd
--- /dev/null
+++ b/kdoctools/customization/tr/entities/underGPL.docbook
@@ -0,0 +1,3 @@
+<para>Bu yazılım <ulink
+url="common/gpl-translated.html">GNU Genel Kamu Lisansı</ulink>
+altında dağıtılmaktadır.</para>
diff --git a/kdoctools/customization/tr/entities/underX11License.docbook b/kdoctools/customization/tr/entities/underX11License.docbook
new file mode 100644
index 000000000..8a4eb397c
--- /dev/null
+++ b/kdoctools/customization/tr/entities/underX11License.docbook
@@ -0,0 +1,2 @@
+<para>Bu yaz�l�m <ulink
+url="common/x11-license.html">X11 Lisans�</ulink> alt�nda da��t�lmaktad�r.</para>
diff --git a/kdoctools/customization/tr/entities/update-doc.docbook b/kdoctools/customization/tr/entities/update-doc.docbook
new file mode 100644
index 000000000..6a98c74f5
--- /dev/null
+++ b/kdoctools/customization/tr/entities/update-doc.docbook
@@ -0,0 +1,4 @@
+<!--<para>Kurulumdan sonra bu belgenin g�ncel s�r�mleri ��km�� olabilir.
+<ulink
+url="http://docs.kde.org/page#&kappname;">http://docs.kde.org/page#&kappname;</ulink>
+adresine bakarak daha yeni bir s�r�m�n olup olmad���n� kontrol edin.</para> -->
diff --git a/kdoctools/customization/tr/lang.entities b/kdoctools/customization/tr/lang.entities
new file mode 100644
index 000000000..405b41421
--- /dev/null
+++ b/kdoctools/customization/tr/lang.entities
@@ -0,0 +1,47 @@
+<!ENTITY language "tr">
+
+<!-- These entities should be translated, should therefore be stored
+     separately. -->
+<!ENTITY % kde.translated
+                            SYSTEM "strings.entities"                >
+%kde.translated;
+
+<!-- The following entities should only use &kappname; in their 
+     text                                                          -->
+
+<!-- Licence links -->
+<!ENTITY underGPL           PUBLIC "-//KDE//DOCUMENT GPL Licence Declaration//TR"
+  "entities/underGPL.docbook"                       ><!-- level: para -->
+<!ENTITY underFDL           PUBLIC "-//KDE//DOCUMENT FDL Licence Declaration//TR"
+  "entities/underFDL.docbook"                       ><!-- level: para -->
+<!ENTITY underBSDLicense    PUBLIC "-//KDE//DOCUMENT BSD Licence Declaration//TR"
+  "entities/underBSDLicense.docbook"                ><!-- level: para -->
+<!ENTITY underArtisticLicense PUBLIC "-//KDE//DOCUMENT Artistic Licence Declaration//TR"
+  "entities/underArtisticLicense.docbook"           ><!-- level: para -->
+<!ENTITY underX11License    PUBLIC "-//KDE//DOCUMENT X11 Licence Declaration//TR"
+  "entities/underX11License.docbook"                ><!-- level: para -->
+
+<!ENTITY reporting.bugs     PUBLIC "-//KDE//DOCUMENT Report Bugs//TR"
+  "entities/report-bugs.docbook"                       ><!-- level: ? -->
+<!ENTITY updating.documentation PUBLIC "-//KDE//DOCUMENT Updating Documentation//TR"
+  "entities/update-doc.docbook"                     ><!-- level: para -->
+<!ENTITY help.menu.documentation PUBLIC "-//KDE//DOCUMENT Help Menu Documentation//TR"
+  "entities/help-menu.docbook"                      ><!-- level: variablelist -->
+<!ENTITY install.intro.documentation PUBLIC "-//KDE//DOCUMENT Installation General Information//TR"
+  "entities/install-intro.docbook"                     ><!-- level: para -->
+<!ENTITY install.compile.documentation PUBLIC "-//KDE//DOCUMENT Compilation Instructions//TR"
+  "entities/install-compile.docbook"                     ><!-- level: para -->
+
+
+
+<!-- FDL notice -->
+<!ENTITY FDLNotice PUBLIC "-//KDE//DOCUMENT GNU Free Documentation Notice//TR"
+         "entities/fdl-notice.docbook">
+<!-- meant to be included, so no NDATA or CDATA (why?) -->
+
+<!-- These entities may be extended by the authors and translators.
+     They should therefore be stored separately.  Moreover, they MUST
+     come last, to avoid overriding problems. -->
+<!ENTITY % kde.language.specific
+                            SYSTEM "user.entities"                   >
+%kde.language.specific;
diff --git a/kdoctools/customization/tr/strings.entities b/kdoctools/customization/tr/strings.entities
new file mode 100644
index 000000000..8288de1c6
--- /dev/null
+++ b/kdoctools/customization/tr/strings.entities
@@ -0,0 +1,39 @@
+<!-- These entities should be translated, but NOT CHANGED, NOR EXTENDED.
+     For language-specific extensions, use user.entities.
+     Translate everything between quotes, except names of general 
+     entities (&...;). -->
+
+<!ENTITY kappname "this application">
+<!-- Entities to fill in slots in docbook version of FDL notice.
+     The default values of the parameter entities is IGNORE. -->
+<![%FDLIS;[
+<!ENTITY FDLISTitles "LIST THEIR TITLES"><!-- keep capitals -->
+<!ENTITY FDLInvariantSections "the Invariant Sections being &FDLISTitles;">
+ ]]>
+<!ENTITY FDLInvariantSections "no Invariant Sections">
+<![%FDLFCT;[
+<!ENTITY FDLFCTTitles "LIST"><!-- keep capitals -->
+<!ENTITY FDLFrontCoverText "the Front-Cover Texts being &FDLFCTTitles;">
+ ]]>
+<!ENTITY FDLFrontCoverText "no Front-Cover Texts">
+<![%FDLBCT;[
+<!ENTITY FDLBCTTitles "LIST THEIR TITLES"><!-- keep capitals -->
+<!ENTITY FDLBackCoverText "the Back-Cover Texts being &FDLBCTTitles;">
+ ]]>
+<!ENTITY FDLBackCoverText "no Back-Cover Texts">
+
+<!-- modespec entity: must be adapted in accordance with the normal usage
+     for documents in a language; the most likely candidates are the value
+     of xreflabel (now %t for title of section referred to) and the content
+     (now empty).  If more than one format is needed, contact [email protected].
+     ** In general, this setup will not work with more than one language in 
+        a document **
+     Usage: in <bookinfo>
+     Only strictly needed when olinks are used
+ -->
+<!--ENTITY kde-modespec '<modespec id="kdems-default" xreflabel="&percnt;t"></modespec>'-->
+<!ENTITY kde.modespec '
+ <modespec id="kdems-help">help:</modespec>
+ <modespec id="kdems-man">man:</modespec>'>
+
+<!ENTITY olinktype "kde-installation">
diff --git a/kdoctools/customization/tr/user.entities b/kdoctools/customization/tr/user.entities
new file mode 100644
index 000000000..5f54ec661
--- /dev/null
+++ b/kdoctools/customization/tr/user.entities
@@ -0,0 +1,8 @@
+<!-- This file contains entities (only!) to make authoring/translating
+     a document easier.  They are necessarily language-specific.
+     In the case of name clashes, entities in this file always lose.
+     Keep the entities simple, but _always_ provide them with full markup.
+     Please keep the entities sorted on the name: it will avoid duplicate
+     names (which if they occur will cost you a _lot_ of time)
+ -->
+