| Summary: | atrun(8) man page does not reflect cron.d change | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Andrew Daugherity <andrew.daugherity> |
| Component: | Manual Pages | Assignee: | freebsd-bugs (Nobody) <bugs> |
| Status: | New --- | ||
| Severity: | Affects Many People | CC: | arnaud, doc, gbe, p+freebsd, pat |
| Priority: | --- | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
(In reply to Paweł Krawczyk from comment #1) Correct PR https://github.com/freebsd/freebsd-src/pull/1106 |
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