Help handbook updates.

1 files changed, 59 insertions, 64 deletions

diff --git a/doc/faq/webbrowse.docbook b/doc/faq/webbrowse.docbook
index 7de7bbb9d..d1ee69240 100644
--- a/doc/faq/webbrowse.docbook
+++ b/doc/faq/webbrowse.docbook
@@ -4,30 +4,31 @@
 
 <chapter id="webbrowser">
 <title>Webbrowsing with &konqueror;</title>
-<para>&konqueror; is &tde;'s open source, standards compliant webbrowser.
-It's home page is
-<ulink
-url="http://www.konqueror.org">http://www.konqueror.org</ulink> where a
-&konqueror; specific <acronym>FAQ</acronym> can be found.</para>
+<para>&konqueror; is &tde;'s default web browser. Please refer to
+the <ulink url="help:/konqueror/index.html">
+Konqueror Handbook</ulink> for detailed information.</para>
 
 <qandaset>
 
 <qandaentry>
 <question><para>Where does the name &konqueror; come from?</para></question>
-<answer><para>It's a word play on the other browsers' names. After the Navigator and the Explorer comes the Conqueror; it's spelled with a K to show that it's part of &tde;. The name change also moves away from <quote>kfm</quote> (the &tde; file manager, &konqueror;'s predecessor) which represented only file management.</para></answer>
+<answer><para>It's a word play on the other browsers' names. After the Navigator
+and the Explorer comes the Conqueror.</para>
+</answer>
 </qandaentry>
 
 <qandaentry>
 <question><para>Can I run &konqueror; without running &tde;?</para></question>
-<answer><para>Yes. Just install &Qt;, tdelibs and tdebase, and from your favorite window manager just launch &konqueror;. It should work just fine, but if it doesn't (&tde; developers don't test that case often), report it to http://bugs.kde.org and try running "tdeinit" before running &konqueror;, it usually helps. 
-This is of course the same for any other &tde; application. </para>
+<answer><para>Yes. Install &Qt;, tdelibs, and tdebase. From your window manager launch &konqueror;. It should work just fine, but if it doesn't (&tde; developers don't often test that use case), report the problem to <ulink
+url="http://bugs.pearsoncomputing.net/">http://bugs.pearsoncomputing.net/</ulink>. Before reporting a bug, try running "tdeinit" before running &konqueror;. This is of course the same for any other &tde; application running in
+a non &tde; setup.</para>
 </answer>
 </qandaentry>
 
 <qandaentry>
 <question><para>Why doesn't &konqueror; show the contents of an image's <sgmltag class="attribute">ALT</sgmltag> attribute in a tooltip?</para></question>
 <answer><para>
-There is no standard that states the <sgmltag class="attribute">ALT</sgmltag> attribute should appear as a tooltip. The specification calls for <sgmltag class="attribute">ALT</sgmltag> to be displayed in place of the image, as in text-mode only browsers such at lynx or w3m. Abusing the <sgmltag class="attribute">ALT</sgmltag> attribute is bad for accessibility. Tooltips are supposed to come from the <sgmltag class="attribute">TITLE</sgmltag> attribute and this is implemented in &konqueror;
+There is no standard that states the <sgmltag class="attribute">ALT</sgmltag> attribute should appear as a tooltip. The specification calls for <sgmltag class="attribute">ALT</sgmltag> to be displayed in place of the image, as in text-mode only browsers such at lynx or w3m. Abusing the <sgmltag class="attribute">ALT</sgmltag> attribute is bad for accessibility. Tooltips are supposed to come from the <sgmltag class="attribute">TITLE</sgmltag> attribute and this is implemented in &konqueror;.
 </para></answer>
 </qandaentry>
 
@@ -36,11 +37,11 @@ There is no standard that states the <sgmltag class="attribute">ALT</sgmltag> at
 <para>How do I use &konqueror; as a web browser with a proxy?</para>
 </question>
 <answer>
-<para>&konqueror; can be used with &HTTP; and &FTP; proxies.  To set
-up the proxy server in &konqueror;, just select
+<para>&konqueror; can be used with &HTTP; and &FTP; proxies. To set
+up the proxy server in &konqueror;, select
 <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
 &konqueror;...</guisubmenu></menuchoice> from the &konqueror; menu and
-go to the <guilabel>Proxy</guilabel> tab.</para>
+select the <guilabel>Proxy</guilabel> option.</para>
 </answer>
 </qandaentry>
 
@@ -49,20 +50,22 @@ go to the <guilabel>Proxy</guilabel> tab.</para>
 <para>How do I import bookmarks from another browser into &konqueror; ?</para>
 </question>
 <answer>
-<para>To import bookmarks from another browser into &konqueror; select
-<guimenu>Bookmarks</guimenu><guimenuitem>Edit Bookmarks</guimenuitem>
-and then in the <application>Bookmark Editor</application> select
-<guimenu>File</guimenu><guimenuitem>Import</guimenuitem>. Then select
-the browser you would like to import bookmarks from. In the Open dialog,
+<para>To import bookmarks from another browser into &konqueror;, from the menu
+bar select <guimenu>Bookmarks</guimenu>, then select <guimenuitem>Edit Bookmarks</guimenuitem>.
+In the <application>Bookmark Editor</application>, select
+<guimenu>File</guimenu> then select <guimenuitem>Import</guimenuitem>. Select
+the browser from which you would like to import bookmarks. In the Open dialog,
 navigate to the location of the folder or file your bookmarks are
-contained in and click <guilabel>Open</guilabel>
+located.
 </para>
 </answer>
 </qandaentry>
 
 <qandaentry>
 <question><para>How can I make &konqueror; only show certain bookmarks in the bookmarks toolbar?</para></question>
-<answer><para>In &konqueror; go to <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice>. Then select <guilabel>Web Behaviour</guilabel> from the icon list. Under the <guilabel>Bookmarks</guilabel> heading, place a check in the box next to <guilabel>Show only marked bookmarks in bookmark toolbar</guilabel>. Now in the <application>Bookmark Editor</application> an option to <guilabel>Show in Toolbar</guilabel> appears on clicking with the &RMB; on any bookmark entry or in the <guimenu>Edit</guimenu> menu when the entry is highlighted. Folders can also be shown in the bookmarks toolbar in much the same way.</para></answer>
+<answer><para>In &konqueror; select <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
+&konqueror;...</guisubmenu></menuchoice>. Then select <guilabel>Web Behaviour</guilabel> from the icon list. Under the <guilabel>Bookmarks</guilabel> heading, place a check in the box next to <guilabel>Show only marked bookmarks in bookmark toolbar</guilabel>.</para>
+<para>In the <application>Bookmark Editor</application> an option to <guilabel>Show in Toolbar</guilabel> appears on clicking with the &RMB; on any bookmark entry or in the <guimenu>Edit</guimenu> menu when the entry is highlighted. Folders can also be shown in the bookmarks toolbar in much the same way.</para></answer>
 </qandaentry>
 
 <qandaentry>
@@ -71,21 +74,22 @@ contained in and click <guilabel>Open</guilabel>
 some other browser?</para>
 </question>
 <answer>
-<para>In &konqueror;, select
-<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
-Konqueror...</guimenuitem></menuchoice> and in the configuration
-dialog, select <guilabel>Browser Identification</guilabel>. Default
-and site-specific browser identifications can be set from here.</para>
+<para>That is called setting the user agent. In &konqueror;, select
+<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
+&konqueror;...</guisubmenu></menuchoice>. In the icon list, select
+<guilabel>Browser Identification</guilabel>. Default
+and site-specific browser identifications can be set there.</para>
 </answer>
 </qandaentry>
+
 <qandaentry>
 <question>
-<para>&konqueror; is taking a really long time to load webpages, what
+<para>&konqueror; is taking a really long time to load web pages  -- mdash; what
 could cause this?</para></question>
 <answer>
-<para>Quite often &konqueror; loading webpages slowly is caused by
+<para>Quite often &konqueror; loading web pages slowly is caused by
 <acronym>DNS</acronym> servers with broken <acronym>IPV6</acronym>
-support.  Adding the following to <filename>/etc/profile</filename> or any
+support. Adding the following to <filename>/etc/profile</filename> or any
 other script that is sourced on login should solve this problem:
 <screen>
 export TDE_NO_IPV6=true
@@ -103,29 +107,25 @@ setenv TDE_NO_IPV6 true
 <para>How do I configure &konqueror; to run &Java; applets?</para>
 </question>
 <answer>
-<para>Choose
-<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
-&konqueror;...</guimenuitem></menuchoice> from &konqueror;'s menubar
-and then select <guilabel>Java &amp; Javascript</guilabel>. Set the
-<guilabel>Path to Java executable</guilabel> correctly. If it doesn't
-work, please check the <ulink
-url="http://www.konqueror.org/javahowto/">Konqueror + Java
-HOWTO</ulink>.</para>
+<para>From &konqueror;'s menubar choose
+<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
+&konqueror;...</guisubmenu></menuchoice>.
+From the icon list select <guilabel>Java &amp; Javascript</guilabel>. Set the
+<guilabel>Path to Java executable</guilabel>.</para>
 </answer>
 </qandaentry>
 
-
 <qandaentry>
 <question>
 <para>How do I block unrequested popup windows in &konqueror;?</para>
 </question>
 <answer>
-<para>&konqueror; has a new 'smart' policy for JavaScript popups. From the 
-&konqueror; main window, select <menuchoice><guimenu>Settings</guimenu>
-<guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice> and then
+<para>&konqueror; provides a 'smart' policy for JavaScript popups. From the
+&konqueror; main window, select<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
+&konqueror;...</guisubmenu></menuchoice>. Then
 <guilabel>Java &amp; JavaScript</guilabel>. On the
 <guilabel>JavaScript</guilabel> tab, under <guilabel>Global JavaScript
-Policies</guilabel> set the radio button beside <guilabel>Open new
+Policies</guilabel>, set the radio button beside <guilabel>Open new
 windows:</guilabel> to <guilabel>Smart</guilabel>.
 </para>
 </answer>
@@ -133,18 +133,16 @@ windows:</guilabel> to <guilabel>Smart</guilabel>.
 
 <qandaentry>
 <question>
-<para>Why doesn't my banking site work with &konqueror;?  It pops up a new
+<para>Why doesn't my banking site work with &konqueror;? It pops up a new
 window with the login screen in other browsers, but not in
 &konqueror;.</para>
 </question>
 <answer>
 <para>
 Make sure you have Javascript enabled, and the default JavaScript web popups
-policy set to <guilabel>Ask</guilabel> or <guilabel>Allow</guilabel>.  The
+policy set to <guilabel>Ask</guilabel> or <guilabel>Allow</guilabel>. The
 <guilabel>Smart</guilabel> policy is not always sufficient for some banks.
-Many banks also require &Java; support.  You can find more help on enabling
-this at <ulink
-url="http://www.konqueror.org/">http://www.konqueror.org/</ulink>.
+Many banks also require &Java; support.
 </para>
 </answer>
 </qandaentry>
@@ -152,33 +150,28 @@ url="http://www.konqueror.org/">http://www.konqueror.org/</ulink>.
 <qandaentry>
 <question>
 <para>Can &konqueror; use user-specified stylesheets, like those in the
-Firefox adblock extention?</para>
+Firefox adblock extension?</para>
 </question>
 <answer>
 <para>Yes, you can set &konqueror; to use any kind of valid
 <acronym>css</acronym> stylesheet to filter webcontent or improve accessibility.
 From the &konqueror; main window simply click
-<menuchoice><guimenu>Settings</guimenu>
-<guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice> and select 
+<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
+&konqueror;...</guisubmenu></menuchoice> and select
 <guilabel>Stylesheets</guilabel>. Set the radio button to
 <guilabel>Use user-defined stylesheet</guilabel> and browse to where the
-stylesheet you want to use is located. Alternatively, you can select
+stylesheet you want to use is located. Alternately, select
 <guilabel>Use accessibility stylesheet defined in "Customize"
 tab</guilabel> and then set your own options.</para>
-<para>
-An example of <acronym>css</acronym> rules that implement ad blocking can be
-found at:
-<ulink url="http://www.mozilla.org/support/firefox/adblock">
-http://www.mozilla.org/support/firefox/adblock</ulink>.
-</para>
 </answer>
 </qandaentry>
+
 <qandaentry>
 <question><para>
 Why does &konqueror; display a plain grey square when I try to view flash animations, even though the flash plugin is installed?
 </para></question>
 <answer><para>
-Under the latest versions of X.org, having the composite extension loaded can cause problems with the flash plugin. Try disabling the composite extension and see if normal flash operation is restored.
+Under the latest versions of X.org, having the composite extension loaded can cause problems with the flash plugin. Try disabling the composite extension and see whether normal flash operation is restored.
 </para></answer>
 </qandaentry>
 
@@ -187,7 +180,7 @@ Under the latest versions of X.org, having the composite extension loaded can ca
 <para>Why can't &konqueror; render &GIF; images?</para>
 </question>
 <answer>
-<para>It is because you did not enable &GIF; support in &Qt;.  Please see
+<para>It is because you did not enable &GIF; support in &Qt;. Please see
 <xref linkend="gif"/> for more details.</para>
 </answer>
 </qandaentry>-->
@@ -199,14 +192,18 @@ associated Konqueror with text/html, but it cannot handle this file
 type.</quote></para>
 </question>
 <answer>
-<para>You need to make sure that the embedding settings for the text/html
+<para>Make sure the embedding settings for the text/html
 <acronym>MIME</acronym> type are correct:
 <orderedlist>
 <listitem><para>In &konqueror;, go to
-<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
-&konqueror;...</guimenuitem></menuchoice> and then to the <guilabel>File
-Associations</guilabel> page.</para></listitem> <listitem><para>Open
-text->html in the tree view.</para></listitem> <listitem><para>Click on the
+<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
+&konqueror;...</guisubmenu></menuchoice>. In the icon list select <guilabel>File
+Associations</guilabel>.</para>
+</listitem>
+<listitem><para>Open
+text->html in the tree view.</para>
+</listitem>
+<listitem><para>Click on the
 <guilabel>Embedding</guilabel> tab. Make sure that <guilabel>Left Click
 Action</guilabel> is set to <guilabel>Show file in embedded
 viewer</guilabel>, and that <guilabel>KHTML (khtml)</guilabel> is at the top
@@ -218,5 +215,3 @@ of <guilabel>Services Preference Order</guilabel>.</para></listitem>
 
 </qandaset>
 </chapter>
-
-