.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_OCTAVE_MAKE 1"
.TH DH_OCTAVE_MAKE 1 2024-01-25 1.8.0 dh-octave
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_octave_make \- generate a Debian package from the sources of an Octave\-Forge package
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_octave_make\fR
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdh_octave_make\fR is a helper script for generating a first
version of a Debian package for an Octave-Forge package. The command should
be launched from the top directory of the unpacked sources of an
Octave-Forge package.  A file called \fIDESCRIPTION\fR must be present, from
which information about the package is gathered.  The following files
are generated with sensible contents, although they need further editing:
.IP debian/changelog 4
.IX Item "debian/changelog"
.PD 0
.IP debian/control 4
.IX Item "debian/control"
.IP debian/copyright 4
.IX Item "debian/copyright"
.IP debian/rules 4
.IX Item "debian/rules"
.IP debian/source/format 4
.IX Item "debian/source/format"
.IP debian/upstream/metadata 4
.IX Item "debian/upstream/metadata"
.IP debian/watch 4
.IX Item "debian/watch"
.IP deabin/gbp.conf 4
.IX Item "deabin/gbp.conf"
.PD
.PP
The files above are only created if they do not exist yet.  This allows
the use of \fBdh_octave_make\fR for updating an already
debianized source tree.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
The environment variables \fBDEBFULLNAME\fR and \fBDEBEMAIL\fR are used for
generating the identity of the developer, which will appear in
\&\fIdebian/changelog\fR and \fIdebian/copyright\fR. If they do not exist, \fBFULLNAME\fR
and \fBEMAIL\fR are used instead.
.SH DISCLAIMER
.IX Header "DISCLAIMER"
\&\fBdh_octave_make\fR is distributed in the hope that it will be useful,
but \fBwithout any warranty\fR; without even the implied warranty of
\&\fBmerchantability\fR or \fBfitness for a particular purpose\fR.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2012, 2017\-2021 Rafael Laboissière
.PP
This script is free software; you can redistribute it and/or
modify it under the terms of the GNU GPL, v3 or later.
.SH AUTHOR
.IX Header "AUTHOR"
Rafael Laboissière <rafael@debian.org>