


<sect1 id="webcontrol">
  <title>WebControl Applet</title> 

  <para> <application>WebControl Applet</application>, shown in <xref
  linkend="webcontrol-applet-fig1">, allows you to launch your
  <application>Netscape</application> browser with the URL you
  indicate in the URL text box. To add this applet
  to a <interface>Panel</interface>, right-click on the panel and choose

 <menuchoice>
	    <guimenu>Panel</guimenu>
	    <guisubmenu>Add to panel</guisubmenu>
	    <guisubmenu>Applet</guisubmenu>
	    <guisubmenu>Network</guisubmenu>
	    <guimenuitem>WebControl</guimenuitem>
	  </menuchoice>
  </para>
  
 
    <figure id="webcontrol-applet-fig1">
     <title>WebControl Applet</title>
     <screenshot>
      <screeninfo>WebControl Applet</screeninfo>
      <graphic format="png" fileref="figures/webcontrol-applet"
	       srccredit="John Fleck">
      </graphic>
    </screenshot>
   </figure>

 
  <sect2 id="webcontrol-applet-usage">
    <title> Usage</title>
    <para> To use this applet, type the URL of the document you wish
    to view in the text box. For an Internet URL, you must type in
    <command>http://</command> followed by the web address, for
    example, <command>http://www.gnome.org</command>. For a local
    file, simply type the file's name. 
    </para>

    <para>If you would like to launch a new browser window instead of
    using the currently active one, check the <guilabel>Launch new
    window</guilabel> check box.</para>

    <para> Right-clicking on the applet brings up a menu containing the
    following items:
      <itemizedlist> 
	
	<listitem>
	  <para>
	    <guimenuitem>Properties</guimenuitem>&mdash; opens the
	    <link linkend="webcontrol-applet-prefs">
                <guilabel>Properties</guilabel>
            </link> dialog
	    </para>
	</listitem>
	  <listitem>
	  <para>
	    <guimenuitem>Help</guimenuitem> &mdash; displays this
            document. 
	    </para>
	</listitem>
	<listitem>
	  <para>
	    <guimenuitem>About</guimenuitem> &mdash; shows basic
            information about <application>WebControl
            Applet</application>, including the applet's version and author's name. 
	    </para>
	</listitem>
	
	
	

      </itemizedlist>
    </para>
  </sect2>

  <sect2 id="webcontrol-applet-prefs">
    <title>Customization</title>
    <para>
      You can customize <application>WebControl Applet</application> by
      right-clicking on it and choosing
      <guimenuitem>Properties&hellip;</guimenuitem>. This will open
      the <interface>Properties</interface> dialog (shown in <xref
      linkend="webcontrol-applet-fig2">), which allows you to
      change various settings.
    </para>
    <figure id="webcontrol-applet-fig2">
     <title>WebControl Properties Dialog</title>
     <screenshot>
      <screeninfo>Preferences dialog</screeninfo>
      <graphic format="png" fileref="figures/webcontrol-applet-prefs"
	       srccredit="John Fleck">
      </graphic>
    </screenshot>
   </figure>
    
 <para>
     The properties are:
     <itemizedlist>

      <listitem>
	    <para><guilabel>Display URL label</guilabel> &mdash;
      display the text <guilabel>Url:</guilabel> to the left of the
      text entry window in the applet.</para>   
      </listitem>

     
      <listitem>
       <para>
        <guilabel>Display "launch new window" option</guilabel>
    &mdash; display check box on the applet window allowing you to
    decide whether your document will be displayed in a new browser
    window or the currently open.</para>
      </listitem>
     </itemizedlist>
    </para>

   <para> 
      After you have made all the changes you want, click on
      <guibutton>OK</guibutton> to apply the changes and close the
      <interface>Properties</interface> dialog. To cancel the changes
      and return to previous values, click the
      <guibutton>Cancel</guibutton> button.
    </para>
  </sect2>
  
  <sect2 id="webcontro-applet-bugs">
    <title>Known bugs and limitations</title>
    <para>
      <application>WebControl Applet</application> only starts
      <application>Netscape</application>. If you don't have
      <application>Netscape</application>, it won't work. If you have
      a different browser set as your URL handler, <application>Web
      Control Applet</application> will still start <application>Netscape</application>.
    </para>
    <para><application>WebControl Applet</application> does not
    resize to match the size of the panel if the panel is smaller than
    <application>WebControl Applet's</application> normal height and width. This
    effects both small horizontal panels and all vertical panels.</para>
  </sect2>



  <!-- ============= Authors ================================ -->

  <sect2 id="authors">
   <title>Authors</title>
   <para>
    <application>WebControl Applet</application> was written by  Garrett Smith
    <email>gsmith@serv.net</email>.  Please send all comments,
    suggestions, and bug 
    reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
    bug tracking database</ulink>. (Instructions for submitting bug
    reports can be found <ulink
    url="http://bugs.gnome.org/Reporting.html" type="http">
    on-line</ulink>. If you are using
    GNOME 1.1 or later, you can also use <application>Bug Report
    Tool</application> (<command>bug-buddy</command>), available in the
    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
    Menu</guimenu>, for submitting bug reports.
   </para>

   <para>
    This manual was written by John Fleck
    (<email>jfleck@inkstain.net</email>). Please send all comments and
    suggestions regarding this manual to the <ulink type="http"
    url="http://www.gnome.org/gdp">GNOME Documentation Project</ulink> 
    by sending an email to <email>docs@gnome.org</email>. You can also
    submit comments online by using the <ulink type="http"
    url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
    Table</ulink>.
   </para>

   <!-- For translations: uncomment this:

   <para>
    Latin translation was done by ME
    (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
    suggestions regarding this translation to SOMEWHERE.
   </para>

   -->

  </sect2>


  <!-- ============= Application License ============================= -->

  <sect2 id="license">
   <title>License</title>
   <para>
    This program is free software; you can redistribute it and/or
    modify it under the terms of the <citetitle>GNU General Public
    License</citetitle> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </para>
   <para>
    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <citetitle>GNU General Public License</citetitle> for more details.
   </para>
   <para>
    A copy of the <citetitle>GNU General Public License</citetitle> is
    included as an appendix to the <citetitle>GNOME Users
    Guide</citetitle>.  You may also obtain a copy of the
    <citetitle>GNU General Public License</citetitle> from the Free
    Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to
    <address>
     Free Software Foundation, Inc.
     <street>59 Temple Place</street> - Suite 330
     <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
     <country>USA</country>
    </address>
   </para>
  </sect2>

 </sect1>















