Commit d7586e47 authored by Emmanuel Milou's avatar Emmanuel Milou

[#1212] Update the manpages generation - edit preinst maintainer script

parent ca9b0bbb
debian/sflphone/usr/share/man/man1/sflphoned.1
debian/sflphone-common/usr/share/man/man1/sflphoned.1
SECTION="1"
TEMPLATES=\
sflphone-gtk.pod \
sflphoned.pod
man_MANS = sflphoned.1 \
sflphone-gtk.1 \
sflphone.1
man_MANS = sflphoned.1
POD2MAN=pod2man
......@@ -19,23 +16,5 @@ SUFFIXES=.pod .1
.pod.1:
$(POD2MAN) --section=$(SECTION) --release=@VERSION@ --center "" $< > $@
#install-data-local:
# @catalogs='$(man_MANS)'; \
# for i in $$catalogs; do \
# destdir=$(data_installdir); \
# $(mkinstalldirs) $(data_installdir); \
# $(INSTALL_DATA) $$i $(data_installdir); \
# echo "installing $$i...done"; \
# done
#uninstall-local:
# @catalogs='$(MANPAGES)'; \
# for i in $$catalogs; do \
# destdir=$(data_installdir); \
# rm -f $(data_installdir)/$$i; \
# echo "removing $$i "; \
# done
clean-local:
rm -rf *.1
sflphone-gtk.pod
\ No newline at end of file
......@@ -10,7 +10,7 @@ sflphoned --help
SFLphone is meant to be a robust enterprise-class desktop phone. It provides functions like call transfer, call hold, multiple lines, multiple accounts support.
SFLphone audio layer is build upon a native ALSA interface and and a native PulseAudio interface.
B<sflphoned> is the core of SFLphone; it communicates with the client side through DBus. SFLphone package comes with a GTK+ client, B<sflphone-gtk>.
B<sflphoned> is the core of SFLphone; it communicates with the client side through DBus. You need to install a client to use the daemon, for instance GTK+ client, B<sflphone-client-gnome>.
=head1 BUGS
......@@ -24,7 +24,7 @@ This manual page was written by Emmanuel Milou <emmanuel.milou@savoirfairelinux.
=head1 SEE ALSO
B<sflphone>(1), B<sflphone-gtk>(1)
B<sflphone>(1), B<sflphone-client-gnome>(1)
=head1 COPYRIGHT
......
SUBDIRS = src pixmaps tests
SUBDIRS = src pixmaps tests man
ACLOCAL_AMFLAGS = -I m4
......
#!/bin/sh
#!/bin/bash
function autocmd()
{
echo "Running ${1}..."
$* || {
echo "Error running ${1}"
exit 1
}
}
autocmd libtoolize --force --copy
autocmd aclocal
autocmd autoheader
autocmd autoconf -f
autocmd automake --add-missing --force-missing --copy -Wall
# could be replaced with autoconf -v -f (verbose, force rebuild of ltmain, .in files, etc.)
if [ ! -d "m4" ]; then
mkdir m4
fi
aclocal -I m4
libtoolize --force
autoheader
autoconf -f
automake -a
./configure $@
#!/bin/sh
# could be replaced with autoconf -v -f (verbose, force rebuild of ltmain, .in files, etc.)
#if [ ! -d "m4" ]; then
# mkdir m4
#fi
#
#aclocal -I m4
#libtoolize --force
#autoheader
#autoconf -f
#automake -a
#./configure $@
#
#
......@@ -75,6 +75,7 @@ src/contacts/addressbook/Makefile
pixmaps/Makefile
sflphone.desktop
tests/Makefile
man/Makefile
])
debian/sflphone/usr/share/man/man1/sflphone.1
debian/sflphone/usr/share/man/man1/sflphoned.1
debian/sflphone/usr/share/man/man1/sflphone-gtk.1
debian/sflphone-client-gnome/usr/share/man/man1/sflphone.1
debian/sflphone-client-gnome/usr/share/man/man1/sflphone-gtk.1
......@@ -5,11 +5,14 @@
set -e
package=sflphone
package=sflphone-client-gnome
case "$1" in
install|upgrade)
# Clear the old dbus-c++ and iax2 if presents
## Clean up the previous manpage
if [ -f /usr/share/man/man1/sflphone-gtk.1 ]; then
rm /usr/share/man/man1/sflphone-gtk.1
fi
;;
esac
......
SECTION="1"
TEMPLATES=\
sflphone-client-gnome.pod
man_MANS = \
sflphone-client-gnome.1 \
sflphone.1
POD2MAN=pod2man
EXTRA_DIST= $(man_MANS)
all: $(MANPAGES)
SUFFIXES=.pod .1
.pod.1:
$(POD2MAN) --section=$(SECTION) --release=@VERSION@ --center "" $< > $@
clean-local:
rm -rf *.1
CREATING MANPAGES
Procedure:
- Creating the manual pages under POD format. A template is available in this directory.
- Convert the pdo file in a manpage file:
pod2man --section=1 --release=$(VERSION) --center "" myapp.pod > myapp.1
- You are done! You can read the manpage file with:
groff -man -Tascii myapp.1
Ref: https://wiki.ubuntu.com/PackagingGuide/Complete#Man%20Pages
=head1 NAME
sflphone-gtk - SIP and IAX2 compatible voice over IP softphone GTK+ client.
sflphone-client-gnome - SIP and IAX2 compatible voice over IP softphone GTK+ client.
=head1 SYNOPSIS
sflphone-gtk
sflphone-client-gnome
=head1 DESCRIPTION
SFLphone is meant to be a robust enterprise-class desktop phone. It provides functions like call transfer, call hold, multiple lines, multiple accounts support.
SFLphone audio layer is build upon a native ALSA interface and and a native PulseAudio interface.
B<sflphone-gtk> is a GTK+ client for SFLphone; it communicates with the core side through DBus. SFLphone package comes with the core, B<sflphoned>.
B<sflphone-client-gnome> is a GTK+ client for SFLphone; it communicates with the core side through DBus. SFLphone package comes with the core, B<sflphoned>.
=head1 BUGS
......
sflphone-client-gnome.pod
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment