From 509c285380cdebddfe3e408a12484d80c1319ae2 Mon Sep 17 00:00:00 2001
From: "Kevin P. Fleming" <kpfleming@digium.com>
Date: Thu, 15 Sep 2005 00:12:36 +0000
Subject: [PATCH] don't distribute compressed man pages,let the installer do it

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@6608 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 Makefile      |   7 +--
 asterisk.8    | 165 ++++++++++++++++++++++++++++++++++++++++++++++++++
 asterisk.8.gz | Bin 2547 -> 0 bytes
 3 files changed, 168 insertions(+), 4 deletions(-)
 create mode 100755 asterisk.8
 delete mode 100755 asterisk.8.gz

diff --git a/Makefile b/Makefile
index 72e198fdee..f1c48c2c5b 100755
--- a/Makefile
+++ b/Makefile
@@ -399,13 +399,12 @@ testexpr2: ast_expr2f.c ast_expr2.c ast_expr2.h
 	gcc -g -o testexpr2 ast_expr2f.o ast_expr2.o
 	rm ast_expr2.c ast_expr2.o ast_expr2f.o ast_expr2f.c
 
-manpage: asterisk.8.gz
+manpage: asterisk.8
 
-asterisk.8.gz: asterisk.sgml
+asterisk.8: asterisk.sgml
 	rm -f asterisk.8
 	docbook2man asterisk.sgml
 	mv ./*.8 asterisk.8
-	gzip asterisk.8
 
 asterisk.pdf: asterisk.sgml
 	docbook2pdf asterisk.sgml
@@ -601,7 +600,7 @@ bininstall: all
 	mkdir -p $(DESTDIR)$(ASTMANDIR)/man8
 	install -m 644 keys/iaxtel.pub $(DESTDIR)$(ASTVARLIBDIR)/keys
 	install -m 644 keys/freeworlddialup.pub $(DESTDIR)$(ASTVARLIBDIR)/keys
-	install -m 644 asterisk.8.gz $(DESTDIR)$(ASTMANDIR)/man8
+	install -m 644 asterisk.8 $(DESTDIR)$(ASTMANDIR)/man8
 	install -m 644 contrib/scripts/astgenkey.8 $(DESTDIR)$(ASTMANDIR)/man8
 	install -m 644 contrib/scripts/autosupport.8 $(DESTDIR)$(ASTMANDIR)/man8
 	install -m 644 contrib/scripts/safe_asterisk.8 $(DESTDIR)$(ASTMANDIR)/man8
diff --git a/asterisk.8 b/asterisk.8
new file mode 100755
index 0000000000..d03c7873ed
--- /dev/null
+++ b/asterisk.8
@@ -0,0 +1,165 @@
+.\" This manpage has been automatically generated by docbook2man 
+.\" from a DocBook document.  This tool can be found at:
+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "ASTERISK" "8" "17 May 2005" "asterisk 1.0" ""
+
+.SH NAME
+asterisk \- All-purpose telephony server.
+.SH SYNOPSIS
+
+\fBasterisk\fR [ \fB-tThfdvVqpRgcin\fR ] [ \fB-C \fIfile\fB\fR ] [ \fB-U \fIuser\fB\fR ] [ \fB-G \fIgroup\fB\fR ] [ \fB-x \fIcommand\fB\fR ] [ \fB-M \fIvalue\fB\fR ]
+
+
+\fBasterisk -r\fR [ \fB-v\fR ] [ \fB-x \fIcommand\fB\fR ]
+
+.SH "DESCRIPTION"
+.PP
+\fBasterisk\fR is a full-featured telephony server which
+provides Private Branch eXchange (PBX), Interactive Voice Response (IVR),
+Automated Call Distribution (ACD), Voice over IP (VoIP) gatewaying, 
+Conferencing, and a plethora of other telephony applications to a broad
+range of telephony devices including packet voice (SIP, IAX, MGCP, Skinny,
+H.323) devices (both endpoints and proxies), as well as traditional TDM
+hardware including T1, E1, ISDN PRI, GR-303, RBS, Loopstart, Groundstart,
+ISDN BRI, and many more.
+.PP
+Asterisk reads most of its configuration files from configuration files
+located in /etc/asterisk.  Virtually all aspects of the operation of
+asterisk's configuration files can be found in the sample configuration
+files.  The format for those files is generally beyond the scope of this
+man page.
+.PP
+When running with \fB-c\fR, \fB-r\fR or \fB-R\fR
+options, Asterisk supplies a powerful command line, including command
+completion, which may be used to monitors its status, perform a variety
+of administrative actions and even explore the applications that are
+currently loaded into the system.
+.SH "OPTIONS"
+.TP
+\fB-C \fIfile\fB\fR
+Use \fIfile\fR as master configuration file
+instead of the default, /etc/asterisk/asterisk.conf
+.TP
+\fB-c\fR
+Provide a control console on the calling terminal.
+Specifying this option implies \fB-f\fR and will cause
+asterisk to no longer fork or detach from the controlling terminal.
+.TP
+\fB-d\fR
+Enable extra debugging statements.
+.TP
+\fB-f\fR
+Do not fork or detach from controlling terminal.
+.TP
+\fB-g\fR
+Remove resource limit on core size, thus forcing Asterisk to dump
+core in the unlikely event of a segmentation fault or abort signal.
+\fBNOTE:\fR in some cases this may be incompatible
+with the \fB-U\fR or \fB-G\fR flags.
+.TP
+\fB-G \fIgroup\fB\fR
+Run as group \fIgroup\fR instead of the
+calling group.  \fBNOTE:\fR this requires substantial work
+to be sure that Asterisk's environment has permission to write
+the files required for its operation, including logs, its comm
+socket, the asterisk database, etc.
+.TP
+\fB-h\fR
+Provide brief summary of command line arguments and terminate.
+.TP
+\fB-i\fR
+Prompt user to intialize any encrypted private keys during startup.
+.TP
+\fB-M \fIvalue\fB\fR
+Limits the maximum number of calls to the specified value.  This can
+be useful to prevent a system from being brought down by terminating
+too many simultaneous calls.
+.TP
+\fB-n\fR
+Disable ANSI colors even on terminals capable of displaying them.
+.TP
+\fB-p\fR
+If supported by the operating system (and executing as root),
+attempt to run with realtime priority for increased performance and
+responsiveness within the Asterisk process, at the expense of other
+programs running on the same machine.
+.TP
+\fB-q\fR
+Reduce default console output when running in conjunction with
+console mode (\fB-c\fR).
+.TP
+\fB-r\fR
+Instead of running a new Asterisk process, attempt to connect
+to a running Asterisk process and provide a console interface
+for controlling it.
+.TP
+\fB-R\fR
+Much like \fB-r\fR\&.  Instead of running a new Asterisk process, attempt to connect
+to a running Asterisk process and provide a console interface
+for controlling it. Additionally, if connection to the Asterisk 
+process is lost, attempt to reconnect for as long as 30 seconds.
+.TP
+\fB-t\fR
+When recording files, write them first into a temporary holding directory, 
+then move them into the final location when done.
+.TP
+\fB-T\fR
+Add timestamp to all non-command related output going to the console
+when running with verbose and/or logging to the console.
+.TP
+\fB-U \fIuser\fB\fR
+Run as user \fIuser\fR instead of the
+calling user.  \fBNOTE:\fR this requires substantial work
+to be sure that Asterisk's environment has permission to write
+the files required for its operation, including logs, its comm
+socket, the asterisk database, etc.
+.TP
+\fB-v\fR
+Increase the level of verboseness on the console.  The more times
+\fB-v\fR is specified, the more verbose the output is.
+Specifying this option implies \fB-f\fR and will cause
+asterisk to no longer fork or detach from the controlling terminal.
+This option may also be used in conjunction with \fB-r\fR
+and \fB-R\fR
+.TP
+\fB-V\fR
+Display version information and exit immediately.
+.TP
+\fB-x \fIcommand\fB\fR
+Connect to a running Asterisk process and execute a command on
+a command line, passing any output through to standard out and
+then terminating when the command execution completes.  Implies
+\fB-r\fR when \fB-R\fR is not explicitly
+supplied.
+.SH "EXAMPLES"
+.PP
+\fBasterisk\fR - Begin Asterisk as a daemon
+.PP
+\fBasterisk -vvvgc\fR - Run on controlling terminal
+.PP
+\fBasterisk -rx "show channels"\fR - Display channels on running server
+.SH "BUGS"
+.PP
+Bug reports and feature requests may be filed at http://bugs.digium.com
+.SH "SEE ALSO"
+.PP
+*CLI> \fBhelp\fR - Help on Asterisk CLI
+.PP
+*CLI> \fBshow applications\fR - Show loaded applications
+.PP
+http://www.asterisk.org - The Asterisk Home Page
+.PP
+http://www.asteriskdocs.org - The Asterisk Documentation Project
+.PP
+http://www.voip-info.org/wiki-Asterisk - The Asterisk Wiki
+.PP
+http://www.digium.com/ - Asterisk sponsor and hardware supplier
+.PP
+http://www.markocam.com/ - Asterisk author's web cam
+.SH "AUTHOR"
+.PP
+Mark Spencer <markster@digium.com>
+.PP
+Countless other contributers, see CREDITS with distribution for more information
diff --git a/asterisk.8.gz b/asterisk.8.gz
deleted file mode 100755
index d05b828286821f76e2b02f98eac700d760fae784..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2547
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

-- 
GitLab