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>
