[glade/f19] Add man pages

Matthias Clasen mclasen at fedoraproject.org
Wed Jun 26 18:28:57 UTC 2013


commit fd3bdd6ffda2b35cbad2a7df7aa4d5c9d636aef9
Author: Matthias Clasen <mclasen at redhat.com>
Date:   Wed Jun 26 14:28:39 2013 -0400

    Add man pages

 0001-Add-man-pages.patch |  294 ++++++++++++++++++++++++++++++++++++++++++++++
 glade.spec               |   15 ++-
 2 files changed, 308 insertions(+), 1 deletions(-)
---
diff --git a/0001-Add-man-pages.patch b/0001-Add-man-pages.patch
new file mode 100644
index 0000000..fc80f30
--- /dev/null
+++ b/0001-Add-man-pages.patch
@@ -0,0 +1,294 @@
+diff -up glade-3.15.0/configure.ac.man-pages glade-3.15.0/configure.ac
+--- glade-3.15.0/configure.ac.man-pages	2013-03-06 15:58:47.000000000 -0500
++++ glade-3.15.0/configure.ac	2013-06-26 14:23:46.390060044 -0400
+@@ -195,6 +195,22 @@ AM_CONDITIONAL(BUILD_PYTHON, test x"$hav
+ 
+ YELP_HELP_INIT
+ 
++# ==================================================================
++# Man pages (requires xsltproc)
++# ==================================================================
++
++AC_ARG_ENABLE(man-pages,
++              AC_HELP_STRING([--enable-man-pages],
++                             [build manual pages]),,
++              enable_man_pages=yes)
++if test x$enable_man_pages = xyes; then
++   AC_PATH_PROG([XSLTPROC], [xsltproc])
++   if test x$XSLTPROC = x; then
++      AC_MSG_ERROR([xsltproc is required to build manual pages])
++   fi
++fi
++AM_CONDITIONAL(BUILD_MAN_PAGES, test x$enable_man_pages = xyes)
++
+ dnl ================================================================
+ dnl Check for windows
+ dnl ================================================================
+@@ -298,6 +314,7 @@ po/Makefile.in
+ doc/Makefile
+ doc/version.xml
+ help/Makefile
++man/Makefile
+ build/mingw-w64/glade.nsi
+ ])
+ 
+@@ -314,4 +331,5 @@ Configuration:
+ 	Introspection Data:      ${found_introspection}
+ 
+ 	Build Reference Manual:  ${enable_gtk_doc}
++	Build Manual Pages:      ${enable_man_pages}
+ "
+diff -up glade-3.15.0/Makefile.am.man-pages glade-3.15.0/Makefile.am
+diff -up glade-3.15.0/man/glade-previewer.xml.man-pages glade-3.15.0/man/glade-previewer.xml
+--- glade-3.15.0/man/glade-previewer.xml.man-pages	2013-06-26 14:22:25.196562427 -0400
++++ glade-3.15.0/man/glade-previewer.xml	2013-06-26 14:22:25.196562427 -0400
+@@ -0,0 +1,105 @@
++<?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">
++
++<refentry id="glade-previewer">
++
++        <refentryinfo>
++                <title>glade-previewer</title>
++                <productname>GNOME</productname>
++
++                <authorgroup>
++                        <author>
++                                <contrib>Maintainer</contrib>
++                                <firstname>Tristan Van Berkom</firstname>
++                                <surname>Van Berkom</surname>
++                                <email>tristan.van.berkom at gmail.com</email>
++                        </author>
++                        <author>
++                                <contrib>Maintainer</contrib>
++                                <firstname>Juan Pablo</firstname>
++                                <surname>Ugarte</surname>
++                                <email>juanpablougarte at gmail.com</email>
++                        </author>
++                </authorgroup>
++
++        </refentryinfo>
++
++        <refmeta>
++                <refentrytitle>glade-previewer</refentrytitle>
++                <manvolnum>1</manvolnum>
++                <refmiscinfo class="manual">User Commands</refmiscinfo>
++        </refmeta>
++
++        <refnamediv>
++                <refname>glade-previewer</refname>
++                <refpurpose>Preview glade user interface definitions</refpurpose>
++        </refnamediv>
++
++        <refsynopsisdiv>
++                <cmdsynopsis>
++                        <command>glade-previewer <arg choice="opt" rep="repeat">OPTION</arg></command>
++                </cmdsynopsis>
++        </refsynopsisdiv>
++
++        <refsect1>
++                <title>Description</title>
++
++                <para><command>glade-previewer</command> is a tool that
++                can load and display a User Interface that has been defined
++                with glade. glade itself uses glade-previewer, but it
++                can also be used as a standalone utility.</para>
++        </refsect1>
++
++        <refsect1>
++                <title>Options</title>
++
++                <para>The following options can be specified:</para>
++
++                <variablelist>
++                        <varlistentry>
++                                <term><option>-f FILENAME</option>, <option>--filename=FILENAME</option></term>
++
++                                <listitem><para>Name of the file to preview.</para></listitem>
++
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>-t TOPLEVEL</option>, <option>--toplevel=TOPLEVEL</option></term>
++
++                                <listitem><para>Name of the toplevel to preview.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>-l</option>, <option>--listen</option></term>
++
++                                <listitem><para>Listen on standard input.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>-v</option>, <option>--version</option></term>
++
++                                <listitem><para>Output version information and exit.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--display=DISPLAY</option></term>
++
++                                <listitem><para>X display to use.</para></listitem>
++                        </varlistentry>
++
++                </variablelist>
++
++                <para>One of the <option>--filename</option> or
++                <option>--listen</option> options has to be specified.</para>
++
++        </refsect1>
++
++        <refsect1>
++                <title>See Also</title>
++                <para>
++                        <citerefentry><refentrytitle>glade</refentrytitle><manvolnum>1</manvolnum></citerefentry>
++                </para>
++        </refsect1>
++
++</refentry>
+diff -up glade-3.15.0/man/glade.xml.man-pages glade-3.15.0/man/glade.xml
+--- glade-3.15.0/man/glade.xml.man-pages	2013-06-26 14:22:25.196562427 -0400
++++ glade-3.15.0/man/glade.xml	2013-06-26 14:22:25.196562427 -0400
+@@ -0,0 +1,114 @@
++<?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">
++
++<refentry id="glade">
++
++        <refentryinfo>
++                <title>glade</title>
++                <productname>GNOME</productname>
++
++                <authorgroup>
++                        <author>
++                                <contrib>Maintainer</contrib>
++                                <firstname>Tristan Van Berkom</firstname>
++                                <surname>Van Berkom</surname>
++                                <email>tristan.van.berkom at gmail.com</email>
++                        </author>
++                        <author>
++                                <contrib>Maintainer</contrib>
++                                <firstname>Juan Pablo</firstname>
++                                <surname>Ugarte</surname>
++                                <email>juanpablougarte at gmail.com</email>
++                        </author>
++                </authorgroup>
++
++        </refentryinfo>
++
++        <refmeta>
++                <refentrytitle>glade</refentrytitle>
++                <manvolnum>1</manvolnum>
++                <refmiscinfo class="manual">User Commands</refmiscinfo>
++        </refmeta>
++
++        <refnamediv>
++                <refname>glade</refname>
++                <refpurpose>Create GTK+ user interfaces</refpurpose>
++        </refnamediv>
++
++        <refsynopsisdiv>
++                <cmdsynopsis>
++                        <command>glade <arg choice="opt" rep="repeat">OPTION</arg> <arg choice="opt" rep="repeat">FILE</arg></command>
++                </cmdsynopsis>
++        </refsynopsisdiv>
++
++        <refsect1>
++                <title>Description</title>
++
++                <para><command>glade</command> is a tool to create or edit
++                user interfaces for GTK+ or GNOME applications. It saves
++                the user interface descriptions in xml files which can be
++                read by the GtkBuilder API that is part of GTK+.</para>
++        </refsect1>
++
++        <refsect1>
++                <title>Options</title>
++
++                <para>The following options can be specified:</para>
++
++                <variablelist>
++                        <varlistentry>
++                                <term><option>-h</option>, <option>--help</option></term>
++
++                                <listitem><para>Show help options.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--help-all</option></term>
++
++                                <listitem><para>Show all help options.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--help-debug</option></term>
++
++                                <listitem><para>Show Glade debug options.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--help-gtk</option></term>
++
++                                <listitem><para>Show GTK+ options.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--version</option></term>
++
++                                <listitem><para>Output version information
++                                and exit.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--without-devhelp</option></term>
++
++                                <listitem><para>Disable devhelp integration.</para></listitem>
++                        </varlistentry>
++
++                        <varlistentry>
++                                <term><option>--display=DISPLAY</option></term>
++
++                                <listitem><para>X display to use.</para></listitem>
++                        </varlistentry>
++
++                </variablelist>
++
++        </refsect1>
++
++        <refsect1>
++                <title>See Also</title>
++                <para>
++                        <citerefentry><refentrytitle>devhelp</refentrytitle><manvolnum>1</manvolnum></citerefentry>
++                </para>
++        </refsect1>
++
++</refentry>
+diff -up glade-3.15.0/man/Makefile.am.man-pages glade-3.15.0/man/Makefile.am
+--- glade-3.15.0/man/Makefile.am.man-pages	2013-06-26 14:22:25.196562427 -0400
++++ glade-3.15.0/man/Makefile.am	2013-06-26 14:22:25.196562427 -0400
+@@ -0,0 +1,22 @@
++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
++
++.xml.1:
++	$(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
++
++man_MANS = \
++	glade.1 \
++	glade-previewer.1
++
++xml_files = $(man_MANS:.1=.xml)
++
++EXTRA_DIST = $(xml_files)
++
++DISTCLEANFILES = $(man_MANS)
++
++-include $(top_srcdir)/git.mk
diff --git a/glade.spec b/glade.spec
index ee0f5a0..e6324e0 100644
--- a/glade.spec
+++ b/glade.spec
@@ -1,6 +1,9 @@
+%global _changelog_trimtime %(date +%s -d "1 year ago")
+
+
 Name:           glade
 Version:        3.15.0
-Release:        1%{?dist}
+Release:        2%{?dist}
 Summary:        User Interface Designer for GTK+
 
 # - /usr/bin/glade is GPLv2+
@@ -11,6 +14,7 @@ License:        GPLv2+ and LGPLv2+
 URL:            http://glade.gnome.org/
 Source0:        http://ftp.gnome.org/pub/GNOME/sources/glade/3.14/glade-%{version}.tar.xz
 Patch0:         glade-3.15.0-keywords.patch
+Patch1:         0001-Add-man-pages.patch
 
 BuildRequires:  chrpath
 BuildRequires:  desktop-file-utils
@@ -21,6 +25,8 @@ BuildRequires:  itstool
 BuildRequires:  libxml2-devel
 BuildRequires:  pygobject3-devel
 BuildRequires:  python2-devel
+BuildRequires:  docbook-style-xsl
+BuildRequires:  libxslt
 
 Requires:       %{name}-libs = %{version}-%{release}
 # The gtk3 version of glade was packaged under the name of 'glade3' for a
@@ -60,6 +66,7 @@ developing applications that use Glade widget library.
 %prep
 %setup -q
 %patch0 -p1 -b .keywords
+%patch1 -p1 -b .man-pages
 
 
 %build
@@ -111,6 +118,8 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || :
 %{_bindir}/glade-previewer
 %{_datadir}/applications/glade.desktop
 %{_datadir}/icons/hicolor/*/apps/glade.png
+%{_mandir}/man1/glade.1.gz
+%{_mandir}/man1/glade-previewer.1.gz
 
 %files libs
 %doc COPYING*
@@ -130,6 +139,10 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || :
 %doc %{_datadir}/gtk-doc/
 
 %changelog
+* Wed Jun 26 2013 Matthias Clasen <mclasen at redhat.com> - 3.15.0-2
+- Add man pages
+- Trim %%changelog
+
 * Mon Mar 18 2013 Richard Hughes <rhughes at redhat.com> - 3.15.0-1
 - Update to 3.15.0
 


More information about the scm-commits mailing list