bee-query.xml

<?xml version='1.0'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<!--
    manpage of bee-query

    Copyright (C) 2013-2016
          Lena Kristin Zander <zander@molgen.mpg.de>

    This file is part of bee.

    bee is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    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
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
-->

<refentry id="bee-query">
        <refentryinfo>
                <title>bee - bau et einfach</title>
                <productname>bee @BEE_VERSION@</productname>

                <authorgroup>
                    <author>
                        <contrib></contrib> <!-- prevent warning -->
                        <firstname>Marius</firstname>
                        <surname>Tolzmann</surname>
                        <email>m@rius.berlin</email>
                    </author>

                    <author>
                        <contrib></contrib>
                        <firstname>Tobias</firstname>
                        <surname>Dreyer</surname>
                        <email>dreyer@molgen.mpg.de</email>
                    </author>

                    <author>
                        <contrib></contrib>
                        <firstname>and other bee developers</firstname>
                    </author>
                </authorgroup>
        </refentryinfo>

        <refmeta>
                <refentrytitle>bee-query</refentrytitle>
                <manvolnum>1</manvolnum>
        </refmeta>

        <refnamediv>
                <refname>bee-query</refname>
                <refpurpose>Ask the bee database for files and packages</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <cmdsynopsis>
                        <command>bee query</command>
                        <arg choice="opt">options</arg>
                        <arg choice="plain"><replaceable>&lt;pattern&gt;</replaceable></arg>
                </cmdsynopsis>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para>
                Use <command>bee-query</command> to ask the bee database for
                <replaceable>&lt;pattern&gt;</replaceable>. If
                <replaceable>&lt;pattern&gt;</replaceable> matches the full name of an
                installed package, all related files, otherwise all matching files and the
                related packages will be displayed.
                </para>
        </refsect1>

        <refsect1>
                <title>Options</title>

                <variablelist>
                        <varlistentry>
                                <term><option>-h</option></term>
                                <term><option>--help</option></term>

                                <listitem><para>Print a usage message.</para></listitem>
                        </varlistentry>
                </variablelist>
        </refsect1>

        <refsect1>
                <title>Environment</title>

                <variablelist>
                    <varlistentry>
                        <term><option>BEE_METADIR</option></term>
                        <listitem><para>Directory searched for installed bee packages</para></listitem>
                    </varlistentry>
                </variablelist>
        </refsect1>

        <refsect1>
                <title>Bugs</title>
                <para>
                Please report bugs to bee-dev@googlegroups.com or directly to the authors.
                </para>
        </refsect1>

        <refsect1>
                <title>See Also</title>
                <para>
                        <citerefentry><refentrytitle>bee</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-check</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-download</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-init</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-install</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-list</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-remove</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>bee-update</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                </para>
        </refsect1>
</refentry>