[krb5-auth-dialog] add a user manual
- From: Guido Günther <guidog src gnome org>
- To: svn-commits-list gnome org
- Subject: [krb5-auth-dialog] add a user manual
- Date: Tue, 2 Jun 2009 17:03:33 -0400 (EDT)
commit 7f7a21cfe43e1010f0857a042f42a07d3e5af025
Author: Guido Günther <agx sigxcpu org>
Date: Fri May 22 15:29:07 2009 +0200
add a user manual
---
.gitignore | 1 +
ChangeLog | 20 ++
Makefile.am | 12 +-
acinclude.m4 | 2 +
configure.ac | 2 +
help/.gitignore | 1 +
help/C/figures/ka-expired.png | Bin 0 -> 12075 bytes
help/C/figures/ka-expiring.png | Bin 0 -> 12659 bytes
help/C/figures/ka-valid.png | Bin 0 -> 12226 bytes
help/C/figures/trayicon-expired.png | Bin 0 -> 1258 bytes
help/C/figures/trayicon-expiring.png | Bin 0 -> 1344 bytes
help/C/figures/trayicon-valid.png | Bin 0 -> 1163 bytes
help/C/krb5-auth-dialog.xml | 370 ++++++++++++++++++++++++++++++++++
help/C/legal.xml | 76 +++++++
help/Makefile.am | 19 ++
help/krb5-auth-dialog.omf.in | 37 ++++
m4/gnome-doc-utils.m4 | 53 +++++
17 files changed, 591 insertions(+), 2 deletions(-)
diff --git a/.gitignore b/.gitignore
index 22c4c4f..a54f91e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,3 +30,4 @@ ylwrap
intltool-extract.in
intltool-merge.in
intltool-update.in
+gnome-doc-utils.make
diff --git a/ChangeLog b/ChangeLog
index 4a33edd..c614c67 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,23 @@
+Mon Jun 1 19:56:35 CEST 2009 Guido Günther <agx sigxcpu org>
+
+ add user manual
+ * configure.ac: call GNOME_DOC_INIT
+ * Makefile.am: process help/
+ * acinclude.m4: include m4/gnome-doc-utils.m4
+ * .gitignore: ignore gnome-doc-utils.make
+ * help/C/figures/ka-expired.png: new file
+ * help/C/figures/ka-expiring.png: likewise
+ * help/C/figures/ka-valid.png: likewise
+ * help/C/figures/trayicon-expired.png: likewise
+ * help/C/figures/trayicon-expiring.png: likewise
+ * help/C/figures/trayicon-valid.png: likewise
+ * help/C/krb5-auth-dialog.xml: likewise
+ * help/C/legal.xml: likewise
+ * help/Makefile.am: likewise
+ * help/krb5-auth-dialog.omf.in: likewise
+ * m4/gnome-doc-utils.m4: likewise
+ * help/.gitignore: likewise
+
Mon May 25 19:11:58 CEST 2009 Guido Günther <agx sigxcpu org>
* src/krb5-auth-applet.c: update about dialog
diff --git a/Makefile.am b/Makefile.am
index fde6c4d..b68bd09 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,10 +1,18 @@
NULL =
-SUBDIRS = secmem gtksecentry src po etpo icons preferences
+SUBDIRS = secmem gtksecentry src po etpo icons preferences help
EXTRA_DIST = \
krb5-auth-dialog.spec \
MAINTAINERS \
+ gnome-doc-utils.make \
$(NULL)
-DISTCLEANFILES = intltool-extract intltool-merge intltool-update
+DISTCLEANFILES = \
+ intltool-extract \
+ intltool-merge \
+ intltool-update \
+ gnome-doc-utils.make \
+ $(NULL)
+
+DISTCHECK_CONFIGURE_FLAGS = --disable-scrollkeeper
diff --git a/acinclude.m4 b/acinclude.m4
index e775c28..3c814fb 100644
--- a/acinclude.m4
+++ b/acinclude.m4
@@ -203,3 +203,5 @@ AC_DEFUN([KA_COMPILE_WARNINGS],[
])
m4_include([m4/compiler-flags.m4])
+m4_include([m4/gnome-doc-utils.m4])
+
diff --git a/configure.ac b/configure.ac
index c01e158..63c40d7 100644
--- a/configure.ac
+++ b/configure.ac
@@ -24,6 +24,7 @@ AC_PROG_YACC
AM_PROG_CC_C_O
KA_COMPILE_WARNINGS([maximum])
+GNOME_DOC_INIT
GTK_REQUIRED="2.16.0"
DBUS_REQUIRED="0.60"
@@ -218,6 +219,7 @@ icons/Makefile
etpo/Makefile
po/Makefile.in
preferences/Makefile
+help/Makefile
])
AC_MSG_NOTICE([])
diff --git a/help/.gitignore b/help/.gitignore
new file mode 100644
index 0000000..4a66d07
--- /dev/null
+++ b/help/.gitignore
@@ -0,0 +1 @@
+krb5-auth-dialog-C.omf
diff --git a/help/C/figures/ka-expired.png b/help/C/figures/ka-expired.png
new file mode 100644
index 0000000..67e8172
Binary files /dev/null and b/help/C/figures/ka-expired.png differ
diff --git a/help/C/figures/ka-expiring.png b/help/C/figures/ka-expiring.png
new file mode 100644
index 0000000..df5faab
Binary files /dev/null and b/help/C/figures/ka-expiring.png differ
diff --git a/help/C/figures/ka-valid.png b/help/C/figures/ka-valid.png
new file mode 100644
index 0000000..3508e59
Binary files /dev/null and b/help/C/figures/ka-valid.png differ
diff --git a/help/C/figures/trayicon-expired.png b/help/C/figures/trayicon-expired.png
new file mode 100644
index 0000000..c6d387f
Binary files /dev/null and b/help/C/figures/trayicon-expired.png differ
diff --git a/help/C/figures/trayicon-expiring.png b/help/C/figures/trayicon-expiring.png
new file mode 100644
index 0000000..173178c
Binary files /dev/null and b/help/C/figures/trayicon-expiring.png differ
diff --git a/help/C/figures/trayicon-valid.png b/help/C/figures/trayicon-valid.png
new file mode 100644
index 0000000..2fed554
Binary files /dev/null and b/help/C/figures/trayicon-valid.png differ
diff --git a/help/C/krb5-auth-dialog.xml b/help/C/krb5-auth-dialog.xml
new file mode 100644
index 0000000..c200cc6
--- /dev/null
+++ b/help/C/krb5-auth-dialog.xml
@@ -0,0 +1,370 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; [
+ <!ENTITY legal SYSTEM "legal.xml">
+ <!ENTITY GFDL SYSTEM "fdl-appendix.xml">
+ <!ENTITY appversion "0.10">
+ <!ENTITY manrevision "0.1">
+ <!ENTITY date "May 2009">
+ <!ENTITY app "Kerberos Network Authentication Dialog">
+ <!ENTITY application "<application>&app;</application>">
+]>
+<!--
+ (Do not remove this comment block.)
+ Template Maintained by the GNOME Documentation Project:
+ http://developer.gnome.org/projects/gdp
+ Template version: 2.0 beta
+ Template last modified Feb 12, 2002
+-->
+
+
+<!--
+ (Do not remove this comment block.)
+ Version: 0.0.1
+ Last modified: May 22, 2009
+ Maintainers:
+ Guido Günther <agx sigxcpu org>
+ Translators:
+ (translators put your name and email here)
+-->
+
+
+
+<!-- =============Document Header ============================= -->
+<article id="index" lang="en">
+ <!-- please do not change the id; for translations, change lang to -->
+ <!-- appropriate code -->
+
+ <articleinfo>
+ <title>&application; Manual</title>
+ <abstract role="description">
+ <para>
+ &app; is a small helper that monitors and refreshes your Kerberos ticket.
+ </para>
+ </abstract>
+ <copyright>
+ <year>2009</year>
+ <holder>Guido Günther</holder>
+ </copyright>
+
+ <!-- translators: uncomment this:
+
+ <copyright>
+ <year>2000</year>
+ <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+ </copyright>
+
+ -->
+ <!-- An address can be added to the publisher information. If a role is
+ not specified, the publisher/author is the same for all versions of the
+ document. -->
+ <publisher role="maintainer">
+ <publishername>Guido Günther</publishername>
+ </publisher>
+
+ &legal;
+
+ <authorgroup>
+ <author>
+ <firstname>Jonathan</firstname>
+ <surname>Blandford</surname>
+ <email>rjb redhat com</email>
+ </author>
+ <author role="maintainer">
+ <firstname>Guido</firstname>
+ <surname>Günther</surname>
+ <email>agx sigxcpu org</email>
+ </author>
+ <!-- This is appropriate place for other contributors: translators,
+ maintainers, etc. Commented out by default.
+ <othercredit role="translator">
+ <firstname>Latin</firstname>
+ <surname>Translator 1</surname>
+ <affiliation>
+ <orgname>Latin Translation Team</orgname>
+ <address> <email>translator gnome org</email> </address>
+ </affiliation>
+ <contrib>Latin translation</contrib>
+ </othercredit>
+ -->
+ </authorgroup>
+
+ <!-- The revision numbering system for GNOME manuals is as follows: -->
+ <!-- * the revision number consists of two components -->
+ <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
+ <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
+ <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
+ <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
+ <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
+ <!-- to V3.0, and so on. -->
+
+ <revhistory>
+ <revision>
+ <revnumber>2.0</revnumber>
+ <date>&date;</date>
+ <revdescription>
+ <para role="author">Guido Günther
+ <email>agx sigxcpu org</email>
+ </para>
+ </revdescription>
+ </revision>
+ </revhistory>
+ <releaseinfo>This manual describes how to use the Kerberos Network Authentication Dialog
+ to manage your Kerberos tickets.
+ </releaseinfo>
+ <legalnotice>
+ <title>Feedback</title>
+ <para>To report a bug or make a suggestion regarding this package or
+ this manual, use
+ <ulink url="http://bugzilla.gnome.org";
+ type="http">GNOME's Bugzilla</ulink>.
+ </para>
+ <!-- Translators may also add here feedback address for translations -->
+ </legalnotice>
+ </articleinfo>
+
+ <!-- ============= Document Body ============================= -->
+ <!-- ============= Introduction ============================== -->
+ <section id="intro">
+ <title>Introduction</title>
+ <indexterm>
+ <primary>&application;</primary>
+ <secondary>Manual</secondary>
+ <tertiary>krb5-auth-dialog</tertiary>
+ </indexterm>
+
+ <para>
+ &app; is an applet for the <systemitem>GNOME desktop</systemitem> that monitors
+ and refreshes your Kerberos ticket. It pops up reminders when the ticket
+ is about to expire.
+ </para>
+ <para>
+ Once you have acquired a Kerberos ticket - be it via GDM or via the applet itself - the applet will handle the ticket's renewal until it expires. It can also be used to destroy (remove) the credential cache, to acquire a ticket with different options or to switch to another principal.</para>
+ </section>
+
+<section id="using">
+ <title>Usage</title>
+ <para>
+ <application>&app;</application> is usually started in GNOME startup, but
+ you can manually start <application>&app;</application> by doing:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Command line</term>
+ <listitem>
+ <para>
+ Type <command>krb5-auth-dialog --always</command>,
+ then press <keycap>Return</keycap>:
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ The tray icon will indicate one of tree states:
+ </para>
+
+ <section id="trayicon-valid">
+ <title>Valid Kerberos ticket</title>
+ <para>You have a valid Kerberos ticket that can be used to authenticate to network services.</para>
+ <figure>
+ <title>Valid Kerberos ticket</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/trayicon-valid.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </section>
+
+ <section id="trayicon-expiring">
+ <title>Kerberos ticket expiring</title>
+ <para>The Kerberos ticket is about to expire but it can still be used to authenticate to network services.</para>
+ <figure>
+ <title>Kerberos ticket expiring</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/trayicon-expiring.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </section>
+ <section id="trayicon-expired">
+ <title>Kerberos ticket expired</title>
+ <para>Your Kerberos became invalid (e.g. expired). It can no longer be used to authenticate to network services. This is not a problem if the application that requires Kerberos knows how to request a new ticket via &application;. In case it doesn't you can just left click on the applet an reenter your password.
+</para>
+ <figure>
+ <title>Kerberos ticket expired</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/trayicon-expired.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </section>
+</section>
+
+<section id="notify">
+ <title>Notification Messages</title>
+ <para>
+ When &app; has started, the following notifications may be displayed.
+ </para>
+
+ <section id="notify-valid">
+ <title>Kerberos credentials valid</title>
+ <para>You just acquired a valid Kerberos ticket that can be used to authenticate to network services.</para>
+ <figure>
+ <title>Notification when Kerberos credentials become valid</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/ka-valid.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </section>
+
+ <section id="notify-expiring">
+ <title>Kerberos credentials expiring</title>
+ <para>Your Kerberos credentials are about to expire. You can left click on the tray applet to refresh them.</para>
+ <figure>
+ <title>Notification when Kerberos credentials expiring</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/ka-expiring.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </section>
+
+ <section id="notify-expired">
+ <title>Kerberos credentials expired</title>
+ <para>Your Kerberos credentials just expired. They can no longer be used to authenticate to network services.</para>
+ <figure>
+ <title>Notification when Kerberos credentials expired</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/ka-expired.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </section>
+</section>
+
+<section id="preferences">
+ <title>Preferences</title>
+ <para>
+ You can set preferences by selecting "Preferences" from the applets context menu or by selecting "Network Authentication" in the <application>Control Center</application>.
+ <table frame="topbot" id="tbl-principal-prefs">
+ <title>Kerberos Principal Preferences</title>
+ <tgroup cols="2" colsep="1" rowsep="1"> <colspec colwidth="19.21*"/> <colspec colwidth="46.79*"/>
+ <thead>
+ <row>
+ <entry colsep="0" rowsep="1">
+ <para>Dialog Element</para>
+ </entry>
+ <entry colsep="0" rowsep="1">
+ <para>Description</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>Kerberos Principal</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>The Kerberos principal to use. Leave blanc to use you current username. If you change this setting you have to destroy the credential cache before these setting takes effect.</para>
+ </entry>
+ </row>
+
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>PKINIT Userid</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>The principals public/private/certificate identifier. Leave empty if not using PKINIT. To enable using a security token add the path to the pkcs11 Library here, e.g. "PKCS11:/usr/lib/opensc/opensc-pkcs11.so"</para>
+ </entry>
+ </row>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>PKINIT anchors</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>Path to CA certificates used as trust anchors for pkinit. You only need to set this if it hasn't been set up globally in <filename>/etc/krb5.conf</filename></para>
+ </entry>
+ </row>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>forwardable</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>Whether the requested Kerberos ticket should be forwardable. Changing this setting requires to you to reauthenticate by left clicking on the tray icon and entering your password.</para>
+ </entry>
+ </row>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>renewable</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>Whether the requested Kerberos ticket should be renewable. Changing this setting requires to you to reauthenticate by left clicking on the tray icon and entering your password.</para>
+ </entry>
+ </row>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>proxiable</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>Whether the requested Kerberos ticket should be proxiable. Changing this setting requires to you to reauthenticate by left clicking on the tray icon and entering your password.</para>
+ </entry>
+ </row>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>Warn .. minutes before expiry</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>Notifications that your credentials are about to expire will be sent that many minutes before expiry.</para>
+ </entry>
+ </row>
+ <row>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>
+ <guilabel>Show tray icon</guilabel>
+ </para>
+ </entry>
+ <entry colsep="0" rowsep="0" valign="top">
+ <para>Whether to show the tray icon. Disabling the tray icon will also disable notifications, the password dialog will be brought up instead.</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+</section>
+
+</article>
+
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..ac97e1d
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,76 @@
+ <legalnotice id="legalnotice">
+ <para>
+ Permission is granted to copy, distribute and/or modify this
+ document under the terms of the GNU Free Documentation
+ License (GFDL), Version 1.1 or any later version published
+ by the Free Software Foundation with no Invariant Sections,
+ no Front-Cover Texts, and no Back-Cover Texts. You can find
+ a copy of the GFDL at this <ulink type="help"
+ url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+ distributed with this manual.
+ </para>
+ <para> This manual is part of a collection of GNOME manuals
+ distributed under the GFDL. If you want to distribute this
+ manual separately from the collection, you can do so by
+ adding a copy of the license to the manual, as described in
+ section 6 of the license.
+ </para>
+
+ <para>
+ Many of the names used by companies to distinguish their
+ products and services are claimed as trademarks. Where those
+ names appear in any GNOME documentation, and the members of
+ the GNOME Documentation Project are made aware of those
+ trademarks, then the names are in capital letters or initial
+ capital letters.
+ </para>
+
+ <para>
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+ UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+ WITH THE FURTHER UNDERSTANDING THAT:
+
+ <orderedlist>
+ <listitem>
+ <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+ IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+ THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+ DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+ A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+ RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+ OF THE DOCUMENT OR MODIFIED VERSION OF THE
+ DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+ MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+ YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+ CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+ SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+ OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+ LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+ VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+ EXCEPT UNDER THIS DISCLAIMER; AND
+ </para>
+ </listitem>
+ <listitem>
+ <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+ THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+ CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+ INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+ DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+ OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+ PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+ DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+ CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+ INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+ OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+ MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+ LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+ EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+ THE POSSIBILITY OF SUCH DAMAGES.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </legalnotice>
+
diff --git a/help/Makefile.am b/help/Makefile.am
new file mode 100644
index 0000000..c97147a
--- /dev/null
+++ b/help/Makefile.am
@@ -0,0 +1,19 @@
+NULL=
+
+include $(top_srcdir)/gnome-doc-utils.make
+dist-hook: doc-dist-hook
+
+DOC_MODULE = krb5-auth-dialog
+DOC_ENTITIES = legal.xml
+DOC_INCLUDES =
+DOC_FIGURES = \
+ figures/ka-valid.png \
+ figures/ka-expired.png \
+ figures/ka-expiring.png \
+ figures/trayicon-valid.png \
+ figures/trayicon-expired.png \
+ figures/trayicon-expiring.png \
+ $(NULL)
+
+DOC_LINGUAS = \
+ $(NULL)
diff --git a/help/krb5-auth-dialog.omf.in b/help/krb5-auth-dialog.omf.in
new file mode 100644
index 0000000..387692e
--- /dev/null
+++ b/help/krb5-auth-dialog.omf.in
@@ -0,0 +1,37 @@
+<?xml version="1.0" standalone="no"?>
+<omf>
+ <resource>
+ <title>Network Authentication</title>
+ <date>2009-05-27</date>
+ <versionGroup>
+ <version>
+ <id>0.0.01</id>
+ <date>20070527</date>
+ <description>0.0.1</description>
+ </version>
+ </versionGroup>
+ <creator>
+ <person>
+ <firstName>Jonathan</firstName>
+ <lastName>Blandford</lastName>
+ <email>jrb redhat com</email>
+ </person>
+ </creator>
+ <maintainer>
+ <person>
+ <firstName>Guido</firstName>
+ <lastName>Günther</lastName>
+ <email>agx sigxcpu org</email>
+ </person>
+ </maintainer>
+ <subject category="GNOME|Applets|Network"/>
+ <date>2009-05-27</date>
+ <type>user's guide</type>
+ <description>
+ User manual for the Kerberos Network Authentication Dialog
+ </description>
+ <relation seriesid="62118a88-a670-11d9-9d16-8c554140c753"/>
+ <language code="C"/>
+ <rights type="GNU FDL" license.version="1.1" holder="Guido Günther"/>
+ </resource>
+</omf>
diff --git a/m4/gnome-doc-utils.m4 b/m4/gnome-doc-utils.m4
new file mode 100644
index 0000000..4aef712
--- /dev/null
+++ b/m4/gnome-doc-utils.m4
@@ -0,0 +1,53 @@
+dnl Do not call GNOME_DOC_DEFINES directly. It is split out from
+dnl GNOME_DOC_INIT to allow gnome-doc-utils to bootstrap off itself.
+AC_DEFUN([GNOME_DOC_DEFINES],
+[
+AC_ARG_WITH([help-dir],
+ AC_HELP_STRING([--with-help-dir=DIR], [path to help docs]),,
+ [with_help_dir='${datadir}/gnome/help'])
+HELP_DIR="$with_help_dir"
+AC_SUBST(HELP_DIR)
+
+AC_ARG_WITH([omf-dir],
+ AC_HELP_STRING([--with-omf-dir=DIR], [path to OMF files]),,
+ [with_omf_dir='${datadir}/omf'])
+OMF_DIR="$with_omf_dir"
+AC_SUBST(OMF_DIR)
+
+AC_ARG_WITH([help-formats],
+ AC_HELP_STRING([--with-help-formats=FORMATS], [list of formats]),,
+ [with_help_formats=''])
+DOC_USER_FORMATS="$with_help_formats"
+AC_SUBST(DOC_USER_FORMATS)
+
+AC_ARG_ENABLE([scrollkeeper],
+ [AC_HELP_STRING([--disable-scrollkeeper],
+ [do not make updates to the scrollkeeper database])],,
+ enable_scrollkeeper=yes)
+AM_CONDITIONAL([ENABLE_SK],[test "$gdu_cv_have_gdu" = "yes" -a "$enable_scrollkeeper" = "yes"])
+
+dnl disable scrollkeeper automatically for distcheck
+DISTCHECK_CONFIGURE_FLAGS="--disable-scrollkeeper $DISTCHECK_CONFIGURE_FLAGS"
+AC_SUBST(DISTCHECK_CONFIGURE_FLAGS)
+
+AM_CONDITIONAL([HAVE_GNOME_DOC_UTILS],[test "$gdu_cv_have_gdu" = "yes"])
+])
+
+# GNOME_DOC_INIT ([MINIMUM-VERSION],[ACTION-IF-FOUND],[ACTION-IF-NOT-FOUND])
+#
+AC_DEFUN([GNOME_DOC_INIT],
+[AC_REQUIRE([AC_PROG_LN_S])dnl
+
+ifelse([$1],,[gdu_cv_version_required=0.3.2],[gdu_cv_version_required=$1])
+
+PKG_CHECK_EXISTS([gnome-doc-utils >= $gdu_cv_version_required],
+ [gdu_cv_have_gdu=yes],[gdu_cv_have_gdu=no])
+
+if test "$gdu_cv_have_gdu" = "yes"; then
+ ifelse([$2],,[:],[$2])
+else
+ ifelse([$3],,[AC_MSG_ERROR([gnome-doc-utils >= $gdu_cv_version_required not found])],[$3])
+fi
+
+GNOME_DOC_DEFINES
+])
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
