<feed xmlns='http://www.w3.org/2005/Atom'>
<title>apt/doc/CMakeLists.txt, branch 2.9.1</title>
<subtitle>Debians commandline package manager</subtitle>
<id>https://git.kalnischkies.de/apt/atom?h=2.9.1</id>
<link rel='self' href='https://git.kalnischkies.de/apt/atom?h=2.9.1'/>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/'/>
<updated>2022-05-07T08:45:44Z</updated>
<entry>
<title>Avoid building all docs in nodoc build profile</title>
<updated>2022-05-07T08:45:44Z</updated>
<author>
<name>David Kalnischkies</name>
<email>david@kalnischkies.de</email>
</author>
<published>2022-04-19T11:06:44Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=cd92098caa64b7fd30cdc6b5d56bf7e9e17a449e'/>
<id>urn:sha1:cd92098caa64b7fd30cdc6b5d56bf7e9e17a449e</id>
<content type='text'>
Differentiating between different types of documentation we build helps
in better expressing what needs to be done for our arch:any and arch:all
packages currently as well.
</content>
</entry>
<entry>
<title>doc: Add apt-patterns(7) manual page</title>
<updated>2019-08-15T18:21:31Z</updated>
<author>
<name>Julian Andres Klode</name>
<email>julian.klode@canonical.com</email>
</author>
<published>2019-08-15T09:19:20Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=7e22425c2cf937fd45160c6bbbda9210ea5d52ba'/>
<id>urn:sha1:7e22425c2cf937fd45160c6bbbda9210ea5d52ba</id>
<content type='text'>
This does not describe much yet, as there's not much to talk
about.
</content>
</entry>
<entry>
<title>add apt-transport-mirror manpage</title>
<updated>2018-01-03T18:42:45Z</updated>
<author>
<name>David Kalnischkies</name>
<email>david@kalnischkies.de</email>
</author>
<published>2017-12-09T11:32:32Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=e4ed47f10844cf7ad933f7a9b64583869592f139'/>
<id>urn:sha1:e4ed47f10844cf7ad933f7a9b64583869592f139</id>
<content type='text'>
The mirror method is undocumented since 0.7.24, now with the
reimplementation it is high time to get something written about it.
</content>
</entry>
<entry>
<title>document https options in new apt-transport-https manpage</title>
<updated>2018-01-03T17:55:41Z</updated>
<author>
<name>David Kalnischkies</name>
<email>david@kalnischkies.de</email>
</author>
<published>2017-11-22T23:58:00Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=c28682430a27f75ceb8cc8dff78b3a560fd68399'/>
<id>urn:sha1:c28682430a27f75ceb8cc8dff78b3a560fd68399</id>
<content type='text'>
Same reasoning as with the previous commit for http with the added
benefit of moving the hard to discover and untranslated example config
into a manpage which could be translated.
</content>
</entry>
<entry>
<title>document http options in new apt-transport-http manpage</title>
<updated>2018-01-03T17:55:41Z</updated>
<author>
<name>David Kalnischkies</name>
<email>david@kalnischkies.de</email>
</author>
<published>2017-11-22T18:39:31Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=956145444e1a3b7f5e660f71904711f4ea5bd262'/>
<id>urn:sha1:956145444e1a3b7f5e660f71904711f4ea5bd262</id>
<content type='text'>
We had documentation for the http transport in our "catch-all" apt.conf
manpage, but it seems benefitial to document transports in their own
manpage instead of pushing them all into one.
</content>
</entry>
<entry>
<title>Translate shared documentation parts again</title>
<updated>2017-11-20T20:48:30Z</updated>
<author>
<name>Julian Andres Klode</name>
<email>jak@debian.org</email>
</author>
<published>2017-11-19T22:13:30Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=dfb4c178b4f6a7db255cbc7dc2b162721d807b58'/>
<id>urn:sha1:dfb4c178b4f6a7db255cbc7dc2b162721d807b58</id>
<content type='text'>
We accidentally did not translate the entity file, but should
have. This makes apt.ent translatable again. This generates the
target multiple times, but surprisingly, that works just fine, so
let's just keep it that way, as it's clean code otherwise.
</content>
</entry>
<entry>
<title>reimplement and document auth.conf</title>
<updated>2017-07-26T17:09:04Z</updated>
<author>
<name>David Kalnischkies</name>
<email>david@kalnischkies.de</email>
</author>
<published>2017-07-07T14:24:21Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=ea408c560ed85bb4ef7cf8f72f8463653501332c'/>
<id>urn:sha1:ea408c560ed85bb4ef7cf8f72f8463653501332c</id>
<content type='text'>
We have support for an netrc-like auth.conf file since 0.7.25 (closing
518473), but it was never documented in apt that it even exists and
netrc seems to have fallen out of usage as a manpage for it no longer
exists making the feature even more arcane.

On top of that the code was a bit of a mess (as it is written in c-style)
and as a result the matching of machine tokens to URIs also a bit
strange by checking for less specific matches (= without path) first.
We now do a single pass over the stanzas.

In practice early adopters of the undocumented implementation will not
really notice the differences and the 'new' behaviour is simpler to
document and more usual for an apt user.

Closes: #811181
</content>
</entry>
<entry>
<title>CMake: Exclude .md5 and .map doxygen files from install</title>
<updated>2016-08-11T17:51:07Z</updated>
<author>
<name>Julian Andres Klode</name>
<email>jak@debian.org</email>
</author>
<published>2016-08-11T16:09:39Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=281383ce1b020013737b28d87988bdf477a90477'/>
<id>urn:sha1:281383ce1b020013737b28d87988bdf477a90477</id>
<content type='text'>
This is much better than removing them in debian/rules.

Gbp-Dch: ignore
</content>
</entry>
<entry>
<title>CMake: Mark Doxygen as required and use DOXYGEN_EXECUTABLE</title>
<updated>2016-08-11T17:50:48Z</updated>
<author>
<name>Julian Andres Klode</name>
<email>jak@debian.org</email>
</author>
<published>2016-08-11T15:34:12Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=7363c98f940f267b5c4186b6578ac79a98b501e0'/>
<id>urn:sha1:7363c98f940f267b5c4186b6578ac79a98b501e0</id>
<content type='text'>
Seems like I missed that when adding doxygen support.

Gbp-Dch: ignore
</content>
</entry>
<entry>
<title>CMake: Rewrite existing Documentation support and add doxygen</title>
<updated>2016-08-10T14:17:18Z</updated>
<author>
<name>Julian Andres Klode</name>
<email>jak@debian.org</email>
</author>
<published>2016-08-08T19:53:46Z</published>
<link rel='alternate' type='text/html' href='https://git.kalnischkies.de/apt/commit/?id=10ec2d23f14cf5d3e4835d9bcb57d0937f803e6a'/>
<id>urn:sha1:10ec2d23f14cf5d3e4835d9bcb57d0937f803e6a</id>
<content type='text'>
This can now build all documentation. It should also be fairly
reusable for other projects, as long as they follow the same
naming scheme for the po4a output files and set the PACKAGE_*
variables used here.

We could have done all translations in a single call to po4a
like the makefile based buildsystem does. While that would
have made the output slightly nicer, this solution offers a
huge performance gain because it can translate the documents
in parallel, which also means that the xsltproc stage does not
have to wait for all translations to be done first.

You might think that the add_custom_command() should list the
actual output files as BYPRODUCTS. This is not true however:
Because the files are not always generated, Ninja will think
missing byproducts mean that the target is out of date - which
is not what we want.

Finally, also add the missing doxygen support. Note that the
packaging script cleans up some md5 and map files created by
doxygen, otherwise it is fairly boring.
</content>
</entry>
</feed>
