runtime/doc/kcontrol/language/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   6 ]>
   7
   8 <article lang="&language;">
   9 <sect1 id="locale">
  10
  11 <sect1info>
  12 <authorgroup>
  13 <author>&Mike.McBride; &Mike.McBride.mail;</author>
  14 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
  15 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  16  </authorgroup>
  17
  18           <date>2003-10-14</date>
  19           <releaseinfo>3.2</releaseinfo>
  20
  21           <keywordset>
  22                 <keyword>KDE</keyword>
  23                 <keyword>KControl</keyword>
  24                 <keyword>locale</keyword>
  25                 <keyword>country</keyword>
  26                 <keyword>language</keyword>
  27           </keywordset>
  28
  29         </sect1info>
  30
  31
  32 <title>Country and Language</title>
  33
  34 <para>This module of the &kde; control center allows you select
  35 customization options that depend on the region of the world that you
  36 happen to live in. There are five different pages in this module, each
  37 of which is described in detail in the following sections.</para>
  38
  39 <para>In most cases, you can simply select the country you live in, and
  40 the other options will be set in an appropriate manner.</para>
  41
  42 <para>Below the pages of this module, you can see a preview of what the
  43 settings look like. In addition to positive and negative numbers, you
  44 can see how positive and negative currency values, long and short dates,
  45 and times are displayed. When you change any of the settings, the
  46 preview shows the effects of the changes before you apply them.</para>
  47
  48 <sect2 id="locale-locale">
  49 <title>Locale</title>
  50
  51 <para>On this page, there are two lists, from which you can
  52 select the country and languages that you want
  53 to use.</para>
  54
  55 <para>When you click on the <guilabel>Country</guilabel> list,
  56 a menu pops up showing major groups of countries. You can select
  57 one of these regions and see a list of the countries that are
  58 available for that region.</para>
  59
  60 <para>If the language for the country you have selected is available on your
  61 system, it will be selected automatically. For instance, choosing
  62 <guilabel>Germany</guilabel> as the country will select
  63 <guilabel>German</guilabel> as the language, if it is available.</para>
  64
  65 </sect2>
  66
  67 <sect2 id="locale-numbers">
  68 <title>Numbers</title>
  69
  70 <para>On this page, you can select options for how numbers are
  71 displayed. The defaults are selected automatically based on the country
  72 which is currently selected.</para>
  73
  74 <para>In the text box labeled <guilabel>Decimal symbol</guilabel>, you
  75 can type the character that you want to use to separate the decimal
  76 portion of numbers. You could put anything here you wanted to, but
  77 really, <userinput>.</userinput> and <userinput>,</userinput> are the
  78 two characters that make the most sense.</para>
  79
  80 <para>Similarly, you can choose the character which is used to group
  81 units of thousands in numbers. If no character, not even a space, is
  82 present, then there will be no separator for thousands.</para>
  83
  84 <para>Finally, you can choose what character should be prefixed to
  85 positive and negative numbers respectively. For example, the default
  86 for English is not to have any prefix for positive numbers, and a
  87 <userinput>-</userinput> for negative numbers.</para>
  88
  89 </sect2>
  90
  91 <sect2 id="locale-money">
  92
  93 <title>Money</title>
  94
  95 <para>Unlike the display of ordinary numbers, conventions for
  96 currency values do vary from region to region. However, you will
  97 find that the defaults are probably fine.</para>
  98
  99 <para>The character or characters representing the currency symbol
 100 are based on the country that is currently selected. The decimal
 101 symbol and thousands separator work as they do for numbers. The
 102 text box labeled <guilabel>Fract digits</guilabel> allows you
 103 to specify the number of fractional digits used in displaying
 104 currency values.</para>
 105
 106 <para>For both positive and negative currency values, you can
 107 control whether the currency symbol appears before or after the
 108 numeric value, and how the sign of the value is distinguished
 109 in the display. Note that the symbols used for the sign of
 110 currency values are the same as those used for other numeric
 111 values.</para>
 112
 113 <para>If the checkbox labeled <guilabel>Prefix currency
 114 symbol</guilabel> is selected, the currency symbol appears
 115 before the numeric value. If this checkbox is cleared, then the
 116 currency symbol appears after the numeric value.</para>
 117
 118 <para>There are five choices for the way in which the sign of the
 119 currency value is handled:</para>
 120 <itemizedlist>
 121 <listitem><para>The <guilabel>Parentheses around</guilabel>
 122 option displays the numeric value within a pair of
 123 parentheses.</para></listitem>
 124 <listitem><para>The <guilabel>Before quantity money</guilabel>
 125 option displays the sign before the numeric value, but after any
 126 currency symbol that may be present.</para></listitem>
 127 <listitem><para>The <guilabel>After quantity money</guilabel>
 128 option displays the sign after the numeric value, but before any
 129 currency symbol that may be present.</para></listitem>
 130 <listitem><para>The <guilabel>Before money</guilabel> option
 131 displays the sign before the numeric value as well as any
 132 currency symbol that may be present.</para></listitem>
 133 <listitem><para>The <guilabel>After money</guilabel> option
 134 displays the sign after the numeric value as well as any
 135 currency symbol that may be present.</para></listitem>
 136 </itemizedlist>
 137
 138 </sect2>
 139
 140 <sect2 id="locale-datetime">
 141 <title>Time and Dates</title>
 142
 143 <para>If you use a different calendar system than Gregorian, you can
 144 choose this from the first dropdown box.</para>
 145
 146 <para>On the rest of this page, there are text boxes for the time, long
 147 date, and short date, in which you can type format strings to control
 148 the way in which times and dates are displayed.</para>
 149
 150 <para>Except for the special codes described below, any other characters in the
 151 format strings are displayed literally. The special codes consist of a
 152 <parameter>%</parameter> sign followed by a character, as shown in the list of
 153 codes below:</para>
 154
 155 <itemizedlist>
 156 <listitem><para>Time format codes:</para>
 157   <itemizedlist>
 158
 159   <listitem><para><parameter>HH</parameter> - The hour according to a 24-hour
 160   clock, using two digits (00 to 23).</para></listitem>
 161   <listitem><para><parameter>hH</parameter> - The hour according to a 24-hour
 162   clock, using one or two digits (0 to 23).</para></listitem>
 163   <listitem><para><parameter>PH</parameter> (uppercase <quote>p</quote>) - The hour according
 164   to a 12-hour clock, using two digits (01 to 12).</para></listitem>
 165   <listitem><para><parameter>pH</parameter> (lowercase <quote>p</quote>) - The hour according
 166   to a 12-hour clock, using one or two digits (1 to 12).</para></listitem>
 167   <listitem><para><parameter>MM</parameter> - The current minute using two digits
 168   (00 to 59).</para></listitem>
 169   <listitem><para><parameter>SS</parameter> - The current second using two digits
 170   (00 to 59).</para></listitem>
 171   <listitem><para><parameter>AMPM</parameter> - Either <quote>am</quote> or <quote>pm</quote> depending on the hour.
 172   Useful with <parameter>PH</parameter> or
 173   <parameter>pH</parameter>.</para></listitem>
 174   </itemizedlist>
 175 </listitem>
 176
 177 <listitem><para>Date format codes:</para>
 178   <itemizedlist>
 179   <listitem><para><parameter>YYYY</parameter> - The year, using 4
 180   digits.</para></listitem>
 181   <listitem><para><parameter>YY</parameter> - The year, using 2
 182   digits.</para></listitem>
 183   <listitem><para><parameter>MM</parameter> - The month, using 2 digits (01 to
 184   12).</para></listitem>
 185   <listitem><para><parameter>mM</parameter> - The month, using 1 or 2 digits (1
 186   to 12).</para></listitem>
 187   <listitem><para><parameter>MONTH</parameter> - The name of the
 188   month.</para></listitem>
 189   <listitem><para><parameter>SHORTMONTH</parameter> - The abbreviated name of the
 190   month.</para></listitem>
 191   <listitem><para><parameter>DD</parameter> - The day, using 2 digits (01 to
 192   31).</para></listitem>
 193   <listitem><para><parameter>dD</parameter> - The day, using 1 or 2 digits (1 to
 194   31).</para></listitem>
 195   <listitem><para><parameter>WEEKDAY</parameter> - The name of the
 196   weekday.</para></listitem>
 197   <listitem><para><parameter>SHORTWEEKDAY</parameter> - The abbreviated name of the
 198   weekday.</para></listitem>
 199   </itemizedlist>
 200 </listitem>
 201 </itemizedlist>
 202
 203 <para>Finally, there's a combobox labeled <guilabel>First day
 204 of the week</guilabel> which lets you select which day is the first
 205 one of the week in your country.</para>
 206
 207 </sect2>
 208 <sect2 id="locale-other">
 209 <title>Other</title>
 210 <para>You can select the default paper format with the combo box labeled <guilabel>Paper Format</guilabel>.</para>
 211
 212 <para>Use the drop down box labeled <guilabel>Measure system</guilabel> to select Imperial or
 213 Metric systems of measurement.</para>
 214
 215 </sect2>
 216
 217 </sect1>
 218 </article>