Skip to content
Snippets Groups Projects
Commit d7586e47 authored by Emmanuel Milou's avatar Emmanuel Milou
Browse files

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

parent ca9b0bbb
No related branches found
No related tags found
No related merge requests found
debian/sflphone/usr/share/man/man1/sflphoned.1 debian/sflphone-common/usr/share/man/man1/sflphoned.1
SECTION="1" SECTION="1"
TEMPLATES=\ TEMPLATES=\
sflphone-gtk.pod \
sflphoned.pod sflphoned.pod
man_MANS = sflphoned.1 \ man_MANS = sflphoned.1
sflphone-gtk.1 \
sflphone.1
POD2MAN=pod2man POD2MAN=pod2man
...@@ -19,23 +16,5 @@ SUFFIXES=.pod .1 ...@@ -19,23 +16,5 @@ SUFFIXES=.pod .1
.pod.1: .pod.1:
$(POD2MAN) --section=$(SECTION) --release=@VERSION@ --center "" $< > $@ $(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: clean-local:
rm -rf *.1 rm -rf *.1
sflphone-gtk.pod
\ No newline at end of file
...@@ -10,7 +10,7 @@ sflphoned --help ...@@ -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 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. 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 =head1 BUGS
...@@ -24,7 +24,7 @@ This manual page was written by Emmanuel Milou <emmanuel.milou@savoirfairelinux. ...@@ -24,7 +24,7 @@ This manual page was written by Emmanuel Milou <emmanuel.milou@savoirfairelinux.
=head1 SEE ALSO =head1 SEE ALSO
B<sflphone>(1), B<sflphone-gtk>(1) B<sflphone>(1), B<sflphone-client-gnome>(1)
=head1 COPYRIGHT =head1 COPYRIGHT
......
SUBDIRS = src pixmaps tests SUBDIRS = src pixmaps tests man
ACLOCAL_AMFLAGS = -I m4 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 $@ ./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 ...@@ -75,6 +75,7 @@ src/contacts/addressbook/Makefile
pixmaps/Makefile pixmaps/Makefile
sflphone.desktop sflphone.desktop
tests/Makefile tests/Makefile
man/Makefile
]) ])
debian/sflphone/usr/share/man/man1/sflphone.1 debian/sflphone-client-gnome/usr/share/man/man1/sflphone.1
debian/sflphone/usr/share/man/man1/sflphoned.1 debian/sflphone-client-gnome/usr/share/man/man1/sflphone-gtk.1
debian/sflphone/usr/share/man/man1/sflphone-gtk.1
...@@ -5,11 +5,14 @@ ...@@ -5,11 +5,14 @@
set -e set -e
package=sflphone package=sflphone-client-gnome
case "$1" in case "$1" in
install|upgrade) 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 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 =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 =head1 SYNOPSIS
sflphone-gtk sflphone-client-gnome
=head1 DESCRIPTION =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 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. 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 =head1 BUGS
......
sflphone-client-gnome.pod
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment