From d231d9c50dd0be1beb8d1d9293005d49cc90e7f8 Mon Sep 17 00:00:00 2001 From: Stef Walter Date: Tue, 15 Oct 2013 16:10:51 +0200 Subject: daemon: Add gnome-keyring-daemon manual page --- .gitignore | 1 + Makefile.am | 17 ++++- configure.ac | 38 ++++++++-- daemon/gkd-main.c | 2 +- docs/Makefile.am | 27 ++++++- docs/gnome-keyring-daemon.xml | 160 ++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 234 insertions(+), 11 deletions(-) create mode 100644 docs/gnome-keyring-daemon.xml diff --git a/.gitignore b/.gitignore index 0fdf6f1e..14ff1131 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,5 @@ *~ +*.1 *.o *.i *.la diff --git a/Makefile.am b/Makefile.am index b6db0ab6..fec35da5 100644 --- a/Makefile.am +++ b/Makefile.am @@ -15,8 +15,7 @@ SUBDIRS = \ tool \ testing \ $(PAM_DIR) \ - po \ - docs + po ACLOCAL_AMFLAGS = ${ACLOCAL_FLAGS} @@ -28,7 +27,7 @@ EXTRA_DIST = \ HACKING DISTCHECK_CONFIGURE_FLAGS = \ - --enable-gtk-doc \ + --enable-doc \ --disable-strict \ --disable-coverage \ --disable-update-mime \ @@ -75,6 +74,18 @@ clear-coverage: endif +if ENABLE_DOC +SUBDIRS += docs + +distcheck-hook: + @true + +else +distcheck-hook: + @echo "*** doc must be enabled (with --enable-doc) in order to make distcheck" + @false +endif + upload-release: $(DIST_ARCHIVES) scp $(DIST_ARCHIVES) master.gnome.org: ssh master.gnome.org ftpadmin install $(DIST_ARCHIVES) diff --git a/configure.ac b/configure.ac index 9b1cd370..d1b701e6 100644 --- a/configure.ac +++ b/configure.ac @@ -34,8 +34,7 @@ AC_TYPE_SIGNAL AC_TYPE_SIZE_T AC_TYPE_UID_T -GTK_DOC_CHECK(1.9) -DISTCHECK_CONFIGURE_FLAGS="--enable-gtk-doc" +DISTCHECK_CONFIGURE_FLAGS="--enable-doc" AC_SUBST(DISTCHECK_CONFIGURE_FLAGS) PKG_CHECK_MODULES(GLIB, glib-2.0 >= 2.32.0) @@ -446,6 +445,37 @@ if test "$p11_tests_status" = "yes"; then AC_DEFINE_UNQUOTED(WITH_P11_TESTS, 1, [Run p11-tests module testing]) fi +# -------------------------------------------------------------------- +# Documentation options + +AC_MSG_CHECKING([whether to build documentation]) +AC_ARG_ENABLE(doc, + AC_HELP_STRING([--enable-doc], + [Disable building documentation]) + ) + +if test "$enable_doc" = "no"; then + AC_MSG_RESULT($enable_doc) + +else + if test "$enable_doc" = ""; then + disable_msg="(perhaps --disable-doc)" + fi + + enable_doc="yes" + AC_MSG_RESULT($enable_doc) + + AC_PATH_PROG([XSLTPROC], [xsltproc], [no]) + if test "$XSLTPROC" = "no"; then + AC_MSG_ERROR([the xsltproc command was not found $disable_msg]) + fi + + AC_SUBST(XSLTPROC) +fi + +AM_CONDITIONAL([ENABLE_DOC], [test "$enable_doc" = "yes"]) +doc_status=$enable_doc + # -------------------------------------------------------------------- # Compilation and linking options # @@ -483,10 +513,6 @@ if test "$GCC" = "yes"; then -Wcast-align -Wsign-compare \ $CFLAGS" - # Disable -Werror for now, because of issues with - # strange gtk-doc programs not building cleanly. - # -Werror \ - for option in -Wno-strict-aliasing -Wno-sign-compare; do SAVE_CFLAGS="$CFLAGS" CFLAGS="$CFLAGS $option" diff --git a/daemon/gkd-main.c b/daemon/gkd-main.c index 6eb9bb95..2fe38e2e 100644 --- a/daemon/gkd-main.c +++ b/daemon/gkd-main.c @@ -137,7 +137,7 @@ static GOptionEntry option_entries[] = { { "daemonize", 'd', 0, G_OPTION_ARG_NONE, &run_daemonized, "Run as a daemon", NULL }, { "login", 'l', 0, G_OPTION_ARG_NONE, &run_for_login, - "Run for a user login. Read login password from stdin", NULL }, + "Run by PAM for a user login. Read login password from stdin", NULL }, { "components", 'c', 0, G_OPTION_ARG_STRING, &run_components, "The optional components to run", DEFAULT_COMPONENTS }, { "control-directory", 'C', 0, G_OPTION_ARG_FILENAME, &control_directory, diff --git a/docs/Makefile.am b/docs/Makefile.am index 3f519b7f..de1d4c14 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -1,5 +1,30 @@ +man1_MANS = \ + gnome-keyring-daemon.1 + $(NULL) + +MAN_IN_FILES = \ + $(man1_MANS:.1=.xml) + +CLEANFILES = \ + $(man1_MANS) + +XSLTPROC_FLAGS = \ + --nonet \ + --stringparam man.output.quietly 1 \ + --stringparam funcsynopsis.style ansi \ + --stringparam man.th.extra1.suppress 1 \ + --stringparam man.authors.section.enabled 0 \ + --stringparam man.copyright.section.enabled 0 + +XSLTPROC_MAN = \ + $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl + +.xml.1: + $(AM_V_GEN) $(XSLTPROC_MAN) $< + EXTRA_DIST = \ file-format.txt \ keyring-intro.txt \ - gnome-keyring.svg \ No newline at end of file + gnome-keyring.svg \ + $(MAN_IN_FILES) diff --git a/docs/gnome-keyring-daemon.xml b/docs/gnome-keyring-daemon.xml new file mode 100644 index 00000000..da35eb21 --- /dev/null +++ b/docs/gnome-keyring-daemon.xml @@ -0,0 +1,160 @@ + + + + + + + gnome-keyring-daemon + gnome-keyring + + + Maintainer + Stef + Walter + stefw@redhat.com + + + + + + gnome-keyring-daemon + 1 + User Commands + + + + gnome-keyring-daemon + The gnome-keyring daemon + + + + + gnome-keyring + --replace + --unlock + + + + + Description + The gnome-keyring-daemon is a service that stores + your passwords and secrets. It is normally started automatically when + a user logs into a desktop session. + + The gnome-keyring-daemon implements the DBus + Secret Service API, and you can use tools like seahorse + or secret-tool to interact with it. + + The daemon also implements a GnuPG and SSH agent both of which + automatically load the user's keys, and prompt for passwords when necessary. + + The daemon will print out various environment variables which should + be set in the user's environment, in order to interact with the daemon. + + + + Options + + The various startup arguments below can be used: + + + + + + Ask the daemon to only initialize certain components. Valid + components are ssh, gpg, + secrets, pkcs11. + By default all components are initialized. + + + + + + Use this directory for creating communication sockets. By default + a temporary directory is automatically created. + + + + + + Run as a real daemon, disconnected from the terminal. + + + + + + Run in the foreground, and do not fork or become + a daemon. + + + + + + This argument tells the daemon it is being run by PAM. It + reads all of stdin (including any newlines) as a login + password and does not complete actual initialization. + The daemon should later be initialized with a + gnome-keyring-daemon  + invocation. + This option may not be used together with either the + or + arguments. + + + + + + Try to replace a running keyring daemon, and assume its + environment avriables. A successful replacement depends + on the GNOMKE_KEYRING_CONTROL + environment variable being set by an earlier daemon. + This option may not be used together with either the + or + arguments. + + + + + + Connect to an already running daemon and initialize it. + This is often used to complete initialization of a daemon + that was started by PAM using the + argument. + This option may not be used together with either the + or + arguments. + + + + + + Print out the gnome-keyring version and then exit. + + + + + + + + Bugs + + Please send bug reports to either the distribution bug tracker + or the upstream bug tracker at + https://bugzilla.gnome.org/enter_bug.cgi?product=gnome-keyring + + + + + See also + + secret-tool1 + seahorse1 + + + Further details available in the realmd online documentation at + http://standards.freedesktop.org/secret-service/ + + + + -- cgit v1.2.3