Description: Add man pages
 Added man pages and updated Makefile.in and configure.ac with the needed
 changes to comply with Debian policy.

Author: Albert Huang <alberth.debian@gmail.com>
Bug-Debian: http://bugs.debian.org/678229
Forwarded: no
Last-Update: 2012-06-22

--- a/aclocal.m4
+++ b/aclocal.m4
@@ -1,7 +1,8 @@
-# generated automatically by aclocal 1.11.1 -*- Autoconf -*-
+# generated automatically by aclocal 1.11.5 -*- Autoconf -*-
 
 # Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
-# 2005, 2006, 2007, 2008, 2009  Free Software Foundation, Inc.
+# 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation,
+# Inc.
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
 # with or without modifications, as long as this notice is preserved.
--- a/Makefile.in
+++ b/Makefile.in
@@ -32,26 +32,31 @@
 	gui/Makefile.in gui/*.c gui/*.h gui/*.ico gui/*.rc.in \
 	installer/win32/Makefile.in \
 	installer/win32/installer.nsi.in installer/win32/gtkrc \
-	installer/win32/COPYING-ZLIB installer/win32/COPYING-PIXMAN
+	installer/win32/COPYING-ZLIB installer/win32/COPYING-PIXMAN \
+	man/Makefile.in
 
 all:
 	cd emu && $(MAKE)
 	cd db && $(MAKE)
 	cd gui && $(MAKE)
+	cd man && $(MAKE)
 
 clean:
 	cd emu && $(MAKE) clean
 	cd db && $(MAKE) clean
 	cd gui && $(MAKE) clean
 	cd installer/win32 && $(MAKE) clean
+	cd man && $(MAKE) clean
 
 install: all
 	cd gui && $(MAKE) install
 	cd data && $(MAKE) install
+	cd man && $(MAKE) install
 
 uninstall:
 	cd gui && $(MAKE) uninstall
 	cd data && $(MAKE) uninstall
+	cd man && $(MAKE) uninstall
 
 install-home: all
 	$(MAKE) install \
@@ -68,7 +73,7 @@
 	rm -rf autom4te.cache
 	rm -f installer/win32/Makefile installer/win32/installer.nsi
 	rm -f gui/tilem2.rc
-	rm -f Makefile emu/Makefile db/Makefile gui/Makefile data/Makefile
+	rm -f Makefile emu/Makefile db/Makefile gui/Makefile data/Makefile man/Makefile
 
 dist:
 	rm -rf $(distname)
--- a/configure.ac
+++ b/configure.ac
@@ -168,5 +168,6 @@
                  gui/Makefile
                  gui/tilem2.rc
                  installer/win32/Makefile
-                 installer/win32/installer.nsi])
+                 installer/win32/installer.nsi
+                 man/Makefile])
 AC_OUTPUT
--- /dev/null
+++ b/man/tilem2.1
@@ -0,0 +1,69 @@
+.\" Man page for TilEm2
+.\" Authored by Albert Huang (alberth.debian@gmail.com)
+.\" This man page is a work in progress! Please update accordingly.
+
+.TH TILEM 1 "June 20, 2012"
+.SH NAME
+TilEm2 \- a GTK+ TI Z80 calculator emulator
+.SH SYNOPSYS
+\fBtilem2\fP [\-\-help] [\-h] [\-\-rom=] [\-\-skin=] [\-\-model=] [\-\-state\-file=] [\-\-without\-skin] [\-\-reset] [\-\-get\-var=] [\-\-play\-macro=] [\-\-debug] [\-\-normal\-speed] [\-\-full\-speed] [filename]
+.SH DESCRIPTION
+The \fBTilEm2\fP program allows you to emulate your Texas Intruments calculator on your computer. It has also additional features such as screenshotting, loading OSes and apps, FLASH writing and erasing, macro scripting, debugger, and virtual linking.
+.SH OPTIONS
+For running a specific rom, simply pass the ROM's file name to the program.
+Options must be passed before the filename.
+
+\fBtilem2\fP accepts the following options:
+.TP
+\fB\-h, \-\-help\fP
+Display a list of all command line options.
+.TP
+\fB\-\-reset\fP
+Reset the calculator at startup. You will lose anything that you were working on in that calculator state.
+.TP
+\fB\-\-rom=\fP\fIFILE\fP, \fB\-r=\fP\fIFILE\fP
+Load a specific ROM file instead of the ROM saved in your configuration.
+.TP
+\fB\-\-skin=\fP\fIFILE\fP, \fB\-k=\fP\fIFILE\fP
+Use a specific skin file instead of the skin saved in your configuration.
+.TP
+\fB\-\-model=\fP\fIFILE\fP, \fB\-m=\fP\fINAME\fP
+Use a specific calculator model instead of the model autodetected by TilEm2.
+.TP
+\fB\-\-without\-skin\fP, \fB\-l\fP
+Do not use any skins for the calculator display.
+.TP
+\fB\-\-state\-file=\fP\fIFILE\fP, \fB\-s=\fP\fIFILE\fP
+Load a specific ROM state file instead of the ROM state saved in your configuration.
+.TP
+\fB\-\-getvar=\fP\fIFILE\fP
+Load a variable into the calculator on startup.
+.TP
+\fB\-\-play\-macro=\fP\fIFILE\fP, \fB\-p=\fP\fIFILE\fP
+Run a calculator macro on startup.
+.TP
+\fB\-\-debug, \fB\-d\fP
+Enable emulator debugging.
+.TP
+\fB\-\-normal\-speed\fB
+Run at normal speed
+\fB\-\-full\-speed\fB
+Run at maximum speed
+\fB\-\-display=\fP\fIDISPLAY\fP
+X display to use
+.SH EXAMPLE
+Run a particular ROM file:
+.TP
+tilem2 \-\-rom=myrom.rom
+.TP
+Emulate a TI\-84+ SE ROM in TI\-83:
+.TP
+tilem2 \-\-rom=sillyrom.rom \-\-model=TI83
+.SH AUTHOR
+TilEm2 was written by Romain Lievin, Benjamin Moody, Duponchelle
+Thibault and others. This manual page was written by Albert Huang
+<alberth.debian@gmail.com> for the Debian GNU/Linux system (but
+may be used by others).  It was subsequently revised by Andreas
+B. Mundt <andi@debian.org>.
+.SH SEE ALSO
+tilp(1) tiemu(1)
--- /dev/null
+++ b/man/Makefile.in
@@ -0,0 +1,42 @@
+prefix = @prefix@
+exec_prefix = @exec_prefix@
+datarootdir = @datarootdir@
+bindir = @bindir@
+datadir = @datadir@
+pkgdatadir = @datadir@/tilem2
+mandir = @mandir@
+
+top_builddir = @top_builddir@
+top_srcdir = @top_srcdir@
+srcdir = @srcdir@
+VPATH = @srcdir@
+@SET_MAKE@
+SHELL = @SHELL@
+
+INSTALL = @INSTALL@
+
+distname = @PACKAGE_TARNAME@-@PACKAGE_VERSION@
+all:
+
+install:
+	$(INSTALL) -d $(DESTDIR)$(mandir)/man1/
+	$(INSTALL) -g 0 -o 0 -m 755 tilem2.1 $(DESTDIR)$(mandir)/man1/tilem2.1
+	gzip $(DESTDIR)$(mandir)/man1/tilem2.1
+
+uninstall:
+	rm -f $(DESTDIR)$(mandir)/man1/tilem2.1.gz
+
+clean:
+
+distclean:
+
+Makefile: Makefile.in $(top_builddir)/config.status
+	cd $(top_builddir) && $(SHELL) ./config.status
+
+uninstall-home:
+	$(MAKE) uninstall \
+	  bindir=$(HOME)/bin \
+	  datarootdir=$${XDG_DATA_HOME:-$(HOME)/.local/share}
+
+.PRECIOUS: Makefile $(top_builddir)/config.status
+.PHONY: all clean install uninstall