[kde-doc-english] [kio] docs: Import KCM documentation from plasma-desktop.git.
Albert Astals Cid
aacid at kde.org
Thu Jan 8 23:36:33 UTC 2015
Have you removed them from plasma-desktop? Or are they still there?
Cheers,
Albert
El Dijous, 8 de gener de 2015, a les 19:27:44, Eike Hein va escriure:
> Git commit 895f260a53aa52bb8606d686efaf28539031b329 by Eike Hein.
> Committed on 15/12/2014 at 19:51.
> Pushed by hein into branch 'master'.
>
> Import KCM documentation from plasma-desktop.git.
>
> This moves the handbooks for the KCMs migrated into kio.git in
> 367a56b5 and 335f570f from plasma-desktop.git to here.
>
> The 'ebrowsing' handbook has been renamed to 'webshortcuts' to
> match what the KCM actually requests.
>
> Branched from plasma-desktop.git, master branch, at commit
> 2d7fca61f57082bb96d48b92df16871ad7b0a271
>
> Change-Id: I72e7026f3d818c71077ca81fdb6b4491173da2c0
> CCMAIL:kde-i18n-doc at kde.org
>
> M +1 -0 docs/CMakeLists.txt
> A +14 -0 docs/kcontrol/CMakeLists.txt
> A +2 -0 docs/kcontrol/cache/CMakeLists.txt
> A +66 -0 docs/kcontrol/cache/index.docbook
> A +2 -0 docs/kcontrol/cookies/CMakeLists.txt
> A +208 -0 docs/kcontrol/cookies/index.docbook
> A +2 -0 docs/kcontrol/netpref/CMakeLists.txt
> A +109 -0 docs/kcontrol/netpref/index.docbook
> A +2 -0 docs/kcontrol/proxy/CMakeLists.txt
> A +209 -0 docs/kcontrol/proxy/index.docbook
> A +2 -0 docs/kcontrol/smb/CMakeLists.txt
> A +104 -0 docs/kcontrol/smb/index.docbook
> A +2 -0 docs/kcontrol/useragent/CMakeLists.txt
> A +110 -0 docs/kcontrol/useragent/index.docbook
> A +2 -0 docs/kcontrol/webshortcuts/CMakeLists.txt
> A +173 -0 docs/kcontrol/webshortcuts/index.docbook
>
> http://commits.kde.org/kio/895f260a53aa52bb8606d686efaf28539031b329
>
> diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt
> index 7d23a35..3258b6c 100644
> --- a/docs/CMakeLists.txt
> +++ b/docs/CMakeLists.txt
> @@ -1,2 +1,3 @@
> add_subdirectory(kcookiejar5)
> add_subdirectory(kioslave)
> +add_subdirectory(kcontrol)
> diff --git a/docs/kcontrol/CMakeLists.txt b/docs/kcontrol/CMakeLists.txt
> new file mode 100644
> index 0000000..c6ddfe8
> --- /dev/null
> +++ b/docs/kcontrol/CMakeLists.txt
> @@ -0,0 +1,14 @@
> +add_subdirectory(cookies)
> +add_subdirectory(webshortcuts)
> +add_subdirectory(useragent)
> +
> +if ( Q_WS_X11 )
> + add_subdirectory(cache)
> + add_subdirectory(netpref)
> + add_subdirectory(proxy)
> +endif ()
> +
> +if ( NOT Q_WS_WIN )
> + add_subdirectory(smb)
> +endif ()
> +
> diff --git a/docs/kcontrol/cache/CMakeLists.txt
> b/docs/kcontrol/cache/CMakeLists.txt new file mode 100644
> index 0000000..7728027
> --- /dev/null
> +++ b/docs/kcontrol/cache/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/cache) diff --git
> a/docs/kcontrol/cache/index.docbook b/docs/kcontrol/cache/index.docbook new
> file mode 100644
> index 0000000..063a6b3
> --- /dev/null
> +++ b/docs/kcontrol/cache/index.docbook
> @@ -0,0 +1,66 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="cache" lang="&language;">
> +<title>Cache</title>
> +<articleinfo>
> +
> +<authorgroup>
> +<author><firstname>Lauri</firstname><surname>Watts</surname></author>
> +
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2009-11-20</date>
> +<releaseinfo>&kde; 4.4</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>Systemsettings</keyword>
> +<keyword>Konqueror</keyword>
> +<keyword>Cache</keyword>
> +</keywordset>
> +</articleinfo>
> +
> +<para>This module allows you to control the size of the local cache
> +folder used by &konqueror;. Note that each user account on your
> +computer has a separate cache folder, and this folder is not
> +shared with other web browsers such as &Netscape;.</para>
> +
> +<para>Storing local copies of web pages that you have visited allows
> +&konqueror; to quickly load their contents on subsequent visits. It
> +will only be necessary to reload the contents from the original site
> +if they have changed since your last visit, or if you click the reload
> +button in &konqueror;.</para>
> +
> +<para>If you really do not want any of the web pages you visit to be
> +stored on your computer, you can disable &konqueror;'s disk cache by
> +clearing the checkbox labeled <guilabel>Use cache</guilabel>.</para>
> +
> +<para>You can set here how aggressively &konqueror; keeps the cache up
> +to date. <guilabel>Keep cache in sync</guilabel> means that &konqueror;
> +will hit the cache for all objects, downloading them if they are not
> +there, and then display the item from the cache. <guilabel>Use cache
> +whenever possible</guilabel> means that &konqueror; will try the cache,
> +and if an object is not there, it will directly download it for display.
> +<guilabel>Offline browsing mode</guilabel> means that &konqueror; will
> +try the cache, and if an object is not there, it will not attempt to
> +download it from the Internet.</para>
> +
> +<para>You can control the size of the cache by typing a number into the
> +text box labeled <guilabel>Disk cache size</guilabel>. This is the
> +average amount of space in kilobytes that the cache folder is allowed
> +to use. When the cache grows too large, &konqueror; will delete older
> +files to reduce the size of the cache folder.</para>
> +
> +<para>This is however, only an average, and during a browsing session
> +the cache could become substantially larger.</para>
> +
> +<para>You can use the <guibutton>Clear Cache</guibutton> button to empty
> +the cache at any time.</para>
> +
> +</article>
> diff --git a/docs/kcontrol/cookies/CMakeLists.txt
> b/docs/kcontrol/cookies/CMakeLists.txt new file mode 100644
> index 0000000..8f86430
> --- /dev/null
> +++ b/docs/kcontrol/cookies/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/cookies) diff --git
> a/docs/kcontrol/cookies/index.docbook b/docs/kcontrol/cookies/index.docbook
> new file mode 100644
> index 0000000..bcf8f74
> --- /dev/null
> +++ b/docs/kcontrol/cookies/index.docbook
> @@ -0,0 +1,208 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="cookies" lang="&language;">
> +<articleinfo>
> +<title>Cookies</title>
> +<authorgroup>
> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author>
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2012-11-11</date>
> +<releaseinfo>&kde; 4.10</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>Systemsettings</keyword>
> +<keyword>cookie</keyword>
> +</keywordset>
> +
> +</articleinfo>
> +
> +<sect1 id="cookie">
> +<title>Cookies</title>
> +
> +<para>Cookies are a mechanism used by web sites to store and retrieve
> +information using your browser. For example, a web site may allow you
> +to customize the content and layout of the pages you see, so that your
> +choices are persistent across different visits to that web site.</para>
> +
> +<para>The web site is able to remember your preferences by storing a
> +cookie on your computer. Then, on future visits, the web site retrieves
> +the information stored in the cookie to format the content of the site
> +according to your previously specified preferences.</para>
> +
> +<para>Thus, cookies play a very useful role in web browsing.
> +Unfortunately, web sites often store and retrieve information in cookies
> +without your explicit knowledge or consent. Some of this information may
> +be quite useful to the web site owners, for example, by allowing them to
> +collect summary statistics on the number of visits different areas of
> +the web sites get, or to customize banner advertising.</para>
> +
> +<para>The cookies page allows you to set policies
> +for the use of cookies when you are browsing the web with the
> +&konqueror; web browser. </para>
> +
> +<warning><para>Note that the policies that you set using this control
> +module will <emphasis>not</emphasis> apply to other web browsers such
> +as &Netscape;.</para></warning>
> +
> +<sect2 id="cookie-policy">
> +
> +<title>Policy</title>
> +
> +<para>Using the <guilabel>Policy</guilabel> tab, you can configure the
> +&kde; applications that will handle cookies. You can do this by specifying
> a +general cookie policy as well as special cookie policies for certain
> +domains or hosts.</para>
> +
> +<para>The top of the policy tab has a check box labeled <guilabel>Enable
> +cookies</guilabel>. If you leave this unchecked, cookies will be
> +completely disabled. However, this may make browsing rather
> +inconvenient, especially as some web sites require the use of browsers
> +with cookies enabled.</para>
> +
> +<para>You will probably want to enable cookies and then set
> +specific policies on how you want them to be handled.</para>
> +
> +<para>The first group of options create settings that apply to all
> cookies.</para> +
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Only accept cookies from originating
> server</guilabel></term> +<listitem>
> +<para>Some pages try to set cookies from servers other than the one
> +you are seeing the &HTML; page from. For example,
> +they show you advertisements, and the advertisements are from another
> +computer, often one that belongs to a large advertising group. These
> +advertisements may try to set a cookie which would allow them to
> +track the pages you view across multiple web sites.</para>
> +<para>Enabling this option will mean only cookies that come from the
> +same web server as you are explicitly connecting to will be
> +accepted.</para>
> +</listitem>
> +</varlistentry>
> +<varlistentry>
> +<term><guilabel>Automatically accept session cookies</guilabel></term>
> +<listitem>
> +
> +<para>An increasingly common use for cookies is not to track your
> +movements across many visits to a web site, but to just follow what you
> +do during one single visit. Session cookies are saved as long as you
> +are looking at the site, and deleted when you leave it.</para>
> +
> +<para>Web sites can use this information for various things, most
> +commonly it is a convenience so that you do not have to keep logging in
> +to view pages. For example, on a webmail site, without some kind of
> +session <acronym>ID</acronym>, you would have to give your password
> +again for each email you want to read. There are other ways to
> +achieve this, but cookies are simple and very common.</para>
> +
> +<para>Enabling this option means that session cookies are always
> +accepted, even if you don't accept any other kind, and even if you
> +choose to reject cookies from a particular site, session cookies from
> +that site will be accepted.</para>
> +</listitem>
> +</varlistentry>
> +</variablelist>
> +
> +<para>The section for <guilabel>Default Policy</guilabel> sets some
> +further options that are mutually exclusive — you can choose only one
> +of these options as the default, but you are free to set a different
> +option for any specific web server.</para>
> +<note><para>Site specific policies always take precedence over the default
> +policy.</para></note>
> +
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Accept all cookies</guilabel></term>
> +<listitem>
> +<para>If this option is selected, all cookies will be accepted without
> +asking for confirmation.</para>
> +</listitem>
> +</varlistentry>
> +<varlistentry>
> +<term><guilabel>Accept until end of session</guilabel></term>
> +<listitem>
> +<para>Cookies will be accepted, but they will expire at the end
> +of the session.</para>
> +</listitem>
> +</varlistentry>
> +<varlistentry>
> +<term><guilabel>Ask for confirmation</guilabel></term>
> +<listitem>
> +<para>If this option is selected, you will be asked for confirmation
> +every time a cookie is stored or retrieved. You can selectively accept
> +or reject each cookie. The confirmation dialog will also allow you to
> +set a domain specific policy, if you do not want to confirm each
> +cookie for that domain.</para>
> +</listitem>
> +</varlistentry>
> +<varlistentry>
> +<term><guilabel>Reject all cookies</guilabel></term>
> +<listitem>
> +<para>If this option is selected, all cookies will be rejected without
> +asking for confirmation.</para>
> +</listitem>
> +</varlistentry>
> +</variablelist>
> +
> +<para>In addition to the default policy for handling of cookies, which you
> can +set by selecting one of the three options described above, you can
> also set +policies for specific host domains using the controls in the
> <guilabel>Site +Policy</guilabel> group.</para>
> +
> +<para>The Ask, Accept, Accept until end of session, or Reject policy can be
> applied to a specific +domain by clicking on the
> <guibutton>New...</guibutton> button, which +brings up a dialog. In this
> dialog, you can type the name of the
> +domain (with a leading dot), then select the policy you want to apply
> +to this domain. Note that entries may also get added while you are
> +browsing, if the default policy is to ask for confirmation, and you
> +choose a general policy for a specific host (for example, by selecting
> +<guilabel>Reject</guilabel> when asked to
> +confirm a cookie).</para>
> +
> +<para>You can also select a specific host domain from the list and click
> the +<guibutton>Change</guibutton> button to choose a different policy for
> that +domain than the one shown in the list.</para>
> +
> +<para>To delete a domain specific policy, choose a domain from the list,
> and +then click the <guibutton>Delete</guibutton> button. The default
> policy will +apply to domains which have been deleted from the list.</para>
> +
> +</sect2>
> +
> +<sect2 id="cookie-management">
> +<title>Management</title>
> +
> +<para>In the <guilabel>Management</guilabel> tab you can browse and
> selectively +delete cookies that have been set in the past.</para>
> +
> +<para>In the upper part of this dialog, you can see a list of domains
> displayed + as a tree. Click on the little <guiicon>></guiicon> next to
> a domain to see all +cookies that have been set for this particular target
> domain. If you select one +of these cookies, you will notice that its
> contents will show up in the frame +<guilabel>Details</guilabel>
> below.</para>
> +
> +<para>By clicking the <guibutton>Delete</guibutton> button you can now
> delete the selected +cookie. Click <guibutton>Delete All</guibutton> to
> delete all cookies stored.</para> +
> +<para>If a domain is selected, you can use <guibutton>Configure
> Policy</guibutton> to set +a site policy.</para>
> +
> +<para>Choose <guibutton>Reload List</guibutton> to reload the list
> +from your hard disk. You might want to do this if you have had the
> +module open and are testing web sites, or have made many changes in the
> +module itself.</para>
> +
> +</sect2>
> +
> +</sect1>
> +
> +</article>
> diff --git a/docs/kcontrol/netpref/CMakeLists.txt
> b/docs/kcontrol/netpref/CMakeLists.txt new file mode 100644
> index 0000000..42010fd
> --- /dev/null
> +++ b/docs/kcontrol/netpref/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/netpref) diff --git
> a/docs/kcontrol/netpref/index.docbook b/docs/kcontrol/netpref/index.docbook
> new file mode 100644
> index 0000000..786065b
> --- /dev/null
> +++ b/docs/kcontrol/netpref/index.docbook
> @@ -0,0 +1,109 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="netpref" lang="&language;">
> +<articleinfo>
> +<title>Connection Preferences</title>
> +<authorgroup>
> +<author>&Lauri.Watts; &Lauri.Watts.mail;</author>
> +
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2013-12-05</date>
> +<releaseinfo>&kde; 4.12</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>kdebase</keyword>
> +<keyword>kcontrol</keyword>
> +<keyword>network</keyword>
> +<keyword>timeouts</keyword>
> +</keywordset>
> +
> +</articleinfo>
> +
> +<sect1 id="timeouts">
> +
> +<title>Connection Preferences</title>
> +
> +<para>Here you can set timeout values. You might want to tweak them
> +if your connection is very slow, but the default settings are
> +appropriate for most users.</para>
> +
> +<para>Here <guilabel>Timeout Values</guilabel> are the length of time
> +an application should wait for an answer from a network operation.</para>
> +
> +<para>You can configure the following timeouts:</para>
> +
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Socket read:</guilabel></term>
> +<listitem>
> +<para> Some applications use <firstterm>sockets</firstterm> to
> +communicate. You can think of a socket as a water tap; while it is
> +open, water (or in our case, data) comes out, without any interaction.
> +If something stops this flow of data, the application will wait for
> +more to come. This could be a very long time, but you can configure a
> +maximum time for an application to wait with this option.</para>
> +<para>This setting will only apply to &kde; applications, of course.</para>
> +</listitem>
> +</varlistentry>
> +
> +<varlistentry>
> +<term><guilabel>Proxy connect:</guilabel></term>
> +<listitem>
> +<para>
> +Sets how long to wait for a connection to a proxy server, if one is
> configured. +</para>
> +</listitem>
> +</varlistentry>
> +
> +<varlistentry>
> +<term><guilabel>Server connect:</guilabel></term>
> +<listitem>
> +<para>
> +Sets how long to wait for a connection to a remote server.
> +</para>
> +</listitem>
> +</varlistentry>
> +
> +<varlistentry>
> +<term><guilabel>Server response:</guilabel></term>
> +<listitem>
> +<para>
> +Sets how long to wait for a reply from a remote server.
> +</para>
> +</listitem>
> +</varlistentry>
> +
> +</variablelist>
> +
> +<para>You can configure <guilabel>FTP Options</guilabel> here. At
> +present there is just two options:</para>
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Enable passive mode (PASV)</guilabel></term>
> +<listitem><para>Passive &FTP; is often required when you are behind a
> firewall. +Many firewalls only permit connections that were initiated from
> +<quote>the inside</quote>. Passive &FTP; is controlled by the client,
> +which makes it usable through firewalls.</para></listitem>
> +</varlistentry>
> +
> +<varlistentry>
> +<term><guilabel>Mark partially uploaded files</guilabel></term>
> +<listitem><para>When a mark is placed in this box, partially uploaded files
> will +have a <literal role="extension">.part</literal> extension added to
> the end +of the file. This extension is removed once the file download is
> complete. </para></listitem> +</varlistentry>
> +
> +</variablelist>
> +
> +
> +
> +</sect1>
> +</article>
> diff --git a/docs/kcontrol/proxy/CMakeLists.txt
> b/docs/kcontrol/proxy/CMakeLists.txt new file mode 100644
> index 0000000..37b19c9
> --- /dev/null
> +++ b/docs/kcontrol/proxy/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/proxy) diff --git
> a/docs/kcontrol/proxy/index.docbook b/docs/kcontrol/proxy/index.docbook new
> file mode 100644
> index 0000000..06d30d8
> --- /dev/null
> +++ b/docs/kcontrol/proxy/index.docbook
> @@ -0,0 +1,209 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="proxy" lang="&language;">
> +<title>Proxy</title>
> +<articleinfo>
> +<authorgroup>
> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2013-12-05</date>
> +<releaseinfo>&kde; 4.12</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>Systemsettings</keyword>
> +<keyword>proxy</keyword>
> +<keyword>proxies</keyword>
> +</keywordset>
> +
> +</articleinfo>
> +<sect1 id="proxies">
> +<title>Proxies</title>
> +
> +<sect2 id="proxies-intro">
> +
> +<title>Introduction</title>
> +
> +<para>Proxies are programs running on a computer that acts a server on
> +the network you are connected to (whether by modem or other
> +means). These programs receive &HTTP; and &FTP; requests, retrieve the
> +relevant files from the internet, and pass them on to the client
> +computer that made the requests.</para>
> +
> +<para>When you have configured a proxy, &HTTP; and/or &FTP; requests
> +are re-routed through the computer that is acting as a proxy server.
> +However, you can also select specific hosts which should be contacted
> +directly, rather than through the proxy server. If you are on a local
> +network, for example, access to local hosts probably doesn't need to
> +go through a proxy server.</para>
> +
> +<para>You should only need to configure a proxy server if your network
> +administrator requires it (if you are a dial-up user, that would be
> +your internet service provider or <acronym>ISP</acronym>). Otherwise,
> +especially if you are feeling a bit confused about this proxy
> +business, but everything seems to be fine with your internet
> +connection, you don't need to change anything.</para>
> +
> +<para>Please note that using proxy servers is optional, but has the
> +benefit or advantage of giving you faster access to data on the
> +internet.</para>
> +
> +<para>If you are uncertain whether or not you need to use a proxy
> +server to connect to the internet, please consult with your internet
> +service provider's setup guide or your system administrator.</para>
> +
> +</sect2>
> +
> +<sect2 id="proxies-use">
> +
> +<title>Use</title>
> +
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>No Proxy</guilabel></term>
> +<listitem>
> +
> +<para>Select this option if you do <emphasis>not</emphasis> want to use a
> proxy server +and connect to the Internet directly.</para>
> +</listitem>
> +</varlistentry>
> +</variablelist>
> +
> +<para>If you have decided to use a proxy, you have several methods to
> +configure the settings for it.</para>
> +
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Detect proxy configuration automatically</guilabel></term>
> +<listitem>
> +
> +<para>Select this option if you want the proxy setup configuration
> +script file to be automatically detected and downloaded.</para>
> +<para>This option only differs from the next choice in that it
> +<emphasis>does not</emphasis> require you to supply the location of
> +the configuration script file. Instead, it will be automatically
> +downloaded using <quote>Web Proxy Auto-Discovery</quote>
> +(<acronym>WPAD</acronym>) protocol.</para>
> +
> +<note><para>If you have a problem using this setup, please consult the
> +<acronym>FAQ</acronym> section at <ulink
> +url="http://www.konqueror.org">http://www.konqueror.org</ulink> for
> +more information.</para></note>
> +</listitem>
> +</varlistentry>
> +
> +<varlistentry>
> +<term><guilabel>Use proxy auto configuration URL</guilabel></term>
> +<listitem>
> +<para>Select this option if your proxy support is provided through a
> +script file located at a specific address. You can then enter the
> +address in the location text box, or use the <guiicon>folder</guiicon>
> +icon to browse to it.</para>
> +</listitem>
> +</varlistentry>
> +
> +<varlistentry>
> +<term><guilabel>Use system proxy configuration</guilabel></term>
> +<listitem>
> +<para>Some systems are setup with $<envar>HTTP_PROXY</envar> to allow
> +graphical as well as non-graphical applications to share the same
> +proxy configuration information.</para>
> +<para>If you know this applies to you, select this option and click on
> +the <guibutton>Auto Detect</guibutton> button to provide the environment
> +variable names used to set the address of the proxy server(s).</para>
> +<!-- Exceptions fields are different for system proxy (envar) + manual
> proxy list of hosts/IPs? --> +<para>In the <guilabel>Exceptions</guilabel>
> field enter the environment variable, +⪚ $<envar>NO_PROXY</envar>, used
> to store the
> +addresses of sites for which the proxy server should not be used.</para>
> +<para>Use <guilabel>Show the value of the environment variables</guilabel>
> to +show the value of an environment variable instead of its name.
> +However it is not possible to edit the values of environment variables in
> this module.</para> +<!--
> +How to enable Auto Detect button?
> +-->
> +
> +</listitem>
> +</varlistentry>
> +<varlistentry>
> +<term><guilabel>Use manually specified proxy
> configuration</guilabel></term> +<listitem>
> +
> +<para>The complete addressing information for the proxy includes both
> +the Internet address and a port number. You should enter these into
> +the relevant text boxes. Check <guilabel>Use this proxy server for all
> +protocols</guilabel> to copy the addresses and port of the HTTP proxy
> server +into all other proxy fields, in order to help save some
> typing.</para> +
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Exceptions</guilabel></term>
> +<listitem>
> +<para>Enter a comma separated list of hostnames or ip addresses that should
> +be excluded from using the above proxy settings. If you want to exclude
> all +hosts for a given domain, then simply enter the domain name preceded
> by a dot. +For example, to exclude all hostnames for kde.org, enter
> <userinput>.kde.org</userinput>. +Wildcard characters such as
> <userinput>*</userinput> or <userinput>?</userinput> +are not supported and
> will have no effect.
> +Additionally, you can also enter IP addresses, e.g. 127.0.0.1 and
> +IP addresses with a subnet, e.g. 192.168.0.1/24.</para>
> +</listitem>
> +</varlistentry>
> +</variablelist>
> +
> +<para>You can also choose <guilabel>Use proxy settings only for addresses
> +in the Exceptions list</guilabel>.</para>
> +
> +<para>Check this box to reverse the use of the exception list, &ie;
> +the proxy servers will only be used when the requested &URL; matches
> +one of the addresses listed here.</para>
> +
> +<para>This feature is useful if all you need is a proxy to access a
> +few specific sites, for example, an internal intranet. If you have
> +more complex requirements you might want to use a configuration
> +script.</para>
> +</listitem>
> +</varlistentry>
> +</variablelist>
> +
> +</sect2>
> +<!-- not in 4.8 anymore
> +
> +What if authorization is needed?
> +
> +<sect2 id="authorization">
> +<title><guilabel>Authorization</guilabel></title>
> +
> +<para>Here you can choose between two types of authentication, if your
> +proxy requires it. You can have <guilabel>Prompt as
> +needed</guilabel>, the default, in which case &konqueror; will only
> +ask for a username or password if it needs to.</para>
> +
> +<para>The other option is to use automatic login.
> +Select this option and enter <guilabel>Username</guilabel> and
> <guilabel>Password</guilabel>. +</para>
> +
> +</sect2>
> +
> +<sect2 id="options">
> +<title><guilabel>Options</guilabel></title>
> +<variablelist>
> +<varlistentry>
> +<term><guilabel>Use persistent connections to proxy</guilabel></term>
> +<listitem>
> +<para>Use persistent connection to your proxy server. Keeps connection to
> proxy open, helps lower bandwidth/speed up connection. Enabling this option
> will require the proxy server's cooperation, if the proxy server does not
> support this, it will bring your internet to a stop. </para> +</listitem>
> +</varlistentry>
> +</variablelist>
> +
> +</sect2>
> +-->
> +</sect1>
> +
> +</article>
> diff --git a/docs/kcontrol/smb/CMakeLists.txt
> b/docs/kcontrol/smb/CMakeLists.txt new file mode 100644
> index 0000000..3285ccf
> --- /dev/null
> +++ b/docs/kcontrol/smb/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/smb) diff --git
> a/docs/kcontrol/smb/index.docbook b/docs/kcontrol/smb/index.docbook new
> file mode 100644
> index 0000000..0940297
> --- /dev/null
> +++ b/docs/kcontrol/smb/index.docbook
> @@ -0,0 +1,104 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="smb" lang="&language;">
> +<articleinfo>
> +<title>Windows Shares</title>
> +<authorgroup>
> +<author>&Mike.McBride; &Mike.McBride.mail;</author>
> +<author>&Jost.Schenck; &Jost.Schenck.mail;</author>
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2013-12-05</date>
> +<releaseinfo>&kde; 4.12</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>Systemsettings</keyword>
> +<keyword>Windows shares</keyword>
> +</keywordset>
> +</articleinfo>
> +<sect1 id="windows-shares">
> +<title>Windows Shares</title>
> +
> +<sect2 id="windows-shares-intro">
> +<title>Introduction</title>
> +
> +<para>In many small local area networks, the <acronym>SMB</acronym>
> +protocol is used to offer network services. Names like
> +<quote>&Windows; Network</quote> or <quote>&Windows; for Workgroups
> +Network</quote> or <quote>LanManager</quote> are often used as
> +well. Using <acronym>SMB</acronym> you can access so-called
> +<quote>shares</quote> (&ie; folders made available by the server)
> +as well as printers. </para>
> +
> +<para>&kde; comes with built-in support for the <acronym>SMB</acronym>
> +protocol. As &kde; is network-transparent that means you can access
> +<acronym>SMB</acronym> shares from everywhere you can access your
> +local files, for example in the &konqueror; file manager and in the
> +file dialog. To make use of this you should provide &kde; with some
> +information on your <acronym>SMB</acronym> network. But don't worry,
> +this is normally pretty simple as, for example, all the Windows
> +clients in your network need and have the same information.</para>
> +
> +<!-- Don't know if the following info should go in the base
> +documentation -->
> +
> +<!-- this smb-ioslave doesn't support showing a list
> +of hosts (like e.g. smb:/), for this you need the lan or rlan-ioslave,
> +very cool thing (TM) btw. If you want to write some documentation for
> +this one too, have a look at kdenetwork/lanbrowsing/lisa/README and
> +contact me if you have questions. -->
> +
> +<note><para>For the <acronym>SMB</acronym> protocol to work, it is
> +required to have <application>Samba</application> correctly
> +installed.</para></note>
> +
> +<!-- TODO: link to some place which explains USING SMB, i.e. konqueror
> +or file dialog manual -->
> +
> +</sect2>
> +
> +<sect2 id="windows-shares-use">
> +<title>Use</title>
> +
> +<para>Although there are a lot of insecure <acronym>SMB</acronym>
> +networks out there which allow access to anyone, in principle you have
> +to authenticate yourself to access the services of an
> +<acronym>SMB</acronym> server. By default, &kde; will use the data
> +entered in the <guilabel>Default user name</guilabel> and
> +<guilabel>Default password</guilabel> fields to authenticate itself on
> +<acronym>SMB</acronym> hosts. If you leave the field <guilabel>Default
> +user name</guilabel> empty, &kde; will try to access
> +<acronym>SMB</acronym> hosts without a username. If you leave the
> +default password empty, it will try without a password. If &kde; is
> +unsuccessful accessing the host using these settings, you will be
> +asked for a username and a password.</para>
> +
> +<important><para>While it makes things more comfortable if &kde;
> +stores your <acronym>SMB</acronym> password, this may be a security
> +problem. If you are using <acronym>SMB</acronym> in a security
> +conscious environment, you should not store your password here but
> +rather enter it anew every time you need to access an
> +<acronym>SMB</acronym> host.</para></important>
> +
> +<!-- not in kde 4
> +<para>In the <guilabel>Workgroup</guilabel> field, you can enter your
> +workgroup name. If you don't know it, ask your system administrator
> +or have a look at other already configured machines in your network.
> +However, in most cases providing the workgroup name is not required,
> +so you probably can also leave this empty.</para>
> +
> +<para>If the option <guilabel>Show hidden shares</guilabel> is
> +checked, shares ending with a <quote>$</quote> will be shown.</para>
> +-->
> +</sect2>
> +
> +</sect1>
> +
> +</article>
> diff --git a/docs/kcontrol/useragent/CMakeLists.txt
> b/docs/kcontrol/useragent/CMakeLists.txt new file mode 100644
> index 0000000..35165d2
> --- /dev/null
> +++ b/docs/kcontrol/useragent/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/useragent) diff --git
> a/docs/kcontrol/useragent/index.docbook
> b/docs/kcontrol/useragent/index.docbook new file mode 100644
> index 0000000..8300868
> --- /dev/null
> +++ b/docs/kcontrol/useragent/index.docbook
> @@ -0,0 +1,110 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="useragent" lang="&language;">
> +<title>Browser Identification</title>
> +<articleinfo>
> +<authorgroup>
> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2009-11-24</date>
> +<releaseinfo>&kde; 4.4</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>Systemsettings</keyword>
> +<keyword>user agent</keyword>
> +<keyword>browser</keyword>
> +<keyword>identification</keyword>
> +</keywordset>
> +
> +</articleinfo>
> +
> +<sect1 id="user-agent">
> +<title>Browser Identification</title>
> +
> +
> +<sect2 id="user-agent-intro">
> +<title>Introduction</title>
> +
> +<para>When &konqueror; connects to a web site to retrieve information,
> +some basic identifying information is sent to the web site in the form
> +of a <quote>User Agent</quote> header.</para>
> +
> +<para>Because of minor differences in the way that different web
> +browsers function, web sites that rely too much on a single browser may
> +sometimes not display as intended when viewed using another
> +browser. Some web sites are smart enough to examine the contents of the
> +user agent header and incorporate this information in the
> +&HTML; code so that the content is displayed correctly
> +regardless of the browser used.</para>
> +
> +<para>However, you may find that some web sites refuse to function
> +correctly unless you are using a browser recognized as
> +<quote>proper</quote> by that site. In these cases, you may find it
> +necessary to fool the web site by having &konqueror; report itself to be
> +another browser by means of the user agent header.</para>
> +
> +</sect2>
> +
> +<sect2 id="user-agent-use">
> +<title>Use</title>
> +
> +<para>In this module you can configure the
> +type of browser that &konqueror; will report itself to be. You can
> +control this information by web site. Usually, the list box that is
> +labeled <guilabel>Site Specific Identification</guilabel> will be
> +empty, so that &konqueror; will always use its default useragent
> +string.</para>
> +
> +<para>You can disable the sending of a user agent entirely, by
> +unchecking the <guilabel>Send identification</guilabel>
> +check box. This may cause strange behavior on some sites, and may even
> +deny you access to some websites, so disable this with caution.</para>
> +
> +<para>To configure a new agent binding, press the
> +<guibutton>New...</guibutton> button. Type the name of the server or
> +a domain in the text box at the top of the dialog that pops up, which
> +is labeled <guilabel>When browsing the following
> +site</guilabel>.</para>
> +
> +<para>Note that you can <emphasis>not</emphasis> use the wildcard
> +character <token>*</token> in this text box. However, the string
> +<userinput>kde.org</userinput> will match all hosts in the domain
> +<systemitem>kde.org</systemitem></para>
> +
> +<para>After typing the name of the server, type in the identifying
> +string in the next combo box, which is labeled <guilabel>Use the
> +following identification:</guilabel>, or choose a string from the list. If
> +you don't choose a string from the list, you will need to know what a
> +valid string from the browser looks like. For example, you could type
> +<userinput>Mozilla/4.0 (compatible; MSIE 4.0)</userinput>. </para>
> +
> +<para>You can click on an existing entry in the list, and then modify the
> contents of the +text boxes, followed by clicking
> <guibutton>Change...</guibutton>.</para> +
> +<para>The <guibutton>Delete</guibutton> button can be used to delete
> +the selected entry in the list of configured agent bindings. The
> +<guibutton>Delete All</guibutton> will remove all the configured user
> +agent strings. Click the <guibutton>Apply</guibutton> to take your
> +changes in effect.</para>
> +
> +<para>You can use the check boxes at the top of the screen to build a
> +user agent that is uniquely yours, by choosing your own combination of
> +operating system name and version, platform, processor type, and
> +language.</para>
> +
> +<para>In all cases, the user agent that is being sent by default is
> +displayed in bold text at the top of the page.</para>
> +
> +</sect2>
> +
> +</sect1>
> +
> +</article>
> \ No newline at end of file
> diff --git a/docs/kcontrol/webshortcuts/CMakeLists.txt
> b/docs/kcontrol/webshortcuts/CMakeLists.txt new file mode 100644
> index 0000000..7324220
> --- /dev/null
> +++ b/docs/kcontrol/webshortcuts/CMakeLists.txt
> @@ -0,0 +1,2 @@
> +########### install files ###############
> +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION
> ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/webshortcuts) diff --git
> a/docs/kcontrol/webshortcuts/index.docbook
> b/docs/kcontrol/webshortcuts/index.docbook new file mode 100644
> index 0000000..de3d743
> --- /dev/null
> +++ b/docs/kcontrol/webshortcuts/index.docbook
> @@ -0,0 +1,173 @@
> +<?xml version="1.0" ?>
> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant
> V1.1//EN" +"dtd/kdedbx45.dtd" [
> +<!ENTITY % addindex "IGNORE">
> +<!ENTITY % English "INCLUDE" > <!-- change language only here -->
> +]>
> +
> +<article id="ebrowsing" lang="&language;">
> +<articleinfo>
> +<title>Web Shortcuts</title>
> +<authorgroup>
> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
> +<author>&Yves.Arrouye; &Yves.Arrouye.mail;</author>
> +<!-- TRANS:ROLES_OF_TRANSLATORS -->
> +</authorgroup>
> +
> +<date>2013-05-30</date>
> +<releaseinfo>&kde; 4.11</releaseinfo>
> +
> +<keywordset>
> +<keyword>KDE</keyword>
> +<keyword>Systemsettings</keyword>
> +<keyword>enhanced browsing</keyword>
> +<keyword>web shortcuts</keyword>
> +<keyword>browsing</keyword>
> +</keywordset>
> +
> +</articleinfo>
> +<sect1 id="ebrowse">
> +
> +<title>Web Shortcuts</title>
> +
> +<sect2 id="ebrowse-intro">
> +
> +<title>Introduction</title>
> +
> +<para>&konqueror; offers some features to enhance your browsing
> +experience. One such feature is <emphasis>Web Shortcuts</emphasis>.</para>
> +
> +<para>You may already have noticed that &kde; is very Internet friendly.
> +For example, you can click on the <guimenuitem>Run</guimenuitem> menu
> +item or type the keyboard shortcut assigned to that command (<keycombo
> +action="simul">&Alt;<keycap>F2</keycap></keycombo>,
> +unless you have changed it) and type in a &URI;.
> +<footnote><para>Uniform Resource Identifier. A standardized way of
> +referring to a resource such as a file on your computer, a World Wide
> +Web address, an email address,
> +<abbrev>etc...</abbrev>.</para></footnote></para>
> +
> +<para>Web shortcuts, on the other hand, let you come up with new pseudo
> +&URL; schemes, or shortcuts, that basically let you
> +<emphasis>parameterize</emphasis> commonly used
> +&URI;s. For example, if you like the Google search
> +engine, you can configure &kde; so that a pseudo &URL;
> +scheme like <emphasis>gg</emphasis> will trigger a search on
> +Google. This way, typing <userinput>gg:<replaceable>my
> +query</replaceable></userinput> will search for <replaceable>my
> +query</replaceable> on Google.</para>
> +
> +<note><para>One can see why we call these pseudo &URL;
> +schemes. They are used like a &URL; scheme, but the
> +input is not properly &URL; encoded, so one will type
> +<userinput>google:kde apps</userinput> and not
> +<userinput>google:kde+apps</userinput>.</para></note>
> +
> +<para>You can use web
> +shortcuts wherever you would normally use
> +&URI;s. Shortcuts for several search engines should
> +already be configured on your system, but you can add new keywords, and
> +change or delete existing ones in this module. </para>
> +
> +</sect2>
> +
> +<sect2 id="ebrowse-use">
> +
> +<title>Web Shortcuts</title>
> +
> +<para>The descriptive names of defined web shortcuts are shown in a
> +list box. As with other lists in &kde;, you can click on a column
> +heading to toggle the sort order between ascending and
> +descending, and you can resize the columns.</para>
> +
> +<para>At the bottom of the list the option <guilabel>Enable Web
> shortcuts</guilabel> +has to be checked to enable this feature. Use the
> buttons on the right to +create, modify or delete shortcuts.</para>
> +
> +<para>If <guilabel>Use preferred shortcuts only</guilabel> is checked, only
> +web shortcuts marked as preferred in the third column of the list +are
> used in places where only a few select
> +shortcuts can be shown at one time.
> +</para>
> +
> +<para>Below the list you find two additional options:</para>
> +<variablelist>
> +<varlistentry><term><guilabel>Default Web shortcuts</guilabel></term>
> +<listitem>
> +<para>Select the search engine to use for input boxes that provide
> automatic +lookup services when you type in normal words and phrases
> instead of a &URL;. +To disable this feature select
> <guilabel>None</guilabel> from the list. +</para></listitem>
> +</varlistentry>
> +<varlistentry><term><guilabel>Keyword delimiter</guilabel></term>
> +<listitem>
> +<para>Choose the delimiter that separates the keyword from the phrase or
> word to +be searched.</para></listitem>
> +</varlistentry>
> +</variablelist>
> +
> +<para>If you double-click on a specific entry in the list of defined
> +search providers or click the <guibutton>Change</guibutton> button,
> +the details for that entry are shown in a popup
> +dialog. In addition to the descriptive name for the item, you can
> +also see the &URI; which is used, as well as the
> +associated shortcuts which you can type anywhere in &kde; where
> +&URI;s are expected. A given search provider can have
> +multiple shortcuts, each separated by a comma.</para>
> +
> +<para> The text boxes are used not only for displaying information
> +about an item in the list of web shortcuts, but also for modifying or
> +adding new items.</para>
> +
> +<para>You can change the contents of either the <guilabel>Shortcut
> +URL</guilabel> or the <guilabel>Shortcuts</guilabel> text box.
> +Click <guibutton>OK</guibutton> to save your changes or
> +<guibutton>Cancel</guibutton> to exit the dialog with no
> +changes.</para>
> +
> +<para>If you examine the contents of the <guilabel>Shortcuts
> +URL</guilabel> text box, you will find that most, if not all of the
> +entries have a <option>\{@}</option> in them. This sequence of four
> +characters acts as a parameter, which is to say that they are replaced
> +by whatever you happen to type after the colon character that is
> +between a shortcut and its parameter. To add this query placeholder
> +to a shortcuts url, click on the button at the right of the text box.
> +Let's consider some examples to clarify how to use web shortcuts.</para>
> +
> +<para>Suppose that the &URI; is
> +<userinput>http://www.google.com/search?q=\{@}</userinput>, and
> +<userinput>gg</userinput> is a shortcut to this
> +&URI;. Then, typing
> +<userinput>gg:<replaceable>alpha</replaceable></userinput> is
> +equivalent to
> +<userinput>http://www.google.com/search?q=<replaceable>alpha</replaceable><
> /userinput>. +You could type anything after the <userinput>:</userinput>
> character; +whatever you have typed simply replaces the
> <option>\{@}</option> +characters, after being converted to the appropriate
> character set for +the search provider and then properly
> +&URL;-encoded. Only the <option>\{@}</option> part of
> +the search &URI; is touched, the rest of it is
> +supposed to be properly &URL;-encoded already and is
> +left as is.</para>
> +
> +<para>You can also have shortcuts without parameters. Suppose the
> +&URI; was
> +<emphasis>file:/home/me/mydocs/calligra/words</emphasis> and the
> +shortcut was <emphasis>mywords</emphasis>. Then, typing
> +<userinput>mywords:</userinput> is the same as typing the complete
> +&URI;. Note that there is nothing after the colon
> +when typing the shortcut, but the colon is still required in order for
> +the shortcut to be recognized as such.</para>
> +
> +<para>By now, you will have understood that even though these shortcuts
> +are called web shortcuts, they really are shortcuts to parameterized
> +&URI;s, which can point not only to web sites like
> +search engines but also to anything else that can be pointed to by a
> +&URI;. Web shortcuts are a very powerful feature of
> +navigation in &kde;.</para>
> +
> +</sect2>
> +
> +</sect1>
> +
> +</article>
More information about the kde-doc-english
mailing list