[konqueror] doc/kcontrol: update konqui browser kcm docs, cmake files missing, X-DocPath's still wrong, but the docbooks have to go in now to avoid trouble with our translators
Burkhard Lück
lueck at hube-lueck.de
Tue Nov 8 12:36:00 UTC 2016
Git commit e375da5d56aff4a38bd7387d69a2a1c68c1a2ea9 by Burkhard Lück.
Committed on 01/12/2009 at 15:34.
Pushed by lueck into branch 'master'.
update konqui browser kcm docs, cmake files missing, X-DocPath's still wrong, but the docbooks have to go in now to avoid trouble with our translators
svn path=/trunk/KDE/kdebase/runtime/; revision=1057142
M +174 -64 doc/kcontrol/kcmcss/index.docbook
A +69 -0 doc/kcontrol/khtml-adblock/index.docbook
A +88 -0 doc/kcontrol/khtml-behavior/index.docbook
A +142 -0 doc/kcontrol/khtml-java-js/index.docbook
http://commits.kde.org/konqueror/e375da5d56aff4a38bd7387d69a2a1c68c1a2ea9
diff --git a/doc/kcontrol/kcmcss/index.docbook b/doc/kcontrol/kcmcss/index.docbook
index f7d6d96..fea539e 100644
--- a/doc/kcontrol/kcmcss/index.docbook
+++ b/doc/kcontrol/kcmcss/index.docbook
@@ -13,23 +13,137 @@
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
-<date>2003-10-12</date>
-<releaseinfo>3.2</releaseinfo>
+<date>2009-12-01</date>
+<releaseinfo>&kde; 4.4</releaseinfo>
<keywordset>
<keyword>KDE</keyword>
<keyword>CSS</keyword>
+<keyword>Appearance</keyword>
+<keyword>Font</keyword>
+<keyword>CSS</keyword>
<keyword>Stylesheets</keyword>
<keyword>Accessibility</keyword>
</keywordset>
</articleinfo>
-<sect1 id="stylesheets">
+<sect1 id="appearance">
+<title>Appearance</title>
+<para>This module consists of three tabs with configure options how to display web pages.</para>
+
+<sect2 id="general">
+<title>General</title> <!-- modified copy from khtml/index.docbook <sect2 id="kbrowse-html"-->
+
+<para>The check box labeled <guilabel>Automatically load
+images</guilabel> allows you to control whether images on web pages are
+loaded by default. Unless you have a very slow connection, you will
+probably want to leave this option selected, as there are many web pages
+that are difficult to use without images. If you don't select the option
+to automatically load images, you can still view the text on the page,
+and then load the images if you need them.</para>
+
+<para>If <guilabel>Draw frame around not completely loaded images</guilabel>
+is checked, &konqueror; will draw a frame as a placeholder
+around images embedded in a web page that are not yet fully loaded. You
+will probably want to check this box to enhance your browsing experience,
+especially if have a slow network connection.</para>
+
+<para>Many web pages use animated gif images, and these can be very
+annoying, and in some cases, quite a drain on your system resources.
+The <guilabel>Animations</guilabel> option lets you choose when
+animations are enabled. The default is enabled, but you can set this
+to disabled, or to run the animation only once, even if the file
+itself contains instructions that the animation should run more times,
+or continuously.</para>
+
+<para>The next setting is <guilabel>Underline links:</guilabel>. You can
+choose to underline links <guilabel>Enabled</guilabel>. If this option
+is selected, any text on web pages that acts as a link will be shown in
+an underlined font. While many web pages do use color to distinguish
+text that acts as a link, underlining makes it very easy to spot
+links.</para>
+
+<para>If you don't like underlined links, you can choose
+<guilabel>Disabled</guilabel>, so that no links are underlined. Or you
+can choose a middle ground, <guilabel>Only on Hover</guilabel>, so that links
+are underlined when the mouse cursor is resting over them, and not
+underlined the rest of the time.</para>
+
+<note><para>The site's CSS definitions can override this value.</para></note>
+
+<para><guilabel>Smooth scrolling</guilabel>
+determines whether &konqueror; should use smooth steps to scroll &HTML;
+pages, or whole steps:
+<itemizedlist>
+<listitem><para><guilabel>Always</guilabel>: Always use smooth steps
+when scrolling.</para></listitem>
+<listitem><para><guilabel>Never</guilabel>: Never use smooth scrolling, scroll
+with whole steps instead.</para></listitem>
+<listitem><para><guilabel>When Efficient</guilabel>: Only use smooth
+scrolling on pages where it can be achieved with moderate usage of system
+resources.</para></listitem>
+</itemizedlist>
+</para>
+
+</sect2>
+
+<sect2 id="fonts"> <!-- modified copy from khtml/index.docbook <sect2 id="kbrowse-appearance"-->
+<title>Fonts</title>
+<para>Under this tab, you can select various options related to the use
+of fonts. Although the shapes and sizes of fonts are often part of the
+design of a web page, you can select some default settings for
+&konqueror; to use.</para>
+
+<para>The first thing you can set here is the font size. There are two
+settings which work together to allow you a comfortable browsing
+experience.</para>
+
+<para>Firstly, you can set a <guilabel>Minimum font size</guilabel>.
+This means, even if the font size is set specifically in the page you
+are viewing, &konqueror; will ignore that instruction and never show
+smaller fonts than you set here.</para>
+
+<para>Next you can set a <guilabel>Medium font size</guilabel>. This is
+not only the default size of text, used when the page does not specify
+sizes, but it is also used as the base size that relative font sizes are
+calculated against. That is, the &HTML; instruction
+<quote>smaller</quote>, it means smaller than the size you set for this
+option.</para>
+
+<para>For either option, you can select the exact font size in points by
+using the up/down spin control (or just typing) next to the option
+label.</para>
+
+<para>These options are independent of each other. Pages that do not
+set a font size, or ask for the default, will display with the size
+you set from <guilabel>Medium font size</guilabel>, while any pages
+that ask for a size smaller than your <guilabel>Minimum font
+size</guilabel> setting will instead show that size. The one does not
+affect the other.</para>
+
+<para>The remaining options are for the fonts to be associated with
+different types of markup used in &HTML; pages. Note
+that many web pages may override these settings. For any type of font
+(Standard, Fixed, Serif, &etc;) you can select a different font if you like.</para>
+
+<para>Below this, you can set a <guilabel>Font size adjustment for this
+encoding</guilabel>. Sometimes the fonts you want to use for a
+particular encoding or language are much larger or smaller than average,
+so you can use this setting to bring them into line.</para>
+
+<para>You can set a default encoding that &konqueror; should assume
+pages are when rendering them. The default setting is <guilabel>Use
+Language Encoding</guilabel>, but you can change it to any encoding
+available in the list.</para>
+
+</sect2>
+
+<sect2 id="stylesheets">
<title>Stylesheets</title>
-<sect2>
+<sect3>
<title>Introduction</title>
<para><acronym>CSS</acronym> style sheets affect the way web pages
@@ -49,16 +163,12 @@ with &kde;'s own renderer, which is called khtml. These include
&kmail;, &khelpcenter; and of course &konqueror;. Choices here do not
affect other browsers such as &Netscape;.</para>
-<para>The module has two pages, <guilabel>General</guilabel>, where you
-can choose which stylesheet to use, and <guilabel>Customize</guilabel>
-where you can design an accessibility stylesheet.</para>
-
-</sect2>
+</sect3>
-<sect2 id="css-general">
-<title>General</title>
+<sect3 id="css-general">
+<title>Stylesheets</title>
-<para>This page contains the following options:</para>
+<para>This section contains the following options:</para>
<variablelist>
<varlistentry>
@@ -82,32 +192,30 @@ required.</para>
</varlistentry>
<varlistentry>
-<term><guilabel>Use accessibility stylesheet defined in
-"Customize"-tab</guilabel></term>
+<term><guilabel>Use accessibility stylesheet</guilabel></term>
<listitem>
<para>Use the settings defined in the <guilabel>Customize</guilabel>
-tab. Enabling this option will enable the options on the
-<guilabel>Customize</guilabel> page.</para>
+dialog. Enabling this option will enable the <guibutton>Customize</guibutton>
+button lo launch a dialog to define stylesheet settings.</para>
</listitem>
</varlistentry>
</variablelist>
-</sect2>
+</sect3>
-<sect2 id="css-customize">
+<sect3 id="css-customize">
<title>Customize</title>
-<para>Here you can set up a user stylesheet. The options available are
+<para>In this dialog you can set up a user stylesheet. The options available are
only a subset of the instructions you can add in a stylesheet, and they
are geared towards people with reduced vision, to allow users to create
a stylesheet that makes web pages and the &kde; help files more
readable.</para>
-<para>The options on this page are disabled unless you chose
-<guilabel>Use accessibility stylesheet defined in
-"Customize"-tab</guilabel> on the previous page.</para>
+<para>The options in this dialog are disabled unless you chose
+<guilabel>Use accessibility stylesheet</guilabel>.</para>
-<sect3>
+<sect4>
<title><guilabel>Font Family</guilabel></title>
<variablelist>
@@ -128,14 +236,14 @@ headlines.</para>
</listitem>
</varlistentry>
</variablelist>
-</sect3>
+</sect4>
-<sect3>
+<sect4>
<title>Font Size</title>
<variablelist>
<varlistentry>
-<term><guilabel>Base Font Size</guilabel></term>
+<term><guilabel>Base font size</guilabel></term>
<listitem>
<para>This is the default size for text on the page. Many web sites set
their font sizes relative to this default, using <quote>larger</quote>
@@ -149,8 +257,10 @@ in this way.</para>
comfortable size, so that the relative sizes are also enlarged enough to
be comfortable.</para>
<para>Do not forget you can also have &konqueror; enforce a minimum size,
-so that text is <emphasis>never</emphasis> too small to read. Set that
-under Behavior, in the Web Browser section in &kcontrol;.</para>
+so that text is <emphasis>never</emphasis> too small to read.
+<!-- Set that under Behavior, in the Web Browser section in &kcontrol;.
+adapt to new documentation-->
+</para>
</listitem>
</varlistentry>
@@ -165,14 +275,37 @@ here.</para>
</listitem>
</varlistentry>
</variablelist>
-</sect3>
+</sect4>
-<sect3>
+<sect4>
+<title>Images</title>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Suppress images</guilabel></term>
+<listitem>
+<para>If you do not want to view images, you can turn this off
+here.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Suppress background images</guilabel></term>
+<listitem>
+<para>One major problem for reduced vision users is that background
+images do not give sufficient contrast to allow them to read the text.
+You can disable background images here, independently of your choice
+above to view all images.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect4>
+
+<sect4>
<title>Colors</title>
<variablelist>
<varlistentry>
-<term><guilabel>Black on White</guilabel></term>
+<term><guilabel>Black on white</guilabel></term>
<listitem>
<para>Many people with reduced vision find black text on a white screen
gives the most contrast, and is easiest to read. If this applies to
@@ -181,7 +314,7 @@ you, you can set this here.</para>
</varlistentry>
<varlistentry>
-<term><guilabel>White on Black</guilabel></term>
+<term><guilabel>White on black</guilabel></term>
<listitem>
<para>Many other people with reduced vision find the opposite to be
true, that white text on a black screen is easier to read.</para>
@@ -203,51 +336,28 @@ the <guilabel>Background</guilabel> and the
<listitem>
<para>Many web sites use a different, often contrasting color for
headings or other flourishes. If this interferes with your ability to
-read the content, you can enable this checkbox to have &kde; use the
+read the content, you can enable this check box to have &kde; use the
colors you have set above for all text.</para>
</listitem>
</varlistentry>
</variablelist>
-</sect3>
+</sect4>
-<sect3>
-<title>Images</title>
-
-<variablelist>
-<varlistentry>
-<term><guilabel>Suppress images</guilabel></term>
-<listitem>
-<para>If you do not want to view images, you can turn this off
-here.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Suppress background images</guilabel></term>
-<listitem>
-<para>One major problem for reduced vision users is that background
-images do not give sufficient contrast to allow them to read the text.
-You can disable background images here, independently of your choice
-above to view all images.</para>
-</listitem>
-</varlistentry>
-</variablelist>
-
-</sect3>
-
-<sect3>
+<sect4>
<title>Preview</title>
-<para>The <guibutton>Preview</guibutton> allows you to see the effect of
-your changes. A window will pop up, showing how several types of
-headings will appear with your stylesheet, and a sentence in the default
-body text.</para>
+<para>The <guilabel>Preview</guilabel> section allows you to see the effect of
+your changes. Several types of headings are displayed with your stylesheet,
+and a sentence in the default body text.</para>
-<para>This should allow you to fine tune your stylesheet until you have
+<para>This should allow you to fine-tune your stylesheet until you have
something that you can comfortably read.</para>
<para>Happy surfing!</para>
+</sect4>
+
</sect3>
</sect2>
diff --git a/doc/kcontrol/khtml-adblock/index.docbook b/doc/kcontrol/khtml-adblock/index.docbook
new file mode 100644
index 0000000..1a10c02
--- /dev/null
+++ b/doc/kcontrol/khtml-adblock/index.docbook
@@ -0,0 +1,69 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+<!ENTITY nsplugins-kcontrol SYSTEM "nsplugin.docbook">
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;">
+<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>konqueror</keyword>
+<keyword>browsing</keyword>
+<keyword>filter</keyword>
+</keywordset>
+
+</articleinfo>
+
+<sect1 id="khtml-adblock">
+<title>AdBlocK</title>
+
+<para>&konqueror; AdBlocK can be configured to replace or remove
+images or frames from web pages that match a series of filters.</para>
+
+<para>The setting <guilabel>Enable filters</guilabel> enables or
+disables the use of list of URL filters.</para>
+<para>If <guilabel>Hide filtered images</guilabel> is enabled then
+blocked images are completely removed from the page and the space they
+occupied is reclaimed. If the option is disabled then a placeholder
+image is used in place of filtered images.</para>
+
+<para><guilabel>URL Expressions to Filter</guilabel> is a list of
+URLs that will be compared against image and frame names to decide
+on fitlering actions. The wildcards can be given as filename style
+regular expressions.</para>
+
+<para>Use the <guilabel>Search</guilabel> edit box above the list box
+to filter matching entries an the fly.</para>
+
+<para>Each filter can either be expressed as a file style wildcard
+string (e.g. http://www.site.com/ads/*) or as a full regular expression
+by enclosing the filter with forward slashes (e.g. //(ads|dclk)\./).</para>
+
+<para>Any filter string can be preceded by <literal>@@</literal> to whitelist
+(allow) any matching &URL;, which takes priority over any blacklist (blocking)
+filter.</para>
+
+<para><guilabel>Import</guilabel> and <guilabel>Export</guilabel> will
+save or read the current filter list to a
+plain text file. Lines prefixed with an exclamation mark (!) are treated
+as comments and can be used to clarify or label a set of filters.</para>
+
+<para>Highlight an entry from the list to change it in the edit box or remove this item.
+Enter a new filter string here and add it to the list using the <guibutton>
+Insert</guibutton> button.</para>
+</sect1>
+
+</article>
diff --git a/doc/kcontrol/khtml-behavior/index.docbook b/doc/kcontrol/khtml-behavior/index.docbook
new file mode 100644
index 0000000..5223c48
--- /dev/null
+++ b/doc/kcontrol/khtml-behavior/index.docbook
@@ -0,0 +1,88 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+<!ENTITY nsplugins-kcontrol SYSTEM "nsplugin.docbook">
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;">
+<articleinfo>
+
+<authorgroup>
+<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2009-12-01</date>
+<releaseinfo>&kde; 4.4</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>Systemsettings</keyword>
+<keyword>konqueror</keyword>
+<keyword>browsing</keyword>
+</keywordset>
+
+</articleinfo>
+<sect1 id="konq-browsing">
+<title>Web Behavior</title>
+
+<para>The &konqueror; Browser module of &systemsettings; allows you to select
+various options for the behavior of &konqueror;, the
+integrated web browser of &kde;.</para>
+
+<para>If <guilabel>Ask for name and folder when adding bookmarks</guilabel>
+is checked, &konqueror; will allow you to change the title of the
+bookmark and choose a folder in which to store it when you add a new
+bookmark.</para>
+
+<para>Enable <guilabel>Show only marked bookmarks in bookmark toolbar</guilabel>
+and &konqueror; will show only those bookmarks in the
+bookmark toolbar which you have marked to do so in the bookmark editor.</para>
+
+<para>The next option you can enable on this page is <guilabel>Form
+Completion</guilabel>. If you check this box, &konqueror; will
+try to remember what you answer to form questions, and will try to fill
+in forms for you with the answers you previously used.</para>
+
+<para>You can configure the number of form items &konqueror; remembers
+with the slider below labelled <guilabel>Maximum
+completions</guilabel></para>
+
+<note><para>Of course, anything &konqueror; fills in a form with, you
+can still edit before submitting the form!</para></note>
+
+<para>The next option is <guilabel>Change cursor over
+links</guilabel>. If this option is selected, the shape of the cursor
+will change (usually to a hand) whenever it moves over a
+hyperlink. This makes it easy to identify links, especially when they
+are in the form of images.</para>
+
+<para>If <guilabel>Middle click opens URL in selection</guilabel>
+is checked, you can open the &URL; in the selection by middle
+clicking on a &konqueror; view.</para>
+
+<para>As a convenience feature, if you enable <guilabel>Right click
+goes back in history</guilabel>, then clicking an empty area (&ie; not
+a link) in the &konqueror; window will act as if you pressed the
+<guiicon>Back</guiicon> button on the toolbar.</para>
+
+<para>Enabling <guilabel>Allow automatic delayed
+reloading/redirecting</guilabel> allows websites to send you to
+another page without your interaction. In many cases, this is a
+convenience. For example, the website has moved to a new
+&URL;. Many webmasters in this situation will put up
+a page on the old site, telling you that it has moved and you may like
+to change your bookmark, and then automatically move you along to the
+new website. However, such features can be confusing, or annoying,
+when misused, and so you may wish to disable it.</para>
+
+<para><guilabel>Enable Access Key activation with Ctrl key</guilabel>:
+Pressing the &Ctrl; key when viewing web pages activates Access Keys.
+Unchecking this box will disable this accessibility feature. (&konqueror;
+needs to be restarted for this change to take effect.)</para>
+
+</sect1>
+
+</article>
diff --git a/doc/kcontrol/khtml-java-js/index.docbook b/doc/kcontrol/khtml-java-js/index.docbook
new file mode 100644
index 0000000..2f1ead6
--- /dev/null
+++ b/doc/kcontrol/khtml-java-js/index.docbook
@@ -0,0 +1,142 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+<!ENTITY nsplugins-kcontrol SYSTEM "nsplugin.docbook">
+<!ENTITY % addindex "IGNORE">
+<!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;">
+<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>konqueror</keyword>
+<keyword>browsing</keyword>
+<keyword>Java</keyword>
+<keyword>JavaScript</keyword>
+</keywordset>
+
+</articleinfo>
+<sect1 id="konq-browsing">
+<title>&Java; and JavaScript</title>
+
+<sect2 id="kbrowse-java">
+<title>&Java;</title>
+
+<para>&Java; allows applications to be downloaded and run by a web
+browser, provided you have the necessary software installed on your
+machine. Many web sites make use of &Java; (for example, online
+banking services or interactive gaming sites). You should be aware
+that running programs from unknown sources could pose a threat to the
+security of your computer, even if the potential extent of the damage
+is not great.</para>
+
+<para>The checkbox <guilabel>Enable Java globally</guilabel> allows
+you to turn &Java; support on for all web sites by default. You can
+also select to turn &Java; on or off for specific hosts. To add a
+policy for a specific host, click the <guibutton>New...</guibutton>
+button to bring up a dialog in which you can type the host name and
+then choose to accept or reject &Java; code from that particular host,
+which will add the domain to the list on the left of the page.</para>
+
+<para>You can select a host in the list, and click the
+<guibutton>Change...</guibutton> button to choose a different policy for
+that host. Clicking the <guibutton>Delete</guibutton> button removes the
+policy for the selected host; after deletion, the global settings will
+then apply to that host.</para>
+
+<para>Finally, the group of controls labeled <guilabel>Java Runtime
+Settings</guilabel> allows you to set some options for the way in
+which &Java; should run.</para>
+
+<para><guilabel>Use security
+manager</guilabel> is normally enabled by default. This setting will
+cause the <acronym>JVM</acronym> to run with a Security Manager in place. This will keep
+applets from being able to read and write to your file system, creating
+arbitrary sockets, and other actions which could be used to compromise
+your system. Disable this option at your own risk. You can modify your
+<filename>$<envar>HOME</envar>/.java.policy</filename> file with the
+&Java; policytool utility to give code downloaded from certain sites
+more permissions.</para>
+
+<para><guilabel>Use KIO</guilabel> will cause the
+<acronym>JVM</acronym>to use &kde;'s own <acronym>KIO</acronym>
+transports for network connections.</para>
+
+<para>The <guilabel>Shutdown applet server when inactive for more than</guilabel>
+checkbox allows you to save resources by closing the &Java; Applet
+Server when it is not in use, rather than leaving it running in the
+background. Leaving this disabled may make &Java; applets start up
+faster, but it will use system resources when you are not using a
+&Java; applet. If you enable this, you can set a timeout.</para>
+
+<para>You can either opt to have &konqueror; automatically detect the
+&Java; installation on your system, or specify the path to the
+installation yourself by selecting <guilabel>Path to Java
+executable or 'java'</guilabel>. You may want to choose the latter method, for
+instance, if you have multiple &Java; installations on your system,
+and want to specify which one to use. If the &Java; Virtual Machine
+you are using requires any special startup options, you can type them
+in the text box labeled <guilabel>Additional Java
+arguments</guilabel>.</para>
+
+</sect2>
+
+<sect2 id="kbrowse-javascript">
+<title>JavaScript</title>
+
+<para>Despite the name, JavaScript is not related at all to
+&Java;.</para>
+
+<para>The first part of this tab works the same as the &Java; page
+settings.</para>
+
+<para>The checkbox <guilabel>Enable JavaScript globally</guilabel> allows
+you to turn JavaScript support on for all web sites by default. You
+can also select to turn JavaScript on or off for specific hosts. To
+add a policy for a specific host, click the
+<guibutton>New...</guibutton> button to bring up a dialog in which you
+can type the host name and then choose to accept or reject JavaScript
+code from that particular host, which will add the domain to the list
+on the left of the page.</para>
+
+<para>You can select a host in the list, and click the
+<guibutton>Change...</guibutton> button to choose a different policy for
+that host. Clicking the <guibutton>Delete</guibutton> button removes the
+policy for the selected host; after deletion, the global settings will
+then apply to that host.</para>
+
+<para>The final set of options in the section <guilabel>Global JavaScript
+Policies</guilabel> determine what happens
+when a page uses JavaScript for specific actions.</para>
+
+<para>You can individually enable or disable the ability of JavaScript
+to manipulate your windows by moving, resizing or changing focus. You
+can also disable JavaScript from changing the status bar text, so that
+for instance, you can always see where links will take you when
+clicked.The choices for these options are <guilabel>Allow</guilabel> and
+<guilabel>Ignore</guilabel>.</para>
+
+<para>For opening a new window, there is even more control. You can
+set &konqueror; to <guilabel>Allow</guilabel> all such requests,
+<guilabel>Ask</guilabel> each time a request is made, or
+<guilabel>Deny</guilabel> all popup requests.</para>
+
+<para>The <guilabel>Smart</guilabel> setting will only allow
+JavaScript popup windows when you have explicitly chosen a link that
+creates one.</para>
+</sect2>
+
+</sect1>
+
+</article>
More information about the kde-doc-english
mailing list