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

diff --git a/kdoctools/customization/ja/catalog b/kdoctools/customization/ja/catalog
new file mode 100644
index 000000000..c0b7398f8
--- /dev/null
+++ b/kdoctools/customization/ja/catalog
@@ -0,0 +1,36 @@
+PUBLIC "-//KDE//ENTITIES Japanese Documentation V1.0//JA"
+       "lang.entities"
+
+PUBLIC "-//KDE//DOCUMENT GNU Free Documentation Notice//JA"
+       "entities/fdl-notice.docbook"
+PUBLIC "-//KDE//DOCUMENT GNU General Public License Notice//JA"
+       "entities/gpl-notice.docbook"
+PUBLIC "-//KDE//DOCUMENT GNU Lesser General Public License Notice//JA"
+       "entities/lgpl-notice.docbook"
+
+PUBLIC "-//GNU//DOCUMENT GNU General Public License V2//JA"
+       "common/gpl-translated"
+PUBLIC "-//GNU//DOCUMENT GNU Lesser General Public License V2.1//JA"
+       "common/lgpl-translated"
+PUBLIC "-//GNU//DOCUMENT GNU Free Documentation License V1.1//JA"
+       "common/fdl-translated"
+PUBLIC "-//KDE//DOCUMENT GPL Licence Declaration//JA"
+       "entities/underGPL.docbook" 
+PUBLIC "-//KDE//DOCUMENT FDL Licence Declaration//JA"
+       "entities/underFDL.docbook"
+PUBLIC "-//KDE//DOCUMENT BSD Licence Declaration//JA"
+       "entities/underBSDLicense.docbook"
+PUBLIC "-//KDE//DOCUMENT Artistic Licence Declaration//JA"
+       "entities/underArtisticLicense.docbook"
+PUBLIC "-//KDE//DOCUMENT X11 Licence Declaration//JA"
+       "entities/underX11License.docbook"
+PUBLIC "-//KDE//DOCUMENT Report Bugs//JA"
+       "entities/report-bugs.docbook"
+PUBLIC "-//KDE//DOCUMENT Updating Documentation//JA"
+       "entities/update-doc.docbook"
+PUBLIC "-//KDE//DOCUMENT Help Menu Documentation//JA"
+       "entities/help-menu.docbook"
+PUBLIC "-//KDE//DOCUMENT Installation General Information//JA"
+       "entities/install-intro.docbook"
+PUBLIC "-//KDE//DOCUMENT Compilation Instructions//JA"
+       "entities/install-compile.docbook"
diff --git a/kdoctools/customization/ja/entities/fdl-notice.docbook b/kdoctools/customization/ja/entities/fdl-notice.docbook
new file mode 100644
index 000000000..f9e2e094b
--- /dev/null
+++ b/kdoctools/customization/ja/entities/fdl-notice.docbook
@@ -0,0 +1,12 @@
+<para>Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License,
+Version 1.1 or any later version published by the Free Software
+Foundation; with &FDLInvariantSections;, with &FDLFrontCoverText;, and
+with &FDLBackCoverText;.  A copy of the license is included in <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/ja/entities/gpl-notice.docbook b/kdoctools/customization/ja/entities/gpl-notice.docbook
new file mode 100644
index 000000000..2611c941f
--- /dev/null
+++ b/kdoctools/customization/ja/entities/gpl-notice.docbook
@@ -0,0 +1,19 @@
+<para>This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License as
+published by the Free Software Foundation; either version 2 of the
+License, or (at your option) any later version.</para>
+
+<para>This program 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
+General Public License for more details.</para>
+
+<para>You should have received a copy of the GNU General Public
+License along with this program; if not, write to the 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/ja/entities/help-menu.docbook b/kdoctools/customization/ja/entities/help-menu.docbook
new file mode 100644
index 000000000..659c38c19
--- /dev/null
+++ b/kdoctools/customization/ja/entities/help-menu.docbook
@@ -0,0 +1,93 @@
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice
+><shortcut
+> <keycombo action="simul"
+><keycap
+>F1</keycap
+></keycombo
+> </shortcut
+> <guimenu
+>ヘルプ</guimenu
+> <guimenuitem
+>&kappname; ハンドブック</guimenuitem
+> </menuchoice>
+</term>
+<listitem
+><para
+>KDE のヘルプシステムを起動して &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
+>これを選択するとマウスカーソルの形が矢印とクエスチョンマークに変わります。その状態で &kappname; のユーザインターフェースの要素をクリックすると、それぞれの機能を説明するヘルプウィンドウが表示されます (その要素にヘルプがある場合のみ)。</para
+></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term
+><menuchoice
+><guimenu
+>ヘルプ</guimenu
+> <guimenuitem
+>バグを報告...</guimenuitem
+> </menuchoice
+></term>
+<listitem
+><para
+>バグレポート用のダイアログを開きます。これを使ってプログラムの不具合を報告したり、要望を送ったりすることができます。</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/ja/entities/install-compile.docbook b/kdoctools/customization/ja/entities/install-compile.docbook
new file mode 100644
index 000000000..a4a7b772c
--- /dev/null
+++ b/kdoctools/customization/ja/entities/install-compile.docbook
@@ -0,0 +1,8 @@
+<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/ja/entities/install-intro.docbook b/kdoctools/customization/ja/entities/install-intro.docbook
new file mode 100644
index 000000000..b3436da99
--- /dev/null
+++ b/kdoctools/customization/ja/entities/install-intro.docbook
@@ -0,0 +1,4 @@
+<!-- requires that packagename is defined in the documentation prologue -->
+<para>&kappname; は &kde; プロジェクト &kde-http; の一部です。</para>
+
+<para>&kappname; は &kde; プロジェクトのメイン &FTP; サイトである &kde-ftp; にある &package; パッケージに含まれています。</para>
diff --git a/kdoctools/customization/ja/entities/lgpl-notice.docbook b/kdoctools/customization/ja/entities/lgpl-notice.docbook
new file mode 100644
index 000000000..0e06a065a
--- /dev/null
+++ b/kdoctools/customization/ja/entities/lgpl-notice.docbook
@@ -0,0 +1,20 @@
+<para>This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public License
+as published by the Free Software Foundation; either version 2 of
+the License, or (at your option) any later version.</para>
+
+<para>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
+Lesser General Public License for more details.</para>
+
+<para>You should have received a copy of the GNU Lesser General
+Public License along with this library; if not, write to the 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/ja/entities/report-bugs.docbook b/kdoctools/customization/ja/entities/report-bugs.docbook
new file mode 100644
index 000000000..c9f2992f2
--- /dev/null
+++ b/kdoctools/customization/ja/entities/report-bugs.docbook
@@ -0,0 +1 @@
+<!-- -->
diff --git a/kdoctools/customization/ja/entities/underArtisticLicense.docbook b/kdoctools/customization/ja/entities/underArtisticLicense.docbook
new file mode 100644
index 000000000..cd00e9a66
--- /dev/null
+++ b/kdoctools/customization/ja/entities/underArtisticLicense.docbook
@@ -0,0 +1 @@
+<para>このプログラムのライセンスは <ulink url="common/artistic-license.html">Artistic License</ulink> です。</para>
diff --git a/kdoctools/customization/ja/entities/underBSDLicense.docbook b/kdoctools/customization/ja/entities/underBSDLicense.docbook
new file mode 100644
index 000000000..587815cb1
--- /dev/null
+++ b/kdoctools/customization/ja/entities/underBSDLicense.docbook
@@ -0,0 +1 @@
+<para>このプログラムのライセンスは <ulink url="common/bsd-license.html">BSD License</ulink> です。</para>
diff --git a/kdoctools/customization/ja/entities/underFDL.docbook b/kdoctools/customization/ja/entities/underFDL.docbook
new file mode 100644
index 000000000..4d4d2048a
--- /dev/null
+++ b/kdoctools/customization/ja/entities/underFDL.docbook
@@ -0,0 +1,3 @@
+<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>
diff --git a/kdoctools/customization/ja/entities/underGPL.docbook b/kdoctools/customization/ja/entities/underGPL.docbook
new file mode 100644
index 000000000..7e7dbd49b
--- /dev/null
+++ b/kdoctools/customization/ja/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/ja/entities/underX11License.docbook b/kdoctools/customization/ja/entities/underX11License.docbook
new file mode 100644
index 000000000..6de034c59
--- /dev/null
+++ b/kdoctools/customization/ja/entities/underX11License.docbook
@@ -0,0 +1 @@
+<para>このプログラムのライセンスは <ulink url="common/x11-license.html">X11 License</ulink> です。</para>
diff --git a/kdoctools/customization/ja/entities/update-doc.docbook b/kdoctools/customization/ja/entities/update-doc.docbook
new file mode 100644
index 000000000..facc3735a
--- /dev/null
+++ b/kdoctools/customization/ja/entities/update-doc.docbook
@@ -0,0 +1 @@
+<!-- to be filled in -->
diff --git a/kdoctools/customization/ja/lang.entities b/kdoctools/customization/ja/lang.entities
new file mode 100644
index 000000000..433669b4b
--- /dev/null
+++ b/kdoctools/customization/ja/lang.entities
@@ -0,0 +1,46 @@
+<!ENTITY language "ja">
+
+<!-- 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//JA"
+  "entities/underGPL.docbook"                       ><!-- level: para -->
+<!ENTITY underFDL           PUBLIC "-//KDE//DOCUMENT FDL Licence Declaration//JA"
+  "entities/underFDL.docbook"                       ><!-- level: para -->
+<!ENTITY underBSDLicense    PUBLIC "-//KDE//DOCUMENT BSD Licence Declaration//JA"
+  "entities/underBSDLicense.docbook"                ><!-- level: para -->
+<!ENTITY underArtisticLicense PUBLIC "-//KDE//DOCUMENT Artistic Licence Declaration//JA"
+  "entities/underArtisticLicense.docbook"           ><!-- level: para -->
+<!ENTITY underX11License    PUBLIC "-//KDE//DOCUMENT X11 Licence Declaration//JA"
+  "entities/underX11License.docbook"                ><!-- level: para -->
+
+<!ENTITY reporting.bugs     PUBLIC "-//KDE//DOCUMENT Report Bugs//JA"
+  "entities/report-bugs.docbook"                       ><!-- level: ? -->
+<!ENTITY updating.documentation PUBLIC "-//KDE//DOCUMENT Updating Documentation//JA"
+  "entities/update-doc.docbook"                     ><!-- level: para -->
+<!ENTITY help.menu.documentation PUBLIC "-//KDE//DOCUMENT Help Menu Documentation//JA"
+  "entities/help-menu.docbook"                      ><!-- level: variablelist -->
+<!ENTITY install.intro.documentation PUBLIC "-//KDE//DOCUMENT Installation General Information//JA"
+  "entities/install-intro.docbook"                     ><!-- level: para -->
+<!ENTITY install.compile.documentation PUBLIC "-//KDE//DOCUMENT Compilation Instructions//JA"
+  "entities/install-compile.docbook"                     ><!-- level: para -->
+
+
+<!-- FDL notice -->
+<!ENTITY FDLNotice PUBLIC "-//KDE//DOCUMENT GNU Free Documentation Notice//JA"
+         "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/ja/strings.entities b/kdoctools/customization/ja/strings.entities
new file mode 100644
index 000000000..d88951813
--- /dev/null
+++ b/kdoctools/customization/ja/strings.entities
@@ -0,0 +1,23 @@
+<!-- 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">
diff --git a/kdoctools/customization/ja/user.entities b/kdoctools/customization/ja/user.entities
new file mode 100644
index 000000000..08fbf1b13
--- /dev/null
+++ b/kdoctools/customization/ja/user.entities
@@ -0,0 +1,15 @@
+<!-- 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)
+ -->
+
+<!-- Temporary hack! Please adapt to Japanese keyboards and language -->
+<!ENTITY Alt	"<keycap>Alt</keycap>">
+<!ENTITY Ctrl	"<keycap>Ctrl</keycap>">
+<!ENTITY etc    "<abbrev>等</abbrev>">
+<!ENTITY ie     "<abbrev>例</abbrev>">
+<!ENTITY kcontrolcenter "<application>&kde;コントロールセンター</application>">
+<!ENTITY Shift	"<keycap>Shift</keycap>">