summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2019-10-12build: Bump minimal Perl version to 5.24.1Guillem Jover1-2/+2
The Perl version in Debian stretch is 5.24.1, which is the release that will be oldstable once 1.20.x gets uploaded to Debian unstable.
2019-06-03doc: Clarify R³ specificationGuillem Jover1-9/+10
Expand what the builder means. Mention the dpkg-deb option to use to set the owner and group to root. And reword the prototyping section to be less confusing with what is currently implemented. Closes: #929019
2019-01-15doc: Update Doxygen configuration from version 1.8.13Guillem Jover1-16/+73
2018-09-18perl: Replace all calls to Cwd::cwd with Cwd::getcwdJosh Triplett1-1/+1
The former calls /bin/pwd, while the latter uses the getcwd() syscall directly. Signed-off-by: Guillem Jover <guillem@debian.org>
2018-08-30Fix some typosGuillem Jover1-1/+1
Thanks-to: Niels Thykier <niels@thykier.net> (for typo in dpkg(1))
2018-05-04libdpkg: Introduce frontend lockingJulian Andres Klode1-11/+11
Currently, in order to run dpkg, frontends have to release the database lock before invoking dpkg and re-acquire it afterwards, leaving a short time where the database is unlocked and a different dpkg process or frontend could lock it. Frontend locking addresses the problem by creating a "lock-frontend" file that is acquired by the frontend and not released for dpkg invocations. Thus, multiple frontends cannot race for the database lock. This change extends the frontend lock to dpkg itself, acquiring it whenever the variable DPKG_FRONTEND_LOCKED is not set, so that a user manually running dpkg or a frontend not supporting this protocol cannot interfere with a currently running frontend. [guillem@debian.org: - Add documentation. - Rename frontend lock file. - Fix error strings. ] Signed-off-by: Guillem Jover <guillem@debian.org>
2018-01-16spec/R³: Declare specification as recommendation, stableGuillem Jover1-1/+2
2018-01-16spec/R³: Add new DEB_RULES_REQUIRES_ROOT variableGuillem Jover1-0/+9
This variable is set by the builder to notify debian/rules that it supports this specification. Wordsmithing-by: Niels Thykier <niels@thykier.net>
2018-01-16spec/R³: The DEB_GAIN_ROOT_CMD should preserve the environmentGuillem Jover1-1/+2
Proposed-by: Josh Triplett <josh@joshtriplett.org>
2018-01-16spec/R³: Rename DPKG_GAIN_ROOT_CMD to DEB_GAIN_ROOT_CMDGuillem Jover1-5/+9
This variable should not be dpkg specific, as it is supposed to be set by any builder driving the package build, and not just dpkg itself. Introduce ephemereal backwards compatibility by mapping the old name to the new one, even thught there are no known users.
2017-10-22doc: Fix typo in a dateGuillem Jover1-1/+1
2017-09-24doc: Add new rootless builds experimental draft specificationNiels Thykier1-0/+161
[guillem@debian.org: - Mark the spec as an experimental draft. - Add new Background section. - Rename Package-Creation-Requires-Root to Rules-Requires-Root. - Rename dpkg/rules-requires-root to dpkg/target-subcommand. - Add new dpkg/target/<target-name> keyword. - Use dpkg-deb --build instead of dpkg --build. - Fix DPKG_GAIN_ROOT_CMD invocation, and denote it as the one to use instead of the alternative wrapper command. - Rearrange sections and reflow text. ] Signed-off-by: Guillem Jover <guillem@debian.org>
2017-05-19doc: Bump minimal Perl version to 5.20.2Guillem Jover1-2/+2
The Perl version in Debian jessie is 5.20.2, which is the release that will be oldstable once 1.19.x gets uploaded to Debian unstable.
2017-05-06doc: Spelling fixesJosh Soref1-1/+1
Signed-off-by: Guillem Jover <guillem@debian.org>
2017-01-22doc: Fix typos in documentation and code commentsGuillem Jover1-1/+1
Warned-by: codespell, spellintian
2016-10-30dpkg: Remove obsolete --print-installation-architecture optionGuillem Jover1-8/+8
2016-10-30dpkg-deb: Remove obsolete --old and --new optionsGuillem Jover1-9/+9
2016-10-30dpkg-deb: Obsolete bzip2 and lzma compression methodsGuillem Jover1-21/+21
2016-10-30Dpkg::Substvars: Obsolete Source-Version substvarGuillem Jover1-8/+10
Emit an error when the source package uses this substvar.
2016-10-29doc, man: Fix typosJakub Wilk2-3/+3
Closes: #834584 Warned-by: mwic, anorack Signed-off-by: Guillem Jover <guillem@debian.org>
2016-10-29doc: Update custom changelog parser API support status in README.apiGuillem Jover1-10/+4
2016-10-29build: Print an actual newline instead of a literal \n in lcov outputGuillem Jover1-1/+1
2016-10-29build: Fix M4sh/Autoconf coding styleGuillem Jover1-0/+54
Indent the code in a way that makes it easier to follow. Use AS_IF instead of shell constructs. Quote all autoconf macro arguments. Add a new section to coding-style.txt describing M4sh/Autoconf.
2016-07-03scripts: Replace changelog program parsers with perl modulesGuillem Jover1-0/+25
Using programs to implement the custom changelog parsers was very inefficient as it required to parse the custom changelog, output deb822 formatted entries to then parse that and output again with the desired format. These were implemented as programs because at the time the perl code in dpkg was not using perl modules, so it was not easy to extend. Using perl modules now is cleaner and allows for a faster implementation. In addition there's no known users in Debian, so it was deemed safe to remove the support without a transition.
2016-02-08doc: Update coding styleGuillem Jover1-11/+39
Add a new section for troff style. Add a subsection for C++ extensions. Update perl style to mention that the development checks need to pass, that private modules can use POD but need to be marked as such, and to update indentation and alignment to use soft tabs only.
2015-12-28doc, man: Remove Debian specific policy referencesGuillem Jover1-3/+3
Debian, although a primary one, is just one of the many "downstreams", and dpkg should document everything it implements, so adding references to the Debian policy makes it more confusing for people that use dpkg in non-Debian systems.
2015-12-12build: Add an configure option to choose the kind of documentationGuillem Jover1-3/+3
The option --disable-devel-docs can be used to override the current default, which is to build development documentation.
2015-12-12doc: Update test suite directory in Doxygen configurationGuillem Jover1-1/+1
2015-12-12doc: Update Doxygen configuration from version 1.8.9.1Guillem Jover1-103/+135
2015-05-30doc: Bump minimal Perl version to 5.14.2Guillem Jover1-2/+2
The current version in Debian oldstable (wheezy) is 5.14.2.
2015-02-11doc: Bump DOT_GRAPH_MAX_NODES from 50 to 100Guillem Jover1-1/+1
This avoids doxygen truncating the graphs due to too many nodes, and the accompanying warnings.
2015-01-28build: Rename perl scripts to have a .pl extensionGuillem Jover1-1/+1
This allows to easily replace the shebang at installation time to use the system perl interpreter and will make it easier to analyze all perl scripts in the source tree.
2014-10-25doc: Update features removal scheduleGuillem Jover1-10/+1
- The -u, --udeb dpkg-scanpackages options got removed, state that. - Remove the entry about obsolete fields, as these need to be preserved for backward compatibility, they are part of the external interface to be able to handle ancient binary packages.
2014-10-06doc: Do not add timestamps to Doxygen outputGuillem Jover1-1/+1
The API documentation is not shipped in any binary packages but it might in the future. Given that it already contains the project version down to a git commit if necessary and the Doxygen version, there's really no need for the timestamp.
2014-10-06doc: Update Doxygen configuration from version 1.8.8Guillem Jover1-943/+1405
This gets rid of some warnings due to deprecated options.
2014-05-28doc: Uppercase enum values in C coding styleGuillem Jover1-2/+2
2014-05-17build: Fix lcov-inject to consider different coverage percentagesGuillem Jover1-16/+45
The current code was not taking into account the different coverage ranges, with their different colors, and different images for the completion bar. Refactor the code into functions, while we are at it.
2014-05-07build: Do not use lcov-inject first argument as target directoryGuillem Jover1-1/+1
All arguments are files to modify.
2014-04-26build: Stop using a local lcov-prolog templateGuillem Jover1-8/+0
Newer lcov versions already produce UTF-8 encoded output, so there's no need to use our local html prolog. Ref: #590562
2014-04-26build: Inject a Perl coverage index entry into the lcov reportGuillem Jover2-8/+70
Add correct summary values, create a percentage bar, and remove the lcov-epilog template, which was being inserted in every and each generated lcov html file, not just the indices. The injection should be considered fragile, as it depends on the input report not changing its structure. But this is no worse than using the local prolog and epilog html templates.
2014-04-21dpkg-deb: Deprecate compressing .deb files with bzip2Guillem Jover1-0/+11
This compressor has been superseded by xz when it comes to compression ratio, and in cases where higher compatibility or raw speed is desired gzip is still the better option. Issue a warning for now for the -Zbzip2 option value, the support for that value will get disabled at a later point.
2014-04-21build: Test for required compound literalsGuillem Jover1-1/+2
And clarify the comment on the designated initializers.
2014-04-21dpkg-query(1): Document the --control-path life expectancyGuillem Jover1-1/+3
There's still at least one scenario that can only be covered by --control-path, and as long as that's the case the command will not get removed. Ref: #699647
2013-12-17doc: Clear DOT_FONTNAMEGuillem Jover1-1/+1
doxygen now produces a warning, let's use the default instead.
2013-12-07Use https:// URLs instead of http:// when possibleGuillem Jover1-3/+3
2013-10-14doc: Update Doxygen configuration from version 1.8.4Guillem Jover1-49/+70
This gets rid of some warnings due to deprecated options.
2013-06-03doc: Switch from png to svg for graph imagesGuillem Jover1-1/+1
This substantially reduces the image sizes.
2013-04-19doc: Bump minimal perl version to use to 5.10.0Guillem Jover1-2/+2
The current version in Debian oldstable (lenny) is already 5.10.0, once the current Debian stable release becomes oldstable (squeeze) it will be 5.10.1, so bumping it is pretty safe and conservative.
2013-04-14dpkg-deb: Add new --deb-format option and base --new and --old on itGuillem Jover1-0/+9
The named options are not future-proof, as they will not allow to easily create packages with specific formats once a future new version gets introduced. The new option will also allow to request specific minor revision of a major format, for testing purposes for example. This also makes the code more explicit as it now refers to specific format versions when building it.
2013-04-01Do not pass -e in shell script shebangs, set it in the bodyGuillem Jover1-1/+2
This guarantees that the -e option will be set even if the script is invoked as an argument to sh. Warned-by: lintian