[DHG_packages] 01/01: Added manpage for hsc2hs.

[Sven Bartscher]

This is an automated email from the git hooks/post-receive script.

svenb-guest pushed a commit to branch hsc2hs-man
in repository DHG_packages.

commit b431782089fa1b6295338cf8c07e94010675e94f
Author: Sven Bartscher <sven.bartscher at weltraumschlangen.de>
Date:   Tue Nov 17 17:04:45 2015 +0100

    Added manpage for hsc2hs.
---
 p/ghc/debian/hsc2hs.man | 73 +++++++++++++++++++++++++++++++++++++++++++++++++
 p/ghc/debian/rules      |  3 +-
 2 files changed, 75 insertions(+), 1 deletion(-)

diff --git a/p/ghc/debian/hsc2hs.man b/p/ghc/debian/hsc2hs.man
new file mode 100644
index 0000000..fc67c7b
--- /dev/null
+++ b/p/ghc/debian/hsc2hs.man
@@ -0,0 +1,73 @@
+.TH HSC2HS 1 "2015 October 27" "" "General Commands Manual"
+.SH NAME
+hsc2hs \- Haskell hsc preprocessor
+.SH SYNOPSIS
+hsc2hs [
+.I options
+]
+.I file
+[...]
+.SH DESCRIPTION
+The
+.I hsc2hs
+program can be used to automate some parts of the process of writing
+Haskell bindings to C code. It reads an almost-Haskell source file
+with embedded special constructs and outputs a real Haskell file with
+these processed, based on information taken from some C headers. The
+extra constructs provide Haskell counterparts of C types, values of C
+constants, including sizes of C types, and access to fields of C
+structs.
+.SH OPTIONS
+.TP
+\fB\-o \fIFILE\fP, \fB\-\-output\fP=\fIFILE\fP
+The name of the output file
+.TP
+\fB\-t \fIFILE\fP, \fB\-\-template\fP=\fIFILE\fP
+The name of the template file
+.TP
+\fB\-c \fIPROG\fP, \fB\-\-cc\fP=\fIPROG\fP
+The C compiler to use
+.TP
+\fB\-l \fIPROG\fP, \fB\-\-ld\fP=\fIPROG\fP
+The linker to use
+.TP
+\fB\-C \fIFLAG\fP, \fB\-\-cflag\fP=\fIFLAG\fP
+Flags to pass to the compiler
+.TP
+\fB\-I \fIDIR\fP
+An additional directory to search for C headers. Passed to the C compiler.
+.TP
+\fB\-L \fIFLAG\fP, \fB\-\-lflag\fP=\fIFLAG\fP
+An additional library to link with. Passed to the linker.
+.TP
+\fB\-i \fIFILE\fP, \fB\-\-include\fP=\fIFILE\fP
+Includes the given header file, as if it were included from within the
+source code.
+.TP
+\fB\-D \fINAME\fP[=\fIVALUE\fP], \
+\fB\-\-define\fP=\fIName\fP[=\fIVALUE\fP]
+Defines the given macro with the optional given name, as if it were
+defined from within the source code.
+.TP
+\fB\-\-no\-compile\fP
+Stop after writing *_hsc_make.c
+.TP
+\fB\-x\fP, \fB\-\-cross\-compile\fP
+Activate cross\-compilation mode
+.TP
+\fB\-\-cross\-safe\fP
+Restrict .hsc directives to those supported by \fB\-\-cross\-compile\fP
+.TP
+\fB\-k\fP, \fB\-\-keep\-files\fP
+Do not remove temporary files
+.TP
+\fB\-v\fP, \fB\-\-verbose\fP
+Dump commands to stderr
+.TP
+\fB\-?, \fB\-\-help\fP
+Display a help message and exit
+.TP
+\fB\-V\fP, \fB\-\-version\fP
+Output version information and exit
+.SH SEE ALSO
+Complete hsc2hs documentation: <https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/hsc2hs.html>
diff --git a/p/ghc/debian/rules b/p/ghc/debian/rules
index b285537..9a3f52e 100755
--- a/p/ghc/debian/rules
+++ b/p/ghc/debian/rules
@@ -70,7 +70,7 @@ endif
 	# We also want to build the threaded profiling-enabled debug runtime,
 	# because it does no harm
 	echo 'GhcRTSWays += $$(if $$(findstring p, $$(GhcLibWays)),thr_debug_p,)' >> mk/build.mk
-	
+
 	# We can't do this with a configure flag in 6.8.1 as libdir is not
 	# defined at the point at which we := it
 	echo 'ghclibdir := $${libdir}/ghc' >> mk/build.mk
@@ -171,6 +171,7 @@ endif
 	cp utils/hp2ps/hp2ps.1 debian/hp2ps.1
 	cp debian/ghc-pkg.man debian/ghc-pkg.1
 	echo ".so man1/ghc-pkg.1" > debian/ghc-pkg-$(ProjectVersion).1
+	cp debian/hsc2hs.man debian/hsc2hs.1
 
 	echo debian/*.1 > debian/ghc.manpages
 	cp debian/haddock.man debian/haddock.1

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-haskell/DHG_packages.git