Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 117 insertions, 0 deletions

diff --git a/doc/kcontrol/useragent/index.docbook b/doc/kcontrol/useragent/index.docbook
new file mode 100644
index 000000000..14be0fcf2
--- /dev/null
+++ b/doc/kcontrol/useragent/index.docbook
@@ -0,0 +1,117 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;">
+<title>Browser Identification</title>
+<articleinfo>
+<authorgroup>
+<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-10-12</date>
+<releaseinfo>3.2</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</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
+<acronym>HTML</acronym> 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/Domain 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>
+checkbox.  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 identity:</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>In the field labeled <guilabel>Alias (description)</guilabel>
+you can enter a descriptive name for the configured binding, &eg;
+<userinput>Netscape Navigator 4.75 on Linux</userinput> for the
+useragent string <userinput>Mozilla/4.75 (X11; U; Linux 2.2.14
+i686)</userinput>.</para>
+
+<para>You can click on an existing entry in the <guilabel>Configured
+agent bindings</guilabel> 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 checkboxes 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