ul W a9 a b ` G b m r [pm. +kK(TO} zlp @>5O'ODBlb Sq" !_$b$I$,)?)++ -./G00823O456rY8Z8 ';4;h<;u;u<2<u<:==>K?q"@@AyA>RBBC?E>#FbG37HkI<$JaJ<0;Ҧ4<Ҫ*ЭݱM<_ֳ6|@չѺϻBP}|9-/-w /fP7uOemt4 lI?\SL`FcZVAJjo.R/K,'Enrp8g5M*]NDh >0b[6WqkYU1d-X$#3HBC_T< Q^( "+&@Ga!: 9=si;2% )* B I<...> B<"> specifies the behavior of B. See L.* B invokes B to create the Debianized source tree: I<< ../-/* >>* B with the B<--verbose> option produces a human readable report of B's execution.* If the directory name part of I has no parentheses, B<(> and B<)>, it is taken as verbatim.* Some parts of I may be in the regex match pattern surrounded between B<(> and B<)> such as B. (If multiple directories match, the highest version is picked.) Otherwise, the I is taken as verbatim.AUTHOR, COPYRIGHT, LICENSEAdd a trailing comma at the end of the sorted fields. This minimizes future differences in the VCS commits when additional dependencies are appended or removed.Adding/removing the B tag will add "team\@security.debian.org" to the Cc list of the control email.After executing this command, you will be sent a subscription confirmation to which you have to reply. When subscribed to a bug report, you receive all relevant emails and notifications. Use the unsubscribe command to unsubscribe.An error occurredB and B can be set in the environment to control the email address that the bugs are sent from.B was originally written as a shell script by Yann Dirson Edirson@debian.orgE and rewritten in Perl with many more features by Julian Gilbey Ejdg@debian.orgE. The software may be freely redistributed under the terms and conditions of the GNU General Public License, version 2.B was written and is copyright 2006 by Steinar H. Gunderson and modified by Julian Gilbey Ejdg@debian.orgE. The software may be freely redistributed under the terms and conditions of the GNU General Public License, version 2.B is a tool to aid in visualizing a Debian I. The changelogs are graphed with B(1) , with the X axis of the graph denoting time of release and the Y axis denoting the Debian version number of the package. Each individual release of the package is represented by a point, and the points are color coded to indicate who released that version of the package. The upstream version number of the package can also be labeled on the graph.B reads the watch options specified in B I<...> B<"> to customize its behavior. Multiple options I, I, I, ... can be set as BIB<,> IB<,> IB<,> I< ... >B<"> . The double quotes are necessary if options contain any spaces.B was written by Arno Töll and is licensed under the terms of the General Public License (GPL) version 2 or later.B: equivalent to B<--download>, newer upstream files will be downloaded. This is the default behavior.Both are released under the GNU General Public License, version 3 or later.Both are released under the ISC license.Both are released under the terms of the GNU General Public License, version 3.COPYRIGHT AND LICENSECUSTOMIZATIONChange the "owner" address of a I, with B meaning `use the address on the current email as the new owner address'.Change the submitter address of a I or a number of bugs, with B meaning `use the address on the current email as the new submitter address'.Copyright 2001 Bill Allombert Eballombe@debian.orgE. Modifications copyright 2002,2003 Julian Gilbey Ejdg@debian.orgE. B is free software, covered by the GNU General Public License, version 2 or (at your option) any later version, and you are welcome to change it and/or distribute copies of it under certain conditions. There is absolutely no warranty for B.Copyright 2017 Axel Beckert . Licensed under the GNU General Public License, version 2 or later.Discards access to SGML catalogs; some SGML tools read all the registered catalogs at startup. Files matching the regexp /usr/share/sgml/.*\e.cat are recognised as catalogs. Enabled by default.Display the bugs for the maintainer email address I.Display the bugs for the submitter email address I.Do not send emails but print them to standard output.Don't use B for sending of mails.Edit the generated commit message in your favorite editor before committing it.Email of the person acting on a given Debian package via devscripts.Enable colorized status output.Fill out the templates for each package and display them all for verification. This is the default behavior.Finalize the changelog for a release. Update the changelog timestamp. If the distribution is set to B, change it to the distribution from the previous changelog entry (or another distribution as specified by B<--distribution>). If there are no previous changelog entries and an explicit distribution has not been specified, B will be used (or the name of the current development release when run under Ubuntu).For a site which has funny version numbers, the parenthesized groups will be joined with B<.> (period) to make a sanitized version number.For basic usage, B is executed without any arguments from the root of the Debianized source tree where you see the F directory, or a directory containing multiple source trees.For compatibility with other tools such as B, it may not be wise to create custom scripts with random behavior. In general, B is the best choice for the non-native package and custom scripts, if created, should behave as if B. For possible use case, see L as an example.For example, if you want to tag what's checked into Subversion as version 1.0, you could use a command like this:Generate a package which only depends on build dependencies with the build profile(s), given as a comma-separated list. The default behavior is to use no specific profile. Setting this option will override the B environment variable.Generate or update a cache of bug reports for the given email address or package. By default it downloads all bugs belonging to the email address in the B environment variable (or the B environment variable if B is unset). This command may be repeated to cache bugs belonging to several people or packages. If multiple packages or addresses are supplied, bugs belonging to any of the arguments will be cached; those belonging to more than one of the arguments will only be downloaded once. The cached bugs are stored in F<$XDG_CACHE_HOME/devscripts/bts/> or, if B is not set, in F<~/.cache/devscripts/bts/>.Here, B option is used to normalize the sorting order of the directory names.If SMTPS not specified, B will still try to use STARTTLS if it's advertised by the SMTP host.If either B<--increment> or B<--newversion> is used, the name and email for the new version will be determined as follows. If the environment variable B is set, this will be used for the maintainer full name; if not, then B will be checked. If the environment variable B is set, this will be used for the email address. If this variable has the form "name EemailE", then the maintainer name will also be taken from here if neither B nor B is set. If this variable is not set, the same test is performed on the environment variable B. Next, if the full name has still not been determined, then use B(3) to determine the name from the password file. If this fails, use the previous changelog entry. For the email address, if it has not been set from B or B, then look in I, then attempt to build it from the username and FQDN, otherwise use the email address in the previous changelog entry. In other words, it's a good idea to set B and B when using this script.If nothing is specified, B will display your bugs, assuming that either B or B (examined in that order) is set to the appropriate email address.If one of these is set (with preference give to B), then this will be used for the subscription address. If neither is set, then the email will be sent without a specified subscription address, and the email's From: line will be used to determine the sender's address. This will be determined by B(1).If the B rule exists, the selected upstream tarball href is normalized by applying this rule to it. (This is useful for some sites with the obfuscated download URL.)If the B rule exists, the last upstream version is further normalized by applying this rule to it. For example, if the last upstream version is B<2.03+dfsg1> indicating the source tarball is repackaged, the suffix B<+dfsg1> is removed by the string substitution B to make the (dversionmangled) last upstream version B<2.03> and it is compared to the candidate upstream tarball versions such as B<2.03>, B<2.04>, ... found in the remote site. Thus, set this rule as:If the B rule exists, the whole downloaded web page as a string is normalized by applying this rule to it. This is very powerful tool and needs to be used with caution. If other mangling rules can be used to address your objective, do not use this rule.If the B rule exists, the candidate upstream versions are normalized by applying this rule to them. (This rule may be useful if the upstream version scheme doesn't sort correctly to identify the newest version.)If the current directory contains only a F directory (and possibly some dotfiles), unpack the orig tarball. This is the default behavior.If this is set, the From: line in the email will be set to use this email address instead of your normal email address (as would be determined by B).If this option is set, it is expected to contain the gpg key ID to pass to B(1) if the packages are to be remotely signed. You will be prompted to confirm whether you wish to sign the packages after all builds are complete. If this option is unset or an empty string, no attempt to sign packages will be made. It may be overridden on an I and I specific basis using the IB<_>IB<_SIGN_KEYID> option described below, or per-invocation with the B<--sign> command line option.If unset this defaults to IIf using the B (B<--no-mutt>) option, then the email to the BTS will be sent using the name and address in the environment variables B and B. If these are not set, then the variables B and B will be used instead. These can be overridden using the B<--from> option. The program will not work in this case if an email address cannot be determined.If you are upgrading from version 2, the key incompatibility is if you have multiple groups in the pattern part; whereas only the first one would be used in version 2, they will all be used in version 3. To avoid this behavior, change the non-version-number groups to be B<(?:> I< ...> B<)> instead of a plain B<(> I< ... > B<)> group.It creates the new upstream source tree under the I<< ../bar- >> directory and Debianize it leveraging the last package contents.It is also possible to include a comment in the mail sent to the BTS. If your shell does not strip out the comment in a command like "bts severity 30321 normal #inflated severity", then this program is smart enough to figure out where the comment is, and include it in the email. Note that most shells do strip out such comments before they get to the program, unless the comment is quoted. (Something like "bts severity #85942 normal" will not be treated as a comment!)It is licensed under the terms of the GPL, either version 2 of the License, or (at your option) any later version.It sometimes occurs that various files or directories are moved around between revisions. This can be handled using this option. There are two arguments, the first giving the location of the directory or file in the first package, and the second in the second. Any files in the first listing whose names begin with the first argument are treated as having that substituted for the second argument when the file lists are compared. Any number of B<--move> arguments may be given; they are processed in the order in which they appear. This only affects comparing binary packages, not source packages.July 3, 2010LICENSELike B, this manual page is released under the GNU General Public License, version 2 or later.Make B (with the appropriate extension) symlink to the downloaded files. (This is the default behavior.)Mark the I as forwarded to the given I
(usually an email address or a URL for an upstream bug tracker).Mention in the email that you require sponsorship.Modify the look-up behavior. This influences the interpretation of the I argument. Supported search types are:Normalize the candidate upstream version strings extracted from hrefs in the source of the web page. This is used as the version sorting index when selecting the latest upstream version.Normalize the directory path string matching the regex in a set of parentheses of BI as the sortable version index string. This is used as the directory path sorting index only.Normalize the downloaded web page string. (Don't use this unless this is absolutely needed. Generally, B flag is required for these I.)Normalize the last upstream version string found in F to compare it to the available upstream tarball version. Removal of the Debian specific suffix such as B is usually done here.Note that one of B<$DEBEMAIL> or B<$EMAIL> must be set in the environment in order to use B to send emails.Note that one of B<$DEBEMAIL> or B<$EMAIL> must be set in the environment in order to use direct SMTP connections to send emails.Note that when sending directly via an SMTP host, specifying addresses in B<--cc-addr> or B that the SMTP host will not relay will cause the SMTP host to reject the entire mail.On Debian systems, the complete text of the GNU General Public License can be found in I.Once the normalized PATH has been set, prepend I to it.Only check the directory name if we have had to change directory in our search for F, that is, the directory containing F is not the directory from which B was invoked. This is the default behavior.Options may be specified after the B command in addition to or instead of options at the start of the command line: recognised options at this point are: B<-o>/B<--offline>/B<--online>, B<-m>/B<--mbox>, B<--mailreader> and B<-->[B]B. These are described earlier in this manpage. If either the B<-o> or B<--offline> option is used, or there is already an up-to-date copy in the local cache, the cached version will be used.Patches are extracted to one of these directories. ``debian/patches/'' is preferred, if it exists. If I is present in the environment, it will override this behavior (see ``ENVIRONMENT VARIABLES'' section below).Permission is granted to copy, distribute and/or modify this document under the terms of the Artistic License: http://www.opensource.org/licenses/artistic-license.php. On Debian systems, the complete text of the Artistic License can be found in /usr/share/common-licenses/Artistic.Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.Please note that a local shallow copy of the git repository is made with "B ..." normally in the target directory. B generates the new upstream version with "B" on this local copy of repository as its default behavior.Please see L for more details on how to control the BTS using emails and L for more information about the BTS.Print debugging output to stderr (including url(s) fetched).Rationale: We need to be able to specify multiple browser commands so programs obeying this convention can do the right thing in either X or console environments, trying X first. Specifying multiple commands may also be useful for people who share files like F<.profile> across multiple systems. We need B<%s> because some popular browsers have remote-invocation syntax that requires it. Unless B<%%> reduces to %, it won't be possible to have a literal B<%s> in the string.Recreate signature, respectively use the existing signature, if the file has been signed already. If neither option is given and an already signed file is found the user is asked if he or she likes to use the current signature.Same as above, but use a full name instead.Send carbon copies to a list of users. I should be a comma-separated list of email addresses. Multiple options add more CCs.Some file extensions are not included in the above intentionally to avoid false positives. You can still set such file extension patterns manually.Some options affect the behaviour of the B command. The first is the setting of B<--cache-mode>, which controls how much B downloads of the referenced links from the bug page, including boring bits such as the acknowledgement emails, emails to the control bot, and the mbox version of the bug report. It can take three values: B (the minimum), B (download the minimum plus the mbox version of the bug report) or B (the whole works). The second is B<--force-refresh> or B<-f>, which forces the download, even if the cached bug report is up-to-date. The B<--include-resolved> option indicates whether bug reports marked as resolved should be downloaded during caching.Subscribe the given I address to the specified I report. If no email address is specified, the environment variable B or B (in that order) is used. If those are not set, or B is given as email address, your default address will be used.The current version 4 format of F can be summarized as follows:The default behavior is to unpack the orig tarball if the current directory is empty except for a F directory and the VCS files mentioned above.The default maintainer, email or package to grep for if none is specified on the command line.The desired browser can be specified and configured by setting the B environment variable. The conventions follow those defined by Eric Raymond at http://www.catb.org/~esr/BROWSER/; we here reproduce the relevant part.The two configuration files F and F<~/.devscripts> are sourced by a shell in that order to set configuration variables. These may be overridden by command line options. Environment variable settings are ignored for this purpose. If the first command line option given is B<--noconf>, then these files will not be read. The currently recognized variables are:The upstream tarball href corresponding to the newest (uversionmangled) candidate upstream version newer than the (dversionmangled) last upstream version is selected.This allows you to insert B(1) commands into the gnuplot script that is used to generate the graph. The commands are placed after all initialization but before the final B command. This can be used to override the default look provided by this program in arbitrary ways. You can also use things like "set terminal png color" to change the output file type, which is useful in conjunction with the -s option.This code is copyright by Joey Hess , all rights reserved. This program comes with ABSOLUTELY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public License, version 2 or later.This code is copyright by Patrick Schoenfeld , all rights reserved. This program comes with ABSOLUTELEY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public License, version 2 or later.This indicates that the executable was built in such a way (PIE) that the "text" section of the program can be relocated in memory. To take full advantage of this feature, the executing kernel must support text Address Space Layout Randomization (ASLR).This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.This program comes with ABSOLUTELY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public License, version 2 or later.This program is Copyright (C) 2007 by Sune Vuorela . It was modified by Adam D. Barratt for the devscripts package. This program comes with ABSOLUTELY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public License, version 2 or later.This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 or later.This program is licensed under the terms of the GPL, either version 2 of the License, or (at your option) any later version.Unless an explicit version number is provided, the archive name is analyzed for a sequence of digits separated by dots. If something like that is found, it is taken to be the new upstream version number. If not, processing is aborted.Unless an explicit version number is provided, the patch file name is analyzed for a sequence of digits separated by dots. If something like that is found, it is taken to be the new upstream version number. If not, processing is aborted.Unpack the downloaded orig tarball to the current directory, replacing everything except the debian directory. Existing files are removed, except for F and VCS files. Preserved are: F<.bzr>, F<.bzrignore>, F<.bzr-builddeb>, F<.git>, F<.gitignore>, F<.hg>, F<.hgignore>, F<_darcs> and F<.svn>.Unsubscribe the given email address from the specified bug report. As with subscribe above, if no email address is specified, the environment variables B or B (in that order) is used. If those are not set, or B is given as email address, your default address will be used.Use maintainer details from the I B field rather than relevant environment variables (B, B, etc.). This option might be useful to restore details of the main maintainer in the changelog trailer after a bogus edit (e.g. when B<-m> was intended but forgot) or when releasing a package in the name of the main maintainer (e.g. the team).When running a B command, should we only mirror the basic bug (B), or should we also mirror the mbox version (B), or should we mirror the whole thing, including the mbox and the boring attachments to the BTS bug pages and the acknowledgement emails (B)? Default is B.You should have received a copy of the GNU General Public License along with this program. If not, see L.where 0x12345678 is replaced by your GPG key ID or other key identifier such as your email address. Again, you could also use the B configuration file option as described above to avoid having to type the B<-k> option each time you do a sponsored upload.Project-Id-Version: devscripts Report-Msgid-Bugs-To: FULL NAME PO-Revision-Date: 2022-04-12 19:34+0000 Last-Translator: Anthony Harrington Language-Team: English (United Kingdom) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Launchpad-Export-Date: 2024-09-02 19:02+0000 X-Generator: Launchpad (build 1b1ed1ad2dbfc71ee62b5c5491c975135a771bf0) * B I<...> B<"> specifies the behaviour of B. See L.* B invokes B to create the Debianised source tree: I<< ../-/* >>* B with the B<--verbose> option produces a human-readable report of B's execution.* If the directory name part of I has no parentheses, B<(> and B<)>, it is taken verbatim.* Some parts of I may be in the regex match pattern surrounded between B<(> and B<)> such as B. (If multiple directories match, the highest version is picked.) Otherwise, the I is taken verbatim.AUTHOR, COPYRIGHT, LICENCEAdd a trailing comma at the end of the sorted fields. This minimises future differences in the VCS commits when additional dependencies are appended or removed.Adding/removing the B tag will add "team\@security.debian.org" to the CC list of the control e-mail.After executing this command, you will be sent a subscription confirmation to which you have to reply. When subscribed to a bug report, you receive all relevant e-mails and notifications. Use the unsubscribe command to unsubscribe.An error occurred.B and B can be set in the environment to control the e-mail address that the bugs are sent from.B was originally written as a shell script by Yann Dirson Edirson@debian.orgE and rewritten in Perl with many more features by Julian Gilbey Ejdg@debian.orgE. The software may be freely redistributed under the terms and conditions of the GNU General Public Licence, version 2.B was written and is copyright 2006 by Steinar H. Gunderson and modified by Julian Gilbey Ejdg@debian.orgE. The software may be freely redistributed under the terms and conditions of the GNU General Public Licence, version 2.B is a tool to aid in visualising a Debian I. The changelogs are graphed with B(1) , with the X axis of the graph denoting time of release and the Y axis denoting the Debian version number of the package. Each individual release of the package is represented by a point, and the points are color coded to indicate who released that version of the package. The upstream version number of the package can also be labelled on the graph.B reads the watch options specified in B I<...> B<"> to customise its behaviour. Multiple options I, I, I, ... can be set as BIB<,> IB<,> IB<,> I< ... >B<"> . The double quotes are necessary if options contain any spaces.B was written by Arno Töll and is licensed under the terms of the General Public Licence (GPL) version 2 or later.B: equivalent to B<--download>, newer upstream files will be downloaded. This is the default behaviour.Both are released under the GNU General Public Licence, version 3 or later.Both are released under the ISC licence.Both are released under the terms of the GNU General Public Licence, version 3.COPYRIGHT AND LICENCECUSTOMISATIONChange the "owner" address of a I, with B meaning `use the address on the current e-mail as the new owner address'.Change the submitter address of a I or a number of bugs, with B meaning `use the address on the current e-mail as the new submitter address'.Copyright 2001 Bill Allombert Eballombe@debian.orgE. Modifications copyright 2002,2003 Julian Gilbey Ejdg@debian.orgE. B is free software, covered by the GNU General Public Licence, version 2 or (at your option) any later version, and you are welcome to change it and/or distribute copies of it under certain conditions. There is absolutely no warranty for B.Copyright 2017 Axel Beckert . Licensed under the GNU General Public Licence, version 2 or later.Discards access to SGML catalogues; some SGML tools read all the registered catalogues at startup. Files matching the regexp /usr/share/sgml/.*\e.cat are recognised as catalogues. Enabled by default.Display the bugs for the maintainer e-mail address I.Display the bugs for the submitter e-mail address I.Do not send e-mails but print them to standard output.Don't use B for sending mail.Edit the generated commit message in your favourite editor before committing it.E-mail of the person acting on a given Debian package via devscripts.Enable colourised status output.Fill out the templates for each package and display them all for verification. This is the default behaviour.Finalise the changelog for a release. Update the changelog timestamp. If the distribution is set to B, change it to the distribution from the previous changelog entry (or another distribution as specified by B<--distribution>). If there are no previous changelog entries and an explicit distribution has not been specified, B will be used (or the name of the current development release when run under Ubuntu).For a site which has funny version numbers, the parenthesised groups will be joined with B<.> (period) to make a sanitised version number.For basic usage, B is executed without any arguments from the root of the Debianised source tree where you see the F directory, or a directory containing multiple source trees.For compatibility with other tools such as B, it may not be wise to create custom scripts with random behaviour. In general, B is the best choice for the non-native package and custom scripts, if created, should behave as if B. For possible use case, see L as an example.For example, if you want to tag what is checked into Subversion as version 1.0, you could use a command like this:Generate a package which only depends on build dependencies with the build profile(s), given as a comma-separated list. The default behaviour is to use no specific profile. Setting this option will override the B environment variable.Generate or update a cache of bug reports for the given e-mail address or package. By default, it downloads all bugs belonging to the e-mail address in the B environment variable (or the B environment variable if B is unset). This command may be repeated to cache bugs belonging to several people or packages. If multiple packages or addresses are supplied, bugs belonging to any of the arguments will be cached; those belonging to more than one of the arguments will only be downloaded once. The cached bugs are stored in F<$XDG_CACHE_HOME/devscripts/bts/> or, if B is not set, in F<~/.cache/devscripts/bts/>.Here, B option is used to normalise the sorting order of the directory names.If SMTPS is not specified, B will still try to use STARTTLS if it's advertised by the SMTP host.If either B<--increment> or B<--newversion> is used, the name and e-mail for the new version will be determined as follows. If the environment variable B is set, this will be used for the maintainer full name; if not, then B will be checked. If the environment variable B is set, this will be used for the e-mail address. If this variable has the form "name EemailE", then the maintainer name will also be taken from here if neither B nor B is set. If this variable is not set, the same test is performed on the environment variable B. Next, if the full name has still not been determined, then use B(3) to determine the name from the password file. If this fails, use the previous changelog entry. For the e-mail address, if it has not been set from B or B, then look in I, then attempt to build it from the username and FQDN, otherwise use the e-mail address in the previous changelog entry. In other words, it's a good idea to set B and B when using this script.If nothing is specified, B will display your bugs, assuming that either B or B (examined in that order) is set to the appropriate e-mail address.If one of these is set (with preference give to B), then this will be used for the subscription address. If neither is set, then the e-mail will be sent without a specified subscription address, and the e-mail's From: line will be used to determine the sender's address. This will be determined by B(1).If the B rule exists, the selected upstream tarball href is normalised by applying this rule to it. (This is useful for some sites with an obfuscated download URL.)If the B rule exists, the last upstream version is further normalised by applying this rule to it. For example, if the last upstream version is B<2.03+dfsg1> indicating the source tarball is repackaged, the suffix B<+dfsg1> is removed by the string substitution B to make the (dversionmangled) last upstream version B<2.03> and it is compared to the candidate upstream tarball versions such as B<2.03>, B<2.04>, ... found in the remote site. Thus, set this rule as:If the B rule exists, the whole downloaded web page as a string is normalised by applying this rule to it. This is very powerful tool and needs to be used with caution. If other mangling rules can be used to address your objective, do not use this rule.If the B rule exists, the candidate upstream versions are normalised by applying this rule to them. (This rule may be useful if the upstream version scheme doesn't sort correctly to identify the newest version.)If the current directory contains only a F directory (and possibly some dotfiles), unpack the orig tarball. This is the default behaviour.If this is set, the From: line in the e-mail will be set to use this e-mail address instead of your normal e-mail address (as would be determined by B).If this option is set, it is expected to contain the GPG key ID to pass to B(1) if the packages are to be remotely signed. You will be prompted to confirm whether you wish to sign the packages after all builds are complete. If this option is unset or an empty string, no attempt to sign packages will be made. It may be overridden on an I and I specific basis using the IB<_>IB<_SIGN_KEYID> option described below, or per-invocation with the B<--sign> command line option.If unset, this defaults to IIf using the B (B<--no-mutt>) option, then the e-mail to the BTS will be sent using the name and address in the environment variables B and B. If these are not set, then the variables B and B will be used instead. These can be overridden using the B<--from> option. The program will not work in this case if an e-mail address cannot be determined.If you are upgrading from version 2, the key incompatibility is if you have multiple groups in the pattern part: whilst only the first one would be used in version 2, they will all be used in version 3. To avoid this behaviour, change the non-version-number groups to be B<(?:> I< ...> B<)> instead of a plain B<(> I< ... > B<)> group.It creates the new upstream source tree under the I<< ../bar- >> directory and Debianises it, leveraging the latest package contents.It is also possible to include a comment in the mail sent to the BTS. If your shell does not strip out the comment in a command like "bts severity 30321 normal #inflated severity", then this program is smart enough to figure out where the comment is, and include it in the e-mail. Note that most shells do strip out such comments before they get to the program, unless the comment is quoted. (Something like "bts severity #85942 normal" will not be treated as a comment!)It is licensed under the terms of the GPL, either version 2 of the Licence, or (at your option) any later version.It is sometimes that case that various files or directories are moved around between revisions. This can be handled using this option. There are two arguments, the first giving the location of the directory or file in the first package, and the second in the second. Any files in the first listing whose names begin with the first argument are treated as having that substituted for the second argument when the file lists are compared. Any number of B<--move> arguments may be given; they are processed in the order in which they appear. This only affects comparing binary packages, not source packages.3 July 2010LICENCELike B, this manual page is released under the GNU General Public Licence, version 2 or later.Make B (with the appropriate extension) symlink to the downloaded files. (This is the default behaviour.)Mark the I as forwarded to the given I
(usually an e-mail address or a URL for an upstream bug tracker).Mention in the e-mail that you require sponsorship.Modify the look-up behaviour. This influences the interpretation of the I argument. Supported search types are:Normalise the candidate upstream version strings extracted from hrefs in the source of the web page. This is used as the version sorting index when selecting the latest upstream version.Normalise the directory path string matching the regex in a set of parentheses of BI as the sortable version index string. This is used as the directory path sorting index only.Normalise the downloaded web page string. (Don't use this unless this is absolutely needed. Generally, B flag is required for these I.)Normalise the last upstream version string found in F to compare it to the available upstream tarball version. Removal of the Debian specific suffix such as B is usually done here.Note that one of B<$DEBEMAIL> or B<$EMAIL> must be set in the environment, in order to use B to send e-mails.Note that one of B<$DEBEMAIL> or B<$EMAIL> must be set in the environment, in order to use direct SMTP connections to send e-mails.Note that when sending directly via an SMTP host, specifying addresses in B<--cc-addr> or B that the SMTP host will not relay, will cause the SMTP host to reject the entire mail.On Debian systems, the complete text of the GNU General Public Licence can be found in I.Once the normalised PATH has been set, prepend I to it.Only check the directory name if we have had to change directory in our search for F, that is, the directory containing F is not the directory from which B was invoked. This is the default behaviour.Options may be specified after the B command in addition to, or instead of, options at the start of the command line. Recognised options at this point are: B<-o>/B<--offline>/B<--online>, B<-m>/B<--mbox>, B<--mailreader> and B<-->[B]B. These are described earlier in this manpage. If either the B<-o> or B<--offline> option is used, or there is already an up-to-date copy in the local cache, the cached version will be used.Patches are extracted to one of these directories. ``debian/patches/'' is preferred, if it exists. If I is present in the environment, it will override this behaviour (see ``ENVIRONMENT VARIABLES'' section below).Permission is granted to copy, distribute and/or modify this document under the terms of the Artistic Licence: https://opensource.org/licenses/artistic-license.php. On Debian systems, the complete text of the Artistic Licence can be found in /usr/share/common-licenses/Artistic.Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public Licence, Version 3 or (at your option) any later version published by the Free Software Foundation.Please note that a local shallow copy of the git repository is made with "B ..." normally in the target directory. B generates the new upstream version with "B" on this local copy of repository as its default behaviour.Please see L for more details on how to control the BTS using e-mails and L for more information about the BTS.Print debugging output to stderr (including URL(s) fetched).Rationale: We need to be able to specify multiple browser commands, so programs obeying this convention can do the right thing in either X or console environments, trying X first. Specifying multiple commands may also be useful for people who share files like F<.profile> across multiple systems. We need B<%s> because some popular browsers have remote-invocation syntax that requires it. Unless B<%%> reduces to %, it won't be possible to have a literal B<%s> in the string.Recreate signature, respectively use the existing signature, if the file has been signed already. If neither option is given and an already signed file is found the user is asked if they would like to use the current signature.Same as above, but use a fullname instead.Send carbon copies to a list of users. I should be a comma-separated list of e-mail addresses. Multiple options add more CCs.Some file extensions are not included in the above intentionally to avoid false positives. You can still set such file extension patterns manually.Some options affect the behaviour of the B command. The first is the setting of B<--cache-mode>, which controls how much B downloads of the referenced links from the bug page, including boring bits such as the acknowledgement e-mails, e-mails to the control bot, and the mbox version of the bug report. It can take three values: B (the minimum), B (download the minimum plus the mbox version of the bug report) or B (the whole works). The second is B<--force-refresh> or B<-f>, which forces the download, even if the cached bug report is up-to-date. The B<--include-resolved> option indicates whether bug reports marked as resolved should be downloaded during caching.Subscribe the given I address to the specified I report. If no e-mail address is specified, the environment variable B or B (in that order) is used. If those are not set, or B is given as e-mail address, your default address will be used.The current version 4 format of F can be summarised as follows:The default behaviour is to unpack the orig tarball if the current directory is empty except for a F directory and the VCS files mentioned above.The default maintainer, e-mail or package to grep for if none is specified on the command line.The desired browser can be specified and configured by setting the B environment variable. The conventions follow those defined by Eric Raymond at http://www.catb.org/~esr/BROWSER/; here, we reproduce the relevant part.The two configuration files F and F<~/.devscripts> are sourced by a shell in that order to set configuration variables. These may be overridden by command line options. Environment variable settings are ignored for this purpose. If the first command line option given is B<--noconf>, then these files will not be read. The currently recognised variables are:The upstream tarball href corresponding to the newest (uversionmangled) candidate upstream version newer than the (dversionmangled) last upstream version is selected.This allows you to insert B(1) commands into the gnuplot script that is used to generate the graph. The commands are placed after all initialisation but before the final B command. This can be used to override the default look provided by this program in arbitrary ways. You can also use things like "set terminal png color" to change the output file type, which is useful in conjunction with the -s option.This code is copyright by Joey Hess , all rights reserved. This program comes with ABSOLUTELY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public Licence, version 2 or later.This code is copyright by Patrick Schoenfeld , all rights reserved. This program comes with ABSOLUTELEY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public Licence, version 2 or later.This indicates that the executable was built in such a way (PIE) that the "text" section of the program can be relocated in memory. To take full advantage of this feature, the executing kernel must support text Address Space Layout Randomisation (ASLR).This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public Licence as published by the Free Software Foundation; either version 2, or (at your option) any later version.This program comes with ABSOLUTELY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public Licence, version 2 or later.This program is Copyright (C) 2007 by Sune Vuorela . It was modified by Adam D. Barratt for the devscripts package. This program comes with ABSOLUTELY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public Licence, version 2 or later.This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public Licence for more details.This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public Licence as published by the Free Software Foundation; version 2 or later.This program is licensed under the terms of the GPL, either version 2 of the Licence, or (at your option) any later version.Unless an explicit version number is provided, the archive name is analysed for a sequence of digits separated by dots. If something like that is found, it is taken to be the new upstream version number. If not, processing is aborted.Unless an explicit version number is provided, the patch file name is analysed for a sequence of digits separated by dots. If something like that is found, it is taken to be the new upstream version number. If not, processing is aborted.Unpack the downloaded orig tarball to the current directory, replacing everything except the Debian directory. Existing files are removed, except for F and VCS files. Preserved are: F<.bzr>, F<.bzrignore>, F<.bzr-builddeb>, F<.git>, F<.gitignore>, F<.hg>, F<.hgignore>, F<_darcs> and F<.svn>.Unsubscribe the given email address from the specified bug report. As with subscribe above, if no e-mail address is specified, one of the environment variables B or B (in that order) is used. If those are not set, or B is given as e-mail address, your default address will be used.Use maintainer details from the I B field rather than relevant environment variables (B, B, etc.). This option might be useful to restore details of the main maintainer in the changelog trailer after a bogus edit (e.g. when B<-m> was intended but forgotten) or when releasing a package in the name of the main maintainer (e.g. the team).When running a B command, should we only mirror the basic bug (B), or should we also mirror the mbox version (B); or should we mirror the whole thing, including the mbox and the boring attachments to the BTS bug pages and the acknowledgement e-mails (B)? Default is B.You should have received a copy of the GNU General Public Licence along with this program. If not, see L.where 0x12345678 is replaced by your GPG key ID or other key identifier such as your e-mail address. Again, you could also use the B configuration file option as described above to avoid having to type the B<-k> option each time you do a sponsored upload.