Bug 243380 - atrun(8) man page does not reflect cron.d change
Summary: atrun(8) man page does not reflect cron.d change
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-bugs (Nobody)
Depends on:
Reported: 2020-01-15 21:30 UTC by Andrew Daugherity
Modified: 2020-01-15 21:30 UTC (History)
1 user (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Andrew Daugherity 2020-01-15 21:30:47 UTC
I was upgrading a system from 11.2 to 12.1, and freebsd-update presented me with a diff removing the /usr/libexec/atrun line from /etc/crontab.  I wasn't sure whether to accept this change, so I RTFM and see that atrun(8) still says:
     The system crontab(5) file /etc/crontab must contain the line

     */5     *       *       *       *       root    /usr/libexec/atrun

     so atrun is invoked every five minutes.

This makes removing the line seem like an incorrect change; however, I looked through the svn history of the crontab file and see that r318443 removed this line and put it in /etc/cron.d/at instead.

The man page should be updated to reflect this, but I don't know what the best wording is.  Perhaps something like "The system crontab(5) segment /etc/cron.d/at must contain the line"?

Additionally, crontab(5) does not mention cron.d at all.  Would merging the "Jobs in /etc/cron.d/" and "EXAMPLE OF A JOB IN /etc/cron.d/job" sections of cronie's man page [1] be appropriate?  It's clearly derived from the same Vixie cron man page and is ISC-licensed.

[1] https://github.com/cronie-crond/cronie/blob/master/man/crontab.5