.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . 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 .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "DH_CLIGACPOLICY 1" .TH DH_CLIGACPOLICY 1 "2019-03-11" "perl v5.28.1" "Debhelper for CLI (Common Language Infrastructure)" .\" 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_cligacpolicy \- creates and installs a CLI policy file for a package .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBdh_cligacpolicy\fR [\fIdebhelper\ options\fR] [\fB\-n\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" dh_cligacpolicy is a debhelper program that is responsible for creating, compiling, and installing policy files for a Debian package. This automatically includes postinst and prerm commands needed to install these policies into the system. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-n\fR, \fB\-\-noscripts\fR" 4 .IX Item "-n, --noscripts" Do not modify postinst/prerm scripts. .SH "FILE FORMAT" .IX Header "FILE FORMAT" This file uses the \fIdebian/cligacpolicy\fR files (either \&\fIpolicyassemblies\fR or \fIdebian/packagename.cligacpolicy\fR) to generate the policy file. It supports multiple versions of the policy, including mapping multiple versions to a single file. .PP The file format of the \fIcligacpolicy\fR file consists of five properties per line, each one separated by whitespace. .IP "\fBKeyfile\fR is a path, from the package root, to the .snk file used to sign the assembly." 4 .IX Item "Keyfile is a path, from the package root, to the .snk file used to sign the assembly." .PD 0 .IP "\fBAssembly\fR is the name of the assembly, without the .dll extension. For example, for log4net.dll, use \fIlog4net\fR." 4 .IX Item "Assembly is the name of the assembly, without the .dll extension. For example, for log4net.dll, use log4net." .IP "\fBVersion Range\fR can be a single four-part version, such as 1.2.3.4, or a full range, such as 1.2.3.4\-1.2.6.7. For a single line, the first two numbers must be identical. To have an assembly apply to multiple versions, such as 1.2.0.0 to 2.4.0.0, there needs to be one line for each version range." 4 .IX Item "Version Range can be a single four-part version, such as 1.2.3.4, or a full range, such as 1.2.3.4-1.2.6.7. For a single line, the first two numbers must be identical. To have an assembly apply to multiple versions, such as 1.2.0.0 to 2.4.0.0, there needs to be one line for each version range." .IP "\fBAssembly version\fR is the version of the assembly being =built." 4 .IX Item "Assembly version is the version of the assembly being =built." .IP "\fBPriority\fR defines the priority of the policy files. Typically, each version will increase the priority and contains all the policy controls for prior versions." 4 .IX Item "Priority defines the priority of the policy files. Typically, each version will increase the priority and contains all the policy controls for prior versions." .PD .PP The fields can be separated with spaces or tabs. Comments start the line with \fI#\fR characters and blank lines are ignored. .SH "NOTES" .IX Header "NOTES" Note that this command is not idempotent. \*(L"dh_prep\*(R" should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts. .SH "EXAMPLE" .IX Header "EXAMPLE" For the log4net 1.2.10.0 version, a policy file is used to map all versions from 1.2.8.0 to 1.2.9.99 into the current version. .PP debian/log4net.snk log4net 1.2.8.0\-1.2.9.99 1.2.10.0 10 .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBdebhelper\fR\|(7) .PP This program is a part of cli-common-dev. .SH "AUTHOR" .IX Header "AUTHOR" Dylan R. E. Moonfire