[Pkg-haskell-commits] r772 - in /packages/c2hs/trunk/debian: c2hs.1 changelog control docs rules
arjan at users.alioth.debian.org
arjan at users.alioth.debian.org
Sun Sep 16 22:20:32 UTC 2007
Author: arjan
Date: Sun Sep 16 22:20:32 2007
New Revision: 772
URL: http://svn.debian.org/wsvn/pkg-haskell/?sc=1&rev=772
Log:
r2065 at nebula: arjan | 2007-09-16 21:34:03 +0200
* debian/c2hs.1: Added temporarily.
- Temporarily stop building the c2hs-doc package as upstream
accidentally did not ship documentation with this release.
Added:
packages/c2hs/trunk/debian/c2hs.1
Removed:
packages/c2hs/trunk/debian/docs
Modified:
packages/c2hs/trunk/debian/changelog
packages/c2hs/trunk/debian/control
packages/c2hs/trunk/debian/rules
Added: packages/c2hs/trunk/debian/c2hs.1
URL: http://svn.debian.org/wsvn/pkg-haskell/packages/c2hs/trunk/debian/c2hs.1?rev=772&op=file
==============================================================================
--- packages/c2hs/trunk/debian/c2hs.1 (added)
+++ packages/c2hs/trunk/debian/c2hs.1 Sun Sep 16 22:20:32 2007
@@ -1,0 +1,149 @@
+.\" Hey Emacs! This file is -*- nroff -*- source.
+.\"
+.\" Version $Revision: 1.2 $ from $Date: 2002/09/15 07:00:41 $
+.\"
+.TH C2HS 1 "14 November 1999" "Version 0.14.5" C\->Haskell
+.SH NAME
+c2hs \- C->Haskell Interface Generator
+
+.SH SYNOPSIS
+.B c2hs
+[
+.IR OPTIONS ...
+] [
+.I header-file
+]
+.I binding-file
+
+.SH DESCRIPTION
+This manual page briefly describes the
+.B c2hs
+command.
+For more details, refer to the main documentation, which is available in various other formats, including SGML and HTML; see below.
+.PP
+
+.SH OPTIONS
+The programs follow the usual GNU command line syntax, with long options
+starting with two dashes (`-'). A summary of options are included below. For
+a complete description, see the other documentation.
+
+.B c2hs
+accepts the following options:
+.TP
+\fB\-C\fP \fICPPOPTS\fP, \fB\-\-cppopts\fP=\fICPPOPTS\fP
+pass CPPOPTS to the C preprocessor
+.TP
+\fB\-c\fP \fICPP\fP, \fB\-\-cpp\fP=\fICPP\fP
+use executable CPP to invoke C preprocessor
+.TP
+ \fB\-\-data\fP=\fIDIR\fP
+data directory (set by wrapper script)
+.TP
+\fB\-d\fP \fITYPE\fP, \fB\-\-dump\fP=\fITYPE\fP
+dump internal information (for debugging), where \fITYPE\fP is one of:
+.RS
+.IP "\(bu \fBtrace\fP" 10
+trace compiler phases
+.IP "\(bu \fBgenbind\fP" 10
+trace binding generation
+.IP "\(bu \fBctrav\fP" 10
+trace C declaration traversal
+.IP "\(bu \fBchs\fP" 10
+dump the binding file (adds `.dump' to the name)
+.RE
+.TP
+\fB\-h\fP, \fB\-?\fP, \fB\-\-help\fP
+brief help
+.TP
+\fB\-i\fP \fIINCLUDE\fP, \fB\-\-include\fP=\fIINCLUDE\fP
+include paths for \fI.chi\fP files
+.TP
+\fB\-k\fP, \fB\-\-keep\fP
+keep pre-processed C header
+.TP
+\fB\-l\fP, \fB\-\-copy-library\fP
+copy `C2HS' library module in
+.TP
+\fB\-o\fP \fIFILE\fP, \fB\-\-output\fP=\fIFILE\fP
+output result to FILE (should end in \fI.hs\fP)
+.TP
+\fB\-p\fP \fIPLATFORM\fP, \fB\-\-platform\fP=\fIPLATFORM\fP
+platform to use for cross compilation, where \fIPLATFORM\fP is one of
+.RS
+.TP
+\(bu \fBi686-pc-linux-gnu\fP
+.TP
+\(bu \fBm68k-palmos\fP
+.RE
+.TP
+\fB\-t\fP \fIPATH\fP, \fB\-\-output-dir\fP=\fIPATH\fP
+place generated files in \fIPATH\fP
+.TP
+\fB\-v\fP, \fB\-\-version\fP
+show version information
+.PP
+
+.I header-file
+is the header file belonging to the marshalled library.
+It must end with suffix
+.IR .h .
+
+.I binding-file
+is the corresponding Haskell binding file, which must end with suffix
+.IR .chs .
+
+The most useful of these options is probably
+.B \-\-cppopts
+(or
+.BR \-C ).
+If the C header file needs any special options (like \-D or \-I) to go
+through the C pre-processor, here is the place to pass them.
+
+.SH EXAMPLES
+
+The C->Haskell Interface Generator is usually called as:
+
+.B c2hs
+.I lib.h Lib.chs
+
+where
+.I lib.h
+is the header file and
+.I Lib.chs
+the Haskell binding module, which define the C- and Haskell-side interface, respectively.
+If no errors occur, the result is a pure Haskell module
+.IR Lib.hs ,
+which implements the Haskell API of the library.
+
+A more advanced call may look like this:
+
+.BR "c2hs \-\-cppopts=" '\-I\fI/some/obscure/dir\fR
+-DEXTRA'
+.I lib.h Lib.chs
+
+Often,
+.I lib.h
+will not be in the current directory, but in one of the header file
+directories. Apart from the current directory, C->Haskell looks in two
+places for the header: first, in the standard include directory of the used
+system, this is usually
+.IR /usr/include " and " /usr/local/include ;
+and second, it will look in every directory that is mentioned in a
+.RI \-I DIR
+option passed to the pre-processor via
+.BR \-\-cppopts .
+
+.SH CAVEATS
+Do not forget the quotes if you have more than one option that you want to
+give to the pre-processor.
+
+.SH "SEE ALSO"
+.I /usr/share/doc/c2hs-doc/html/c2hs.html
+
+.SH COPYRIGHT
+C->Haskell Version 0.14.5 Copyright \(co 1999 \(en 2005
+Manuel M. T. Chakravarty <chak at cse.unsw.edu.au>
+
+.SH AUTHOR
+This manual page was mainly assembled from the original documentation.
+It was written by Michael Weber <michael.weber at post.rwth-aachen.de> for the Debian GNU/Linux system (but may be used by others).
Modified: packages/c2hs/trunk/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-haskell/packages/c2hs/trunk/debian/changelog?rev=772&op=diff
==============================================================================
--- packages/c2hs/trunk/debian/changelog (original)
+++ packages/c2hs/trunk/debian/changelog Sun Sep 16 22:20:32 2007
@@ -1,12 +1,15 @@
c2hs (0.15.0-1~pre1) experimental; urgency=low
* New upstream release.
+ * debian/c2hs.1: Added temporarily.
* debian/c2hs.install:
- Updated for new release.
* debian/control:
- Add alex and happy to the Build-Depends.
- Drop autotools-dev from the Build-Depends as the config.{sub,guess}
files are not needed anymore.
+ - Temporarily stop building the c2hs-doc package as upstream
+ accidentally did not ship documentation with this release.
* debian/patches:
- Disabled 01_update-manpage and 11_documentation-fix as the tarball
does not ship any documentation.
Modified: packages/c2hs/trunk/debian/control
URL: http://svn.debian.org/wsvn/pkg-haskell/packages/c2hs/trunk/debian/control?rev=772&op=diff
==============================================================================
--- packages/c2hs/trunk/debian/control (original)
+++ packages/c2hs/trunk/debian/control Sun Sep 16 22:20:32 2007
@@ -4,7 +4,7 @@
Maintainer: Arjan Oosting <arjan at debian.org>
Build-Depends: alex, debhelper (>= 5.0.0), dpatch,
dpkg-dev (>= 1.13.19), ghc6 (>= 6.4.2), happy
-Build-Depends-Indep: groff, linuxdoc-tools
+#Build-Depends-Indep: groff, linuxdoc-tools
Build-Conflicts: libghc6-wash-dev
Standards-Version: 3.7.2
XS-Vcs-Svn: svn://svn.debian.org/svn/pkg-haskell/packages/c2hs
@@ -30,22 +30,22 @@
.
This package contains the c2hs parser.
-Package: c2hs-doc
-Section: doc
-Architecture: all
-Depends: ${misc:Depends}
-Recommends: c2hs (>= ${source:Version})
-Description: C->Haskell Interface Generator -- Documentation package
- C->Haskell is an interface generator that simplifies the development
- of Haskell bindings to C libraries. The tool processes existing C
- header files that determine data layout and function signatures on
- the C side in conjunction with Haskell modules that specify
- Haskell-side type signatures and marshaling details. Hooks embedded
- in the Haskell code signal access to C structures and functions --
- they are expanded by the interfacing tool in dependence on
- information from the corresponding C header file.
- .
- Haskell 98 is "the" standard lazy functional programming language.
- More info plus the language definition is at http://www.haskell.org/.
- .
- This package contains documentation for c2hs.
+#Package: c2hs-doc
+#Section: doc
+#Architecture: all
+#Depends: ${misc:Depends}
+#Recommends: c2hs (>= ${source:Version})
+#Description: C->Haskell Interface Generator -- Documentation package
+# C->Haskell is an interface generator that simplifies the development
+# of Haskell bindings to C libraries. The tool processes existing C
+# header files that determine data layout and function signatures on
+# the C side in conjunction with Haskell modules that specify
+# Haskell-side type signatures and marshaling details. Hooks embedded
+# in the Haskell code signal access to C structures and functions --
+# they are expanded by the interfacing tool in dependence on
+# information from the corresponding C header file.
+# .
+# Haskell 98 is "the" standard lazy functional programming language.
+# More info plus the language definition is at http://www.haskell.org/.
+# .
+# This package contains documentation for c2hs.
Modified: packages/c2hs/trunk/debian/rules
URL: http://svn.debian.org/wsvn/pkg-haskell/packages/c2hs/trunk/debian/rules?rev=772&op=diff
==============================================================================
--- packages/c2hs/trunk/debian/rules (original)
+++ packages/c2hs/trunk/debian/rules Sun Sep 16 22:20:32 2007
@@ -97,8 +97,9 @@
dh_testdir
dh_testroot
dh_installchangelogs
+ dh_installdocs
dh_installexamples
- dh_installman
+ dh_installman debian/c2hs.1
dh_link
dh_strip
dh_compress
More information about the Pkg-haskell-commits
mailing list