[Bug 1764928] Re: Please document apt-daily

[madumlao]

apt.conf(5) is inaccurate.

apt.conf(5) references /etc/cron.daily/apt; apt installs /etc/cron.daily
/apt-compat.

Furthermore, the man page gives reference to users to `see the top of
the script for explanation of these (periodic and archive) options`. The
top of /etc/cron.daily/apt-compat does not have an explanation of those
options.

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to apt in Ubuntu.
https://bugs.launchpad.net/bugs/1764928

Title:
  Please document apt-daily

Status in apt package in Ubuntu:
  Invalid

Bug description:
  The following systemd services are installed along with apt:

  /lib/systemd/system/apt-daily.timer
  /lib/systemd/system/apt-daily-upgrade.timer
  /lib/systemd/system/apt-daily-upgrade.service
  /lib/systemd/system/apt-daily.service

  By default, these run the equivalent of "apt update", and "apt
  upgrade" at specified times. However, this behavior is documented
  nowhere in the man pages or /usr/share/doc.

  Furthermore, they run the command /usr/lib/apt/apt.systemd.daily,
  which is also undocumented, nor does it respond to a --help option. A
  non-savvy Linux user will not be able to determine that this is a
  shell script and find out what it does. Or worse, a partially-savvy
  Linux user will be able to determine that this is a shell script, and
  will read it imperfectly (usage is also not described in script
  comments) ending up with a wrong idea of what it does.

  The idea is to keep the system updates. That is a GOOD THING (tm).

  But it relies on undocumented behavior. That is a BAD THING (tm).

  Can we have the apt-daily service documented?

  
  madumlao at lezard ~ $ lsb_release -rd
  Description:	Ubuntu 16.04.4 LTS
  Release:	16.04

  
  apt version: 1.2.26

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/apt/+bug/1764928/+subscriptions