<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<!--
	Created from the SGML Template for a man page
	For more Information, please see http://mama.sourceforge.net
-->

<refentry id="konqueror">
	<refmeta>
		<refentrytitle>KONQEUROR</refentrytitle>
		<manvolnum>1</manvolnum>
		<refmiscinfo class="date">September 30th, 2001</refmiscinfo>
		<refmiscinfo class="source"></refmiscinfo>
		<refmiscinfo class="title">KDE User's Manual</refmiscinfo>
	</refmeta>

	<refnamediv>
		<refname>konqueror</refname>
		<refpurpose>the KDE file manager and browser</refpurpose>
	</refnamediv>

	<refsynopsisdiv>
		<cmdsynopsis>
			<command>konqueror</command>
				<arg choice="opt" rep="repeat">Qt-option</arg>
				<arg choice="opt" rep="repeat">KDE-option</arg>
				<arg choice="opt" rep="repeat">Konqueror-option</arg>
				<arg choice="opt" rep="repeat">URL</arg>
		</cmdsynopsis>
	</refsynopsisdiv>

	<refsect1>
		<title>DESCRIPTION</title>
		<para>
			<command>Konqueror</command> is the file manager for the K Desktop
			Environment. It supports basic file management on local UNIX
			filesystems, from simple cut/copy and paste operations to advanced
			remote and local network file browsing.
		</para>
		<para>
			<command>Konqueror</command> is the canvas for all the latest KDE
			technology, from KIO slaves (which provide mechanisms for file
			access) to component embedding via the KParts object interface,
			and it's one of the most customizable applications available.
		</para>
		<para>
			<command>Konqueror</command> is an Open Source web browser with
			HTML4.0 compliance, supporting Java applets, JavaScript, CSS1 and
			(partially) CSS2, as well as Netscape plugins (for example, Flash
			or RealVideo plugins).
		</para>
		<para>
			<command>Konqueror</command> is a universal viewing application,
			capable of embedding read-only viewing components in itself to
			view documents without ever launching another application.
		</para>
	</refsect1>
	
	
	<refsect1>
		<title>OPTIONS</title>
		<para>
			This program follows the usual GNU command line syntax,
            with long options starting with two dashes (`--'). A
            summary of the options supported by <command>konqueror</command>
            is included below.
		</para>
		<refsect2>
			<title>Generic Options</title>
			<variablelist>
				<varlistentry>
					<term>--author</term>
					<listitem>
						<para>Show author information</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--help</term>
					<listitem>
						<para>Show help about options</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--help-qt</term>
					<listitem>
						<para>Show Qt specific options</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--help-kde</term>
					<listitem>
						<para>Show KDE specific options</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--help-all</term>
					<listitem>
						<para>Show all options</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--license</term>
					<listitem>
						<para>Show license information</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>-v, --version</term>
					<listitem>
						<para>Show version information and exit.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>Qt Options</title>
			<variablelist>
				<varlistentry>
					<term>--display <replaceable>displayname</replaceable></term>
					<listitem>
						<para>Use the X-server display <emphasis>displayname</emphasis>.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--session <replaceable>sessionId</replaceable>
					<listitem>
						<para>
							Restore the application for the given <emphasis>sessionId</emphasis>.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--cmap</term>
					<listitem>
						<para>
							Causes the application to install a private 
							color map on an 8-bit display.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--ncols <replaceable>count</replaceable></term>
					<listitem>
						<para>
							Limits the number of colors allocated in the 
							color cube on a 8-bit display, if the application
							is using the <emphasis>QApplication::ManyColor</emphasis>
							color specification.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--nograb</term>
					<listitem>
						<para>tells Qt to never grab the mouse or the keyboard.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--dograb</term>
					<listitem>
						<para>
							running under a debugger can cause an implicit
							<command>-nograb</command>, use <command>-dograb</command>
							to override.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sync</term>
					<listitem>
						<para>switches to synchronous mode for debugging.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--fn, --font <replaceable>fontname</replaceable></term>
					<listitem>
						<para>defines the application font.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--bg, --background <replaceable>color</replaceable></term>
					<listitem>
						<para>
							sets the default background color and an
							application palette (light and dark shades 
							are calculated).
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--fg,--foreground <replaceable>color</replaceable></term>
					<listitem>
						<para>sets the default foreground color.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--btn, --button <replaceable>color</replaceable></term>
					<listitem>
						<para>sets the default button color.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--name <replaceable>name</replaceable></term>
					<listitem>
						<para>sets the application name.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--title <replaceable>title</replaceable></term>
					<listitem>
						<para>sets the application title (caption).</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--visual <replaceable>TrueColor</replaceable></term>
					<listitem>
						<para>
							forces the application to use a TrueColor
							visual on an 8-bit display.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--inputstyle</term>
					<listitem>
						<para>
							sets XIM (X Input Method) input style. Possible
							values are onthespot, overthespot, offthespot
							and root.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--im <replaceable>XIM server</replaceable>
					<listitem>
						<para>set XIM server.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--noxim</term>
					<listitem>
						<para>disable XIM.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>KDE Options</title>
			<variablelist>
				<varlistentry>
					<term>--caption <replaceable>caption</replaceable></term>
					<listitem>
						<para>Use <emphasis>caption</emphasis> as name in the titlebar.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--icon <replaceable>icon</replaceable></term>
					<listitem>
						<para>Use <emphasis>icon</emphasis> as the application icon.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--miniicon <replaceable>icon</replaceable>
					<listitem>
						<para>Use <emphasis>icon</emphasis> as the icon in the titlebar.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--dcopserver <replaceable>server</replaceable></term>
					<listitem>
						<para>
							Use the DCOP Server specified by <emphasis>server</emphasis>.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--nocrashhandler</term>
					<listitem>
						<para>Disable crash handler, to get core dumps.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--waitforwm</term>
					<listitem>
						<para>
							Waits for a WM_NET compatible windowmanager.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--style <replaceable>style</replaceable></term>
					<listitem>
						<para>sets the application GUI style.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--geometry <replaceable>geometry</replaceable></term>
					<listitem>
						<para>
							sets the client geometry of the main widget.
						</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>Konqueror Options</title>
			<variablelist>
				<varlistentry>
					<term>--silent</term>
					<listitem>
						<para>Start without a default window.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--profile <replaceable>profile</replaceable></term>
					<listitem>
						<para>Profile to open</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--mimetype <replaceable>mimetype</replaceable>
					<listitem>
						<para>Mimetype to use for this URL, (e.g. <emphasis>text/html</emphasis> or
						<emphasis>inode/directory</emphasis>).</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
	</refsect1>
	
	<refsect1>
		<title>FILES</title>
		<variablelist>
			<varlistentry>
				<term><filename>~/.kde/share/config/konquerorrc</filename></term>
				<listitem>
					<para><command>konqueror</command> configuration</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsect1>


	<refsect1>
		<title>SEE ALSO</title>
		<para>
			<command>konqueror</command> is documented in detail by <emphasis>The
			Konmqueror Handbook</emphasis>
			(<filename>/usr/local/kde/share/doc/HTML/default/konqueror/index.html</filename>).
		</para>
		<para>
			<ulink url="http://www.konqueror.org">Konqueror Homepage</ulink>
		</para>
		<para>
			<ulink url="http://www.kde.org">KDE</ulink>
		</para>
	</refsect1>

	<refsect1>
		<title>AUTHOR</title>
		<para>
			David Faure <email>faure@kde.org</email>,
		    Simon Hausmann <email>hausmann@kde.org</email>,
		    Michael Reiher <email>michael.reiher@gmx.de</email>,
		    Matthias Welk <email>welk@fokus.gmd.de</email>,
		    Alexander Neundorf <email>neundorf@kde.org</email>,
		    Lars Knoll <email>knoll@kde.org</email>,
		    Antti Koivisto <email>koivisto@kde.org</email>,
		    Dirk Mueller <email>mueller@kde.org</email>,
		    Peter Kelly <email>pmk@post.com</email>,
		    Waldo Bastian <email>bastian@kde.org</email>,
		    Matt Koss <email>koss@miesto.sk</email>,
		    Alex Zepeda <email>jazepeda@pacbell.net</email>,
		    Stephan Kulow <email>coolo@kde.org</email>,
		    Richard Moore <email>rich@kde.org</email>,
		    Dima Rogozin <email>dima@mercury.co.il</email>,
		    Harri Porten <email>porten@kde.org</email>,
		    Stefan Schimanski <email>1Stein@gmx.de</email>,
		    George Staikos <email>staikos@kde.org</email>,
		    Dawit Alemayehu <email>adawit@kde.org</email>,
		    Carsten Pfeiffer <email>pfeiffer@kde.org</email>,
		    Torsten Rahn <email>torsten@kde.org</email>,
		    Torben Weis <email>weis@kde.org</email>
		</para>
		<para>
			This man-page was written by Jan Schaumann <email>jschauma@netmeister.org</email>
			as part of "<ulink
			url="http://www.netmeister.org/misc/m2p2/index.html">The Missing Man Pages Project</ulink>".
		</para>
	</refsect1>
</refentry>
