[Pkg-wmaker-commits] [wmfrog] 31/145: Add POD manual page

Doug Torrance dtorrance-guest at moszumanska.debian.org
Sun Aug 23 05:46:16 UTC 2015


This is an automated email from the git hooks/post-receive script.

dtorrance-guest pushed a commit to branch master
in repository wmfrog.

commit a1894dc8765a5df95c7e2f7d50a8e91103302242
Author: Jari Aalto <jari.aalto at cante.net>
Date:   Fri Nov 7 11:57:11 2008 +0200

    Add POD manual page
    
    Signed-off-by: Jari Aalto <jari.aalto at cante.net>
---
 debian/changelog      |   6 +++
 debian/debian-vars.mk | 126 ++++++++++++++++++++++++++++++++++++++++++++++++++
 debian/pod2man.mk     |  60 ++++++++++++++++++++++++
 debian/rules          |  20 ++++++--
 debian/wmfrog.1.pod   | 110 +++++++++++++++++++++++++++++++++++++++++++
 5 files changed, 318 insertions(+), 4 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index e3f1f7b..371159b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+wmfrog (0.2.0-1) unstable; urgency=low
+
+  * New Upstream Version
+
+ -- Jari Aalto <jari.aalto at cante.net>  Fri, 07 Nov 2008 11:08:56 +0200
+
 wmfrog (0.1.6-1) unstable; urgency=low
 
   * Initial release (RFP/ITP; Closes: #504786).
diff --git a/debian/debian-vars.mk b/debian/debian-vars.mk
new file mode 100644
index 0000000..70e76b3
--- /dev/null
+++ b/debian/debian-vars.mk
@@ -0,0 +1,126 @@
+# debian-vars.mk -- Common variables
+#
+#   Copyright
+#
+#	Copyright (C) 2005-2009 Jari Aalto <jari.aalto at cante.net>
+#
+#   License
+#
+#	This program is free software; you can redistribute it and or
+#	modify it under the terms of the GNU General Public License as
+#	published by the Free Software Foundation; either version 2 of
+#	the License, or (at your option) any later version.
+#
+#	This program is distributed in the hope that it will be useful, but
+#	WITHOUT ANY WARRANTY; without even the implied warranty of
+#	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+#	General Public License for more details at
+#	<http://www.gnu.org/copyleft/gpl.html>.
+#
+#   Description
+#
+#	This is GNU makefile part, that defines common variables and
+#	macros to be used from debian/rules. To install, add this:
+#
+#	    PACKAGE = foo
+#	    include debian/debian-vars.mk
+
+ifneq (,)
+    This makefile requires GNU Make.
+endif
+
+PACKAGE		?= foo
+PKGDIR		= $(CURDIR)/debian/$(PACKAGE)
+
+SHAREROOTDIR	= $(PKGDIR)/usr/share
+SHAREDIR	= $(SHAREROOTDIR)/$(PACKAGE)
+DOCROOTDIR	= $(SHAREROOTDIR)/doc
+PKGDOCDIR	= $(SHAREROOTDIR)/doc/$(PACKAGE)
+SITELISPDIR	= $(SHAREROOTDIR)/site-lisp
+PKGLISPDIR	= $(SHAREROOTDIR)/site-lisp/$(PACKAGE)
+DESKTOPDIR	= $(SHAREROOTDIR)/applications
+LOCALEDIR	= $(SHAREROOTDIR)/locale
+INFODIR		= $(SHAREROOTDIR)/info
+PIXDIR		= $(SHAREROOTDIR)/pixmaps
+
+MANROOTDIR	= $(SHAREROOTDIR)/man
+MAN1DIR		= $(MANROOTDIR)/man1
+MAN5DIR		= $(MANROOTDIR)/man5
+MAN8DIR		= $(MANROOTDIR)/man8
+
+LIBROOTDIR	= $(PKGDIR)/usr/lib
+LIBDIR		= $(LIBROOTDIR)/$(PACKAGE)
+LIBPERLDIR	= $(LIBROOTDIR)/perl
+
+BINDIR		= $(PKGDIR)/usr/bin
+SBINDIR		= $(PKGDIR)/usr/sbin
+
+INSTALL		?= /usr/bin/install
+INSTALL_DATA	= $(INSTALL) -p -m 644
+INSTALL_SCRIPT	= $(INSTALL) -p -m 755
+INSTALL_BIN	= $(INSTALL) -p -m 755
+INSTALL_DIR	= $(INSTALL) -m 755 -d
+
+#######################################################################
+# These are used for cross-compiling and for saving the configure script
+# from having to guess our platform (since we know it already)
+#
+# [Add this]
+# config.status: configure
+#	...
+#	./configure --host=$(DEB_HOST_GNU_TYPE) \
+#		    --build=$(DEB_BUILD_GNU_TYPE) \
+
+DEB_HOST_GNU_TYPE   ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
+DEB_BUILD_GNU_TYPE  ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
+
+#######################################################################
+# [Add this to use multiple CPU cores]
+#	build-stamp:
+#		$(MAKE) $(MAKE_FLAGS)
+
+ifeq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS)))
+    INSTALL_BIN += -s
+endif
+
+CFLAGS		= -Wall -g
+
+ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
+    CFLAGS += -O0
+else
+    CFLAGS += -O2
+endif
+
+MAKE_FLAGS	=
+CPU_COUNT	:= $(shell fgrep -c processor /proc/cpuinfo 2> /dev/null | \
+		     egrep "^[2-9]$$|^[0-9][0-9]$$")
+
+ifneq ($(CPU_COUNT),)
+    MAKE_FLAGS	+= -j$(CPU_COUNT)
+endif
+
+#######################################################################
+# If the override is for a source package, you have to place it at
+# debian/source.lintian-overrides. For binary, Write file
+# debian/<package>.lintian-overrides
+#
+#     <package> binary: <lintian-error> <file>
+#
+#  [Add this to debian/rules]
+#  install:
+#	...
+#	$(MAKE) install
+#	$(lintian-overrides)
+
+OVERRIDEDIR	= usr/share/lintian/overrides
+PKGDIR_LINTIAN	= $(PKGDIR)/$(OVERRIDEDIR)
+
+define lintian-overrides
+	# Install Lintian override file
+	$(INSTALL_DIR) $(PKGDIR_LINTIAN)
+	$(INSTALL_DATA) debian/$(PACKAGE).lintian-overrides \
+		$(PKGDIR_LINTIAN)/$(PACKAGE)
+
+endef
+
+# End of Makefile part
diff --git a/debian/pod2man.mk b/debian/pod2man.mk
new file mode 100644
index 0000000..4145817
--- /dev/null
+++ b/debian/pod2man.mk
@@ -0,0 +1,60 @@
+# pod2man.mk -- Makefile portion to convert *.pod files to manual pages
+#
+#   Copyright information
+#
+#	Copyright (C) 2008-2009 Jari Aalto
+#
+#   License
+#
+#	This program is free software; you can redistribute it and/or
+#	This program is free software; you can redistribute it and/or
+#	modify it under the terms of the GNU General Public License as
+#	published by the Free Software Foundation; either version 2 of the
+#	License, or (at your option) any later version
+#
+#	This program is distributed in the hope that it will be useful, but
+#	WITHOUT ANY WARRANTY; without even the implied warranty of
+#	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+#	General Public License for more details at
+#	Visit <http://www.gnu.org/copyleft/gpl.html>.
+#
+#   Description
+#
+# 	Convert *.pod files to manual pages. Write this to 'install'
+# 	target:
+#
+#       install: build $(MANPAGE)
+
+ifneq (,)
+This makefile requires GNU Make.
+endif
+
+# These variables *must* be set when calling
+PACKAGE		= package
+PODCENTER	= $$(date "+%Y-%m-%d")
+MANSECT		= 1
+
+# Directories
+MANSRC		=
+MANDEST		= $(MANSRC)
+
+MANPOD		= $(MANSRC)$(PACKAGE).$(MANSECT).pod
+MANPAGE		= $(MANDEST)$(PACKAGE).$(MANSECT)
+
+POD2MAN		= pod2man
+POD2MAN_FLAGS	= --utf8
+
+makeman: $(MANPAGE)
+
+$(MANPAGE): $(MANPOD)
+	podchecker $(MANPOD)
+	LC_ALL= LANG=C $(POD2MAN) $(POD2MAN_FLAGS) \
+		--center="$(PODCENTER)" \
+		--name="$(PACKAGE)" \
+		--section="$(MANSECT)" \
+		$(MANPOD) \
+	| sed 's,[Pp]erl v[0-9.]\+,$(PACKAGE),' \
+	  > $(MANPAGE) && \
+	rm -f pod*.tmp
+
+# End of of Makefile part
diff --git a/debian/rules b/debian/rules
index 9461c3a..3ece2fa 100755
--- a/debian/rules
+++ b/debian/rules
@@ -7,7 +7,17 @@
 MAKEDIR = Src
 MAKEOPT = -C $(MAKEDIR)
 
+PACKAGE = wmfrog
+MANSECT = 1x
+
 include /usr/share/dpatch/dpatch.make
+include debian/debian-vars.mk
+include debian/pod2man.mk
+
+man:
+	# convert *.pod to manual page
+	$(MAKE) -C debian -f pod2man.mk PACKAGE=$(PACKAGE) \
+	MANSECT=$(MANSECT) makeman
 
 configure: configure-stamp
 
@@ -18,11 +28,11 @@ configure-stamp:
 
 build: build-stamp
 
-build-stamp: configure-stamp patch
+build-stamp: configure-stamp patch man
 	dh_testdir
 
 	# Commands to compile the package.
-	$(MAKE) $(MAKEOPT)
+	$(MAKE) $(MAKE_FLAGS) $(MAKEOPT)
 
 	touch build-stamp
 
@@ -34,6 +44,8 @@ clean: unpatch
 	# Commands to clean up after the build process.
 	[ ! Src/Makefile ] || $(MAKE) $(MAKEOPT) clean
 
+	rm -f debian/*.$(MANSECT)
+
 	dh_clean
 
 install: build
@@ -66,7 +78,7 @@ binary-arch: build install
 #       dh_installinit
 #       dh_installcron
 #       dh_installinfo
-	dh_installman Src/wmfrog.1
+	dh_installman debian/*.$(MANSECT)
 	dh_link
 	dh_strip
 	dh_compress
@@ -81,4 +93,4 @@ binary-arch: build install
 	dh_builddeb
 
 binary: binary-indep binary-arch
-.PHONY: build clean binary-indep binary-arch binary install configure
+.PHONY: build clean binary-indep binary-arch binary install configure man
diff --git a/debian/wmfrog.1.pod b/debian/wmfrog.1.pod
new file mode 100644
index 0000000..fd6c029
--- /dev/null
+++ b/debian/wmfrog.1.pod
@@ -0,0 +1,110 @@
+Rxu#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=pod
+
+=head1 NAME
+
+wmfrog - a dockapp for showing weather in graphical way
+
+=head1 SYNOPSIS
+
+  wmfrog [options] -stattion <METAR station id>
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-delay minutes>
+
+Override time (in minutes) between updates. Default is 15.
+
+=item B<-m, -metric>
+
+Display Temperature in metric unit: Celcius.
+
+=item B<-o offset>
+
+Time offset of location from UTC. Positive or negative integer
+expressed in hours, like +1 or -7.
+
+=item B<-s, -station>
+
+Required option. The 4-character METAR Station ID. See
+http://en.wikipedia.org/wiki/METAR
+
+=item B<-w knots>
+
+Set the maximum wind in KNOTS for percentage of max / scaling. Default
+is 50 Knots.
+
+=item B<-tmp directory>
+
+Set the temporary directory where the METAR data files are downloaded
+Default is C</tmp>.
+
+=item B<-l label>
+
+Set displayed text to 4 character (max) label to replace the METAR
+station id.
+
+=item B<>
+
+
+=item B<>
+
+=back
+
+=head1 DESCRIPTION
+
+A dockapp for wheather reports. Includes clouds (clear, few,
+scattered, broken, overcast ...); Precipitations (drizzle, rain, snow,
+ice christals: light/moderate or heavy); Special weather (Blowing wind
+/ Freezing / Thunderstorm, funnel cloud...); Humidity perentage; Wind
+speed (average & gust); Wind Direction; Temperature (Celcius or
+Fareinheit); Station name can be configured and weather report time is
+displayed.
+
+To find out more about the METAR/TAF system, see
+I<Frequently Asked Questions about METAR/SPECI and TAF> at
+http://www.nws.noaa.gov/oso/oso1/oso12/faq.htm
+
+To find your city Metar code go to NOAA's Meteorological Station
+Information Lookup page I<Meteorological Products Processed At The
+NWSTG> at at http://www.nws.noaa.gov/tg/siteloc.shtml
+
+=head1 ENVIRONMENT
+
+None.
+
+=head1 FILES
+
+=item /tmp/<station-id>/
+
+Stored data files. The directory can be changed with option B<-tmp>
+
+=head1 SEE ALSO
+
+wmweather(1)
+wmweather+(1)
+
+=head1 AUTHORS
+
+program was written by Thibaut Colar <tcolar at users.sourceforge.net>
+
+This manual page is based on 0.1.6 version of the program. Updated by Jari
+Aalto <jari.aalto at cante.net>. Released under license GNU GPL v2 or (at
+your option) any later version. For more information about license, visit
+<http://www.gnu.org/copyleft/gpl.html>.
+
+=cut

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-wmaker/wmfrog.git



More information about the Pkg-wmaker-commits mailing list