[Bug 243380] atrun(8) man page does not reflect cron.d change

bugzilla-noreply at freebsd.org bugzilla-noreply at freebsd.org
Wed Jan 15 21:30:47 UTC 2020


https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=243380

            Bug ID: 243380
           Summary: atrun(8) man page does not reflect cron.d change
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs at FreeBSD.org
          Reporter: andrew.daugherity at gmail.com
                CC: doc at FreeBSD.org

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

-- 
You are receiving this mail because:
You are on the CC list for the bug.


More information about the freebsd-doc mailing list