os_log format strings should be documented

Originator:mayoff
Number:rdar://44620382 Date Originated:19-Sep-2018 05:51 PM
Status:CLOSED Resolved:DUPLICATE OF 41773571 CLOSED
Product:Developer Tools Product Version:Xcode Version 10.0 (10A255)
Classification:Serious Bug Reproducible:Always
 
Summary:
Dear os_loggers,

This os_log API looks really amazing and I’d love to use it. But I have a problem. There’s no documentation for its format strings outside of a few slides from WWDC 2016 Session 721.

The logging system documentation says “See Formatting Log Messages” in multiple places, such as here:

https://developer.apple.com/documentation/os/logging?language=objc

There is no such document that I can find.

Please publish the Formatting Log Messages document. Because what’s the point of a WWDC session about your great new API if you’re not going to give us the documentation we need to use it well?

Thanks,
Rob


Steps to Reproduce:
 

Expected Results:
Documentation.

Actual Results:
Frustration.

Version:
Xcode Version 10.0 (10A255)

Notes:

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!