[kde-doc-english] [ksshaskpass] doc: create docbook manpage from man+troff by doclifter

[Burkhard Lück]

Git commit 06e4c2461e3738684eae9049a0f61596e4560691 by Burkhard Lück.
Committed on 07/11/2014 at 13:31.
Pushed by lueck into branch 'master'.

create docbook manpage from man+troff by doclifter
REVIEW:120998

A  +1    -0    doc/CMakeLists.txt
D  +0    -29   doc/ksshaskpass.1
A  +51   -0    doc/man-ksshaskpass.1.docbook

http://commits.kde.org/ksshaskpass/06e4c2461e3738684eae9049a0f61596e4560691

diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
new file mode 100644
index 0000000..838cd65
--- /dev/null
+++ b/doc/CMakeLists.txt
@@ -0,0 +1 @@
+kdoctools_create_manpage(man-ksshaskpass.1.docbook 1 INSTALL_DESTINATION ${MAN_INSTALL_DIR})
diff --git a/doc/ksshaskpass.1 b/doc/ksshaskpass.1
deleted file mode 100644
index 4eece41..0000000
--- a/doc/ksshaskpass.1
+++ /dev/null
@@ -1,29 +0,0 @@
-.TH KSSHASKPASS 1
-.SH NAME
-ksshaskpass \- prompts a user for a passphrase using KDE
-.SH SYNOPSIS
-.B kdesshaskpass
-.SH DESCRIPTION
-.B kshaskpass
-is a KDE-based passphrase dialog for use with OpenSSH.
-It is intended to be called by the
-.BR ssh\-add (1)
-program and not invoked directly.
-It allows
-.BR ssh\-add (1)
-to obtain a passphrase from a user, even if not connected to a terminal
-(assuming that an X display is available).
-This happens automatically in the case where
-.B ssh\-add
-is invoked from one's
-.B ~/.xsession
-or as one of the KDE startup programs, for example.
-.PP
-In order to be called automatically by
-.BR ssh\-add ,
-.B ksshaskpass
-should be installed as
-.IR /usr/bin/ssh\-askpass .
-.SH AUTHOR
-This manual page was written by Armin Berres <trigger at space-based.de>.
-It was based on that for gnome\-ssh\-askpass by Colin Watson <cjwatson at debian.org>.
diff --git a/doc/man-ksshaskpass.1.docbook b/doc/man-ksshaskpass.1.docbook
new file mode 100644
index 0000000..78f3326
--- /dev/null
+++ b/doc/man-ksshaskpass.1.docbook
@@ -0,0 +1,51 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
+<!ENTITY % English "INCLUDE">
+]>
+
+<!-- lifted from man+troff by doclifter -->
+<refentry lang="&language;">
+<refmeta>
+<refentrytitle>KSSHASKPASS</refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+<refnamediv>
+<refname>ksshaskpass</refname>
+<refpurpose>prompts a user for a passphrase using KDE</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>ksshaskpass</command>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para><emphasis>kshaskpass</emphasis>
+is a KDE-based passphrase dialog for use with OpenSSH.
+It is intended to be called by the
+<citerefentry><refentrytitle>ssh-add</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+program and not invoked directly.
+It allows
+<citerefentry><refentrytitle>ssh-add</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+to obtain a passphrase from a user, even if not connected to a terminal
+(assuming that an X display is available).
+This happens automatically in the case where
+<emphasis>ssh-add</emphasis>
+is invoked from one's
+<filename>~/.xsession</filename>
+or as one of the KDE startup programs, for example.</para>
+
+<para>In order to be called automatically by
+<emphasis>ssh-add</emphasis>,
+<emphasis>ksshaskpass</emphasis>
+should be installed as
+<filename>/usr/bin/ssh-askpass</filename>.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>This manual page was written by Armin Berres <trigger at space-based.de>.
+It was based on that for gnome-ssh-askpass by Colin Watson <cjwatson at debian.org>.</para>
+</refsect1>
+</refentry>