subtree merge of plasmapkg documentation

This commit is contained in:
Marco Martin 2014-03-26 15:17:19 +01:00
commit 606ec7e60c
2 changed files with 109 additions and 0 deletions

2
doc/CMakeLists.txt Normal file
View File

@ -0,0 +1,2 @@
kdoctools_create_manpage(man-plasmapkg.1.docbook 1 INSTALL_DESTINATION ${MAN_INSTALL_DIR})

107
doc/man-plasmapkg.1.docbook Normal file
View File

@ -0,0 +1,107 @@
<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
<!ENTITY % English "INCLUDE">
]>
<refentry lang="&language;">
<refentryinfo>
<title>KDE User's Manual</title>
<date>2012-12-05</date>
<productname>K Desktop Environment</productname>
</refentryinfo>
<refmeta>
<refentrytitle><command>plasmapkg</command></refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
<refname><command>plasmapkg</command></refname>
<refpurpose>Install, list, remove Plasma packages</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>plasmapkg</command>
<group choice="opt"><option>-h, --hash</option> <replaceable> path</replaceable></group>
<group choice="opt"><option>-g, --global</option></group>
<group choice="opt"><option>-t, --type</option> <replaceable> type</replaceable></group>
<group choice="opt"><option>-i, --install</option> <replaceable> path</replaceable></group>
<group choice="opt"><option>-u, --upgrade</option> <replaceable> path</replaceable></group>
<group choice="opt"><option>-l, --list</option></group>
<group choice="opt"><option>--list-types</option></group>
<group choice="opt"><option>-r, --remove</option> <replaceable> name</replaceable></group>
<group choice="opt"><option>-p, --packageroot</option> <replaceable> path</replaceable></group>
<arg choice="opt">KDE Generic Options</arg>
<arg choice="opt">Qt Generic Options</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para><command>plasmapkg</command> is a command line tool to
install, list, remove Plasma packages.</para>
</refsect1>
<refsect1>
<title>Options</title>
<variablelist>
<varlistentry>
<term><option>-h, --hash</option> <replaceable> path</replaceable></term>
<listitem><para>Generate a SHA1 hash for the package at <quote>path</quote>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-g, --global</option></term>
<listitem><para>For install or remove, operates on packages installed for all users.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-t, --type</option> <replaceable> type</replaceable></term>
<listitem><para>The type of package, &eg; theme, wallpaper, plasmoid, dataengine, runner, layout-template, &etc; [plasmoid].</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-i, --install</option> <replaceable> path</replaceable></term>
<listitem><para>Install the package at <quote>path</quote>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-u, --upgrade</option> <replaceable> path</replaceable></term>
<listitem><para>Upgrade the package at <quote>path</quote>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-l, --list</option></term>
<listitem><para>List installed packages.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-r, --remove</option> <replaceable> name</replaceable></term>
<listitem><para>Remove the package named <quote>name</quote>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-p, --packageroot</option> <replaceable> path</replaceable></term>
<listitem><para>Absolute path to the package root. If not supplied, then the standard data
directories for this &kde; session will be searched instead.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<para>More detailed user documentation is available from <ulink
url="help:/plasma-desktop">help:/plasma-desktop</ulink>
(either enter this <acronym>URL</acronym> into &konqueror;, or run
<userinput><command>khelpcenter</command>
<parameter>help:/plasma-desktop</parameter></userinput>).</para>
</refsect1>
<refsect1>
<title>Authors</title>
<para><command>plasmapkg</command> was written by
<personname><firstname>Aaron</firstname><surname>Seigo</surname></personname> <email>aseigo@kde.org</email>.</para>
</refsect1>
</refentry>