[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