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, 302 insertions, 0 deletions

diff --git a/kdoctools/customization/ru/catalog b/kdoctools/customization/ru/catalog
new file mode 100644
index 000000000..9a7f811b9
--- /dev/null
+++ b/kdoctools/customization/ru/catalog
@@ -0,0 +1,36 @@
+PUBLIC "-//KDE//ENTITIES Russian Documentation V1.0//RU"
+       "lang.entities"
+
+PUBLIC "-//KDE//DOCUMENT GNU Free Documentation Notice//RU"
+       "entities/fdl-notice.docbook"
+PUBLIC "-//KDE//DOCUMENT GNU General Public License Notice//RU"
+       "entities/gpl-notice.docbook"
+PUBLIC "-//KDE//DOCUMENT GNU Lesser General Public License Notice//RU"
+       "entities/lgpl-notice.docbook"
+
+PUBLIC "-//GNU//DOCUMENT GNU General Public License V2//RU"
+       "common/gpl-translated"
+PUBLIC "-//GNU//DOCUMENT GNU Lesser General Public License V2.1//RU"
+       "common/lgpl-translated"
+PUBLIC "-//GNU//DOCUMENT GNU Free Documentation License V1.1//RU"
+       "common/fdl-translated"
+PUBLIC "-//KDE//DOCUMENT GPL Licence Declaration//RU"
+       "entities/underGPL.docbook" />
+PUBLIC "-//KDE//DOCUMENT FDL Licence Declaration//RU"
+       "entities/underFDL.docbook"
+PUBLIC "-//KDE//DOCUMENT BSD Licence Declaration//RU"
+       "entities/underBSDLicense.docbook"
+PUBLIC "-//KDE//DOCUMENT Artistic Licence Declaration//RU"
+       "entities/underArtisticLicense.docbook"
+PUBLIC "-//KDE//DOCUMENT X11 Licence Declaration//RU"
+       "entities/underX11License.docbook"
+PUBLIC "-//KDE//DOCUMENT Report Bugs//RU"
+       "entities/report-bugs.docbook"
+PUBLIC "-//KDE//DOCUMENT Updating Documentation//RU"
+       "entities/update-doc.docbook"
+PUBLIC "-//KDE//DOCUMENT Help Menu Documentation//RU"
+       "entities/help-menu.docbook"
+PUBLIC "-//KDE//DOCUMENT Installation General Information//RU"
+       "entities/install-intro.docbook"
+PUBLIC "-//KDE//DOCUMENT Compilation Instructions//RU"
+       "entities/install-compile.docbook"
diff --git a/kdoctools/customization/ru/entities/fdl-notice.docbook b/kdoctools/customization/ru/entities/fdl-notice.docbook
new file mode 100644
index 000000000..e8c28c5de
--- /dev/null
+++ b/kdoctools/customization/ru/entities/fdl-notice.docbook
@@ -0,0 +1,12 @@
+<para>Разрешается копировать, распространять и/или изменять этот
+документ на условиях лицензии GNU для свободной документации,
+версии 1.1 или более поздней, опубликованной Фондом Free Software
+Foundation; без &FDLInvariantSections;, без &FDLFrontCoverText;,
+без &FDLBackCoverText;.  Копия лицензии находится здесь <xref linkend="gnu-fdl"/>.</para>
+<!--
+Local variables:
+mode: sgml
+sgml-general-insert-case: lower
+sgml-parent-document: ("index.docbook" "book" "bookinfo" "legalnotice" "para")
+End:
+-->
diff --git a/kdoctools/customization/ru/entities/gpl-notice.docbook b/kdoctools/customization/ru/entities/gpl-notice.docbook
new file mode 100644
index 000000000..e4bec3da8
--- /dev/null
+++ b/kdoctools/customization/ru/entities/gpl-notice.docbook
@@ -0,0 +1,23 @@
+<para>Данное приложение является свободным программным
+обеспечением. Вы можете его распространять и/или изменять
+на условиях общественной лицензии GNU GPL (General Public License)
+версии 2 или более
+поздней (по вашему усмотрению),
+опубликованной Фондом свободного программного обеспечения 
+(Free Software Foundation).</para>
+
+<para>Программа распространяется в расчёте на то, что она
+будет полезна, но без каких бы то ни было гарантий, в том числе гарантий её
+ценности или пригодности для любых конкретных задач. Подробнее об этом 
+можно прочитать в тексте лицензии GNU GPL.</para>
+
+<para>Копия лицензии GNU GPL должна распространяться с данной
+программой; если она отсутствует, сообщите об этом Фонду FSF по адресу:
+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/ru/entities/help-menu.docbook b/kdoctools/customization/ru/entities/help-menu.docbook
new file mode 100644
index 000000000..424ad9de2
--- /dev/null
+++ b/kdoctools/customization/ru/entities/help-menu.docbook
@@ -0,0 +1,61 @@
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul"><keycap>F1</keycap></keycombo>
+</shortcut>
+<guimenu>Помощь</guimenu>
+<guimenuitem>Содержание</guimenuitem>
+</menuchoice>
+</term>
+<listitem><para><action>Запускает Центр помощи KDE</action> и открывает
+справочное руководство по &kappname;. (Этот документ вы и читаете).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>
+</shortcut>
+<guimenu>Помощь</guimenu>
+<guimenuitem>Что это?</guimenuitem>
+</menuchoice>
+</term>
+<listitem><para><action>Вид курсора меняется на стрелочку со знаком
+вопроса.</action>  Нажимая на различные элементы внутри &kappname;,
+вы увидите подсказку с объяснениями назначения и действия
+данного элемента (если она для него существует).</para></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Помощь</guimenu>
+<guimenuitem>Сообщить об ошибке...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Открывается диалог отправки сообщения об ошибке</action>.
+Он служит для того, чтобы вы могли отправить сведения об обнаруженной
+вами ошибке в программе или свое <quote>пожелание</quote>, чтобы какая-либо
+пока что отсутствующая возможность была реализована
+в будущих версиях программы.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Помощь</guimenu>
+<guimenuitem>О программе &kappname;</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Будут выведены сведения о
+версии и авторах программы.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Помощь</guimenu>
+<guimenuitem>О KDE</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Будут выведены сведения о
+версии KDE.</action></para></listitem>
+</varlistentry>
+</variablelist>
diff --git a/kdoctools/customization/ru/entities/install-compile.docbook b/kdoctools/customization/ru/entities/install-compile.docbook
new file mode 100644
index 000000000..665b65aa3
--- /dev/null
+++ b/kdoctools/customization/ru/entities/install-compile.docbook
@@ -0,0 +1,13 @@
+<para>Чтобы собрать и установить &kappname;, введите следующие
+команды в каталоге дистрибутива &kappname;:</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>Поскольку &kappname; использует <command>autoconf</command> и
+<command>automake</command>, у вас не должно возникнуть никаких
+проблем. Если же у вас возникли ошибки, сообщите о них
+в списки рассылки &kde;.</para>
+
diff --git a/kdoctools/customization/ru/entities/install-intro.docbook b/kdoctools/customization/ru/entities/install-intro.docbook
new file mode 100644
index 000000000..8d796f239
--- /dev/null
+++ b/kdoctools/customization/ru/entities/install-intro.docbook
@@ -0,0 +1,5 @@
+<!-- requires that packagename is defined in the documentation prologue -->
+<para>&kappname; - это часть проекта &kde; &kde-http;.</para>
+
+<para>&kappname; входит в пакет &package; на &kde-ftp;, 
+основном &FTP;-сервере &kde;.</para>
diff --git a/kdoctools/customization/ru/entities/lgpl-notice.docbook b/kdoctools/customization/ru/entities/lgpl-notice.docbook
new file mode 100644
index 000000000..8c0c2263b
--- /dev/null
+++ b/kdoctools/customization/ru/entities/lgpl-notice.docbook
@@ -0,0 +1,23 @@
+<para>Данное приложение является свободным программным
+обеспечением. Вы можете его распространять и/или изменять
+на условиях общественной лицензии GNU LGPL (Lesser General Public License)
+версии 2 или более
+поздней (по вашему усмотрению),
+опубликованной Фондом свободного программного обеспечения 
+(Free Software Foundation).</para>
+
+<para>Программа распространяется в расчёте на то, что она
+будет полезна, но без каких бы то ни было гарантий, в том числе гарантий её
+ценности или пригодности для любых конкретных задач. Подробнее об этом 
+можно прочитать в тексте лицензии GNU LGPL.</para>
+
+<para>Копия лицензии GNU LGPL должна распространяться с данной
+программой; если она отсутствует, сообщите об этом Фонду FSF по адресу:
+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/ru/entities/report-bugs.docbook b/kdoctools/customization/ru/entities/report-bugs.docbook
new file mode 100644
index 000000000..c9f2992f2
--- /dev/null
+++ b/kdoctools/customization/ru/entities/report-bugs.docbook
@@ -0,0 +1 @@
+<!-- -->
diff --git a/kdoctools/customization/ru/entities/underArtisticLicense.docbook b/kdoctools/customization/ru/entities/underArtisticLicense.docbook
new file mode 100644
index 000000000..f8f1b4efc
--- /dev/null
+++ b/kdoctools/customization/ru/entities/underArtisticLicense.docbook
@@ -0,0 +1,2 @@
+<para>Программа распространяется на условиях <ulink
+url="common/artistic-license.html">Artistic License</ulink>.</para>
diff --git a/kdoctools/customization/ru/entities/underBSDLicense.docbook b/kdoctools/customization/ru/entities/underBSDLicense.docbook
new file mode 100644
index 000000000..72c5bfb13
--- /dev/null
+++ b/kdoctools/customization/ru/entities/underBSDLicense.docbook
@@ -0,0 +1,2 @@
+<para>Программа распространяется на условиях <ulink
+url="common/bsd-license.html">лицензии BSD</ulink>.</para>
diff --git a/kdoctools/customization/ru/entities/underFDL.docbook b/kdoctools/customization/ru/entities/underFDL.docbook
new file mode 100644
index 000000000..453ae9e48
--- /dev/null
+++ b/kdoctools/customization/ru/entities/underFDL.docbook
@@ -0,0 +1,4 @@
+<para id="gnu-fdl" xreflabel="the section entitled &quot;GNU Free Documentation License&quot;">
+Этот документ распространяется на условиях <ulink
+url="common/fdl-license.html">GNU Free Documentation
+License</ulink>.</para>
\ No newline at end of file
diff --git a/kdoctools/customization/ru/entities/underGPL.docbook b/kdoctools/customization/ru/entities/underGPL.docbook
new file mode 100644
index 000000000..ff75e7583
--- /dev/null
+++ b/kdoctools/customization/ru/entities/underGPL.docbook
@@ -0,0 +1,2 @@
+<para>Программа распространяется на условиях лицензии <ulink
+url="common/gpl-translated.html">GNU General Public License</ulink>.</para>
diff --git a/kdoctools/customization/ru/entities/underX11License.docbook b/kdoctools/customization/ru/entities/underX11License.docbook
new file mode 100644
index 000000000..c21388413
--- /dev/null
+++ b/kdoctools/customization/ru/entities/underX11License.docbook
@@ -0,0 +1,2 @@
+<para>Программа распространяется на условиях <ulink
+url="common/x11-license.html">лицензии X11</ulink>.</para>
diff --git a/kdoctools/customization/ru/entities/update-doc.docbook b/kdoctools/customization/ru/entities/update-doc.docbook
new file mode 100644
index 000000000..facc3735a
--- /dev/null
+++ b/kdoctools/customization/ru/entities/update-doc.docbook
@@ -0,0 +1 @@
+<!-- to be filled in -->
diff --git a/kdoctools/customization/ru/lang.entities b/kdoctools/customization/ru/lang.entities
new file mode 100644
index 000000000..74974ca5e
--- /dev/null
+++ b/kdoctools/customization/ru/lang.entities
@@ -0,0 +1,46 @@
+<!ENTITY language "ru">
+
+<!-- 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//RU"
+  "entities/underGPL.docbook"                       ><!-- level: para -->
+<!ENTITY underFDL           PUBLIC "-//KDE//DOCUMENT FDL Licence Declaration//RU"
+  "entities/underFDL.docbook"                       ><!-- level: para -->
+<!ENTITY underBSDLicense    PUBLIC "-//KDE//DOCUMENT BSD Licence Declaration//RU"
+  "entities/underBSDLicense.docbook"                ><!-- level: para -->
+<!ENTITY underArtisticLicense PUBLIC "-//KDE//DOCUMENT Artistic Licence Declaration//RU"
+  "entities/underArtisticLicense.docbook"           ><!-- level: para -->
+<!ENTITY underX11License    PUBLIC "-//KDE//DOCUMENT X11 Licence Declaration//RU"
+  "entities/underX11License.docbook"                ><!-- level: para -->
+
+<!ENTITY reporting.bugs     PUBLIC "-//KDE//DOCUMENT Report Bugs//RU"
+  "entities/report-bugs.docbook"                       ><!-- level: ? -->
+<!ENTITY updating.documentation PUBLIC "-//KDE//DOCUMENT Updating Documentation//RU"
+  "entities/update-doc.docbook"                     ><!-- level: para -->
+<!ENTITY help.menu.documentation PUBLIC "-//KDE//DOCUMENT Help Menu Documentation//RU"
+  "entities/help-menu.docbook"                      ><!-- level: variablelist -->
+<!ENTITY install.intro.documentation PUBLIC "-//KDE//DOCUMENT Installation General Information//RU"
+  "entities/install-intro.docbook"                     ><!-- level: para -->
+<!ENTITY install.compile.documentation PUBLIC "-//KDE//DOCUMENT Compilation Instructions//RU"
+  "entities/install-compile.docbook"                     ><!-- level: para -->
+
+
+<!-- FDL notice -->
+<!ENTITY FDLNotice PUBLIC "-//KDE//DOCUMENT GNU Free Documentation Notice//RU"
+         "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/ru/strings.entities b/kdoctools/customization/ru/strings.entities
new file mode 100644
index 000000000..d497ed9c0
--- /dev/null
+++ b/kdoctools/customization/ru/strings.entities
@@ -0,0 +1,28 @@
+<!-- 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 "это приложение">
+<!-- Entities to fill in slots in docbook version of FDL notice.
+     The default values of the parameter entities is IGNORE. -->
+<![%FDLIS;[
+<!ENTITY FDLISTitles "ПЕРЕЧИСЛИТЬ ИХ НАЗВАНИЯ"><!-- keep capitals -->
+<!ENTITY FDLInvariantSections "неизменяемые разделы: &FDLISTitles;">
+ ]]>
+<!ENTITY FDLInvariantSections " неизменямых разделов">
+<![%FDLFCT;[
+<!ENTITY FDLFCTTitles "LIST"><!-- keep capitals -->
+<!ENTITY FDLFrontCoverText "текст на первой странице: &FDLFCTTitles;">
+ ]]>
+<!ENTITY FDLFrontCoverText " текста на первой странице">
+<![%FDLBCT;[
+<!ENTITY FDLBCTTitles "ПЕРЕЧИСЛИТЬ ИХ НАЗВАНИЯ"><!-- keep capitals -->
+<!ENTITY FDLBackCoverText "текст на последней странице: &FDLBCTTitles;">
+ ]]>
+<!ENTITY FDLBackCoverText " текста на последней странице">
+
+ 
+<!ENTITY kde.modespec '
+ <modespec id="kdems-help">help:</modespec>
+  <modespec id="kdems-man">man:</modespec>'>
diff --git a/kdoctools/customization/ru/user.entities b/kdoctools/customization/ru/user.entities
new file mode 100644
index 000000000..38c13787b
--- /dev/null
+++ b/kdoctools/customization/ru/user.entities
@@ -0,0 +1,41 @@
+<!-- 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)
+ -->
+
+<!ENTITY kcontrol "<application>Центр управления &kde;</application>" ><!-- kde help -->
+<!ENTITY khelpcenter "<application>Центр справки &kde;</application>" ><!-- khelpcenter -->
+<!ENTITY LMB    "<mousebutton>левая</mousebutton> кнопка мыши">
+<!ENTITY MMB    "<mousebutton>средняя</mousebutton> кнопка мыши">
+<!ENTITY RMB    "<mousebutton>правая</mousebutton> кнопка мыши">
+
+<!ENTITY dpi    '<acronym>dpi</acronym>'>
+<!ENTITY etc    "<abbrev>etc.</abbrev>">
+<!ENTITY FAQ    '<acronym>FAQ</acronym>'>
+
+<!-- Temporary hack - please translate to Russian:
+
+     (you may adapt the entity's name to transliterated Russian as well)
+-->
+<!ENTITY kcontrolcenter	"<application>&kde; Control Center</application>">
+<!ENTITY kicon	"<guiicon>
+<inlinemediaobject>
+ <objectinfo><title>&kde;'s K-icon</title></objectinfo>
+ <imageobject><imagedata fileref='common/kmenu.png' format='PNG'/></imageobject>
+ <textobject><phrase>K</phrase></textobject>
+</inlinemediaobject>
+</guiicon> icon"><!-- if image is localised, then entityref should be used 
+                      instead of fileref -->
+<!ENTITY kmenu  "<guimenu>K</guimenu> menu">
+<!ENTITY Shift  "<keycap>Shift</keycap>">
+<!ENTITY Alt    "<keycap>Alt</keycap>">
+<!ENTITY Tab    "<keycap>Tab</keycap>">
+<!ENTITY Esc    "<keycap>Esc</keycap>">
+<!ENTITY Enter  "<keycap>Ввод</keycap>">
+<!ENTITY OS     "ОС">
+<!ENTITY Ctrl   "<keycap>Ctrl</keycap>">
+<!ENTITY eg     "<abbrev>e.g.</abbrev>">
+<!ENTITY ie     "<abbrev>i.e.</abbrev>">