1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92
|
'\" t
.\" Title: PERL-CROSS-DEBIAN
.\" Author: Neil Williams <codehelp@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\" Date: 12/02/2012
.\" Manual: perl-cross-debian User Manual
.\" Source: perl-cross-debian
.\" Language: English
.\"
.TH "PERL\-CROSS\-DEBIAN" "1" "12/02/2012" "perl-cross-debian" "perl-cross-debian User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
perl-cross-debian \- Long term maintenance of cross\-build support for the Debian configuration of perl
.SH "SYNOPSIS"
.HP \w'\fBperl\-cross\-debian\fR\ 'u
\fBperl\-cross\-debian\fR [\fB\-\-rootdir=\fR\fBDIRECTORY\fR] \fB\-\-variant=\fR\fB\fISTRING\fR\fR
.HP \w'\fBperl\-cross\-debian\fR\ 'u
\fBperl\-cross\-debian\fR [{\fB\-h\fR\ |\ \fB\-\-help\fR} | {\fB\-v\fR\ |\ \fB\-\-version\fR}]
.SH "DESCRIPTION"
.PP
\fBperl\-cross\-debian\fR
supports the long term maintenance of cross\-build support for the Debian configuration of perl\&.
.PP
\fBperl\-cross\-debian\fR
copies pre\-produced config files into the current perl build tree to prevent the build from needing to execute test binaries during the configuration stage by providing the values of the tests in advance\&.
\fBperl\-cross\-debian\fR
then extracts values from the cached files to update the build information and package Makefiles\&.
.SH "COMMAND"
.PP
\fB\-\-variant \fR\fB\fIVARIANT\fR\fR
.RS 4
Name of the current perl build variant (static, debug or shared), passed in via debian/rules, must be specified once for each iteration\&.
.RE
.SH "OPTIONS"
.PP
\fB\-\-rootdir \fR\fB\fIDIRECTORY\fR\fR
.RS 4
Debug support for testing with unreleased config files, uses the files from the rootdir instead of looking in the
/usr/share/perl\-cross\-debian/$(DEB_HOST_GNU_TYPE)/$(PERL_VERSION)
directory\&. ($(PERL_VERSION) in this instance is the output of
\fB/bin/bash debian/config\&.debian \-\-full\-version\fR\&.)
.RE
.PP
\fB\-?\fR, \fB\-h\fR, \fB\-\-help\fR, \fB\-\-version\fR
.RS 4
Show summary of options and the version information\&.
.RE
.SH "EXTENDING PERL-CROSS-DEBIAN"
.PP
\fBperl\-cross\-debian\fR
provides some POD documentation of how to extend support to new architectures and how to update existing support for new versions of perl\&.
.PP
See
/usr/share/doc/perl\-cross\-debian/converting\-native\&.pod
and
/usr/share/doc/perl\-cross\-debian/new\-arch\&.pod
.SH "AUTHOR"
.PP
\fBNeil Williams\fR <\&codehelp@debian\&.org\&>
.RS 4
Wrote this manpage for the Debian system\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2012 Neil Williams
.br
.PP
This manual page was written for the Debian system (and may be used by others)\&.
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\&.
.sp
|