<!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="kblackbox">
	<refmeta>
		<refentrytitle>KBLACKBOX</refentrytitle>
		<manvolnum>6</manvolnum>
		<refmiscinfo class="date">September 4th, 2001</refmiscinfo>
		<refmiscinfo class="source">kde-games</refmiscinfo>
		<refmiscinfo class="title">KDE User's Manual</refmiscinfo>
	</refmeta>

	<refnamediv>
		<refname>kblackbox</refname>
		<refpurpose>a KDE logic game inspired by Emacs blackbox</refpurpose>
	</refnamediv>

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

	<refsect1>
		<title>DESCRIPTION</title>
		<para>
			<command>KBlackbox</command> is a graphical logical game, inspired
			by the emacs blackbox. <command>KBlackbox</command> is a game of
			hide and seek played on an grid of boxes. Your opponent (the
			Random number generator, in this case) has hidden several balls
			within this box. By shooting rays into the box and observing where
			they emerge it is possible to deduce the positions of the hidden
			balls. The fewer rays you use to find the balls, the lower your
			score.  
		</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>kblackbox</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>
	</refsect1>
	
	<refsect1>
		<title>FILES</title>
		<variablelist>
			<varlistentry>
				<term><filename>~/.kde/share/config/kblackboxrc</filename></term>
				<listitem>
					<para><command>kblackbox</command> configuration</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsect1>

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

	<refsect1>
		<title>AUTHOR</title>
		<para>
			Robert Cimrman <email>cimrman3@students.zcu.cz</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>
