Essential documentation is not clear (man launchd.plist)

Originator:ktam64
Number:rdar://14479026 Date Originated:18-Jul-2013
Status:Open Resolved:
Product:Documentation Product Version:
Classification: Reproducible:
 
The man page for launchd.plist contains essential documentation for creating launch agents, launch daemons and xpc services. The language used in the documentation is very unix terminology heavy and assumes experienced unix developer knowledge. This is not necessary for the information it is trying to convey, especially in relation to the description of the plist keys for the launchd plist file.

The description of the plist keys and perhaps some other information could be moved to for example the daemon and services programming guide. The description of these keys could be updated to be comprehensible for MacOS/iOS Cocoa developers rather than unix developers.

Steps to Reproduce:

Read the launchd.plist man page and then have to ask questions on discussion lists about what the description of the plist keys mean.

Expected Results:

To be able to read the documentation for configuring a LaunchAgent or LaunchDaemon without having to become a unix expert.

Comments


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!