Add OpenStep coercion support for non-OpenStep plist types

- Use PLIST_OPT_COERCE option to coerce PLIST_BOOLEAN, PLIST_DATE, PLIST_UID, and PLIST_NULL to OpenStep-compatible types (1 or 0, ISO 8601 strings, integers, and 'NULL' string)
- Add plist_to_openstep_with_options() function to allow passing coercion option (and others)
- Update plist_write_to_string() and plist_write_to_stream() accordingly

1 files changed, 11 insertions, 0 deletions

diff --git a/docs/plistutil.1 b/docs/plistutil.1
index f322bab..64373b3 100644
--- a/docs/plistutil.1
+++ b/docs/plistutil.1
@@ -79,6 +79,17 @@ A nodepath of:
 JSON and OpenStep only: Print output in compact form. By default, the output
 will be pretty-printed.
 .TP
+.B \-C, \-\-coerce
+JSON and OpenStep only: Coerce non-compatible plist types to JSON/OpenStep
+compatible representations.
+Date values become ISO 8601 strings,
+data values become Base64-encoded strings (JSON),
+UID values become integers,
+boolean becomes 1 or 0 (OpenStep),
+and NULL becomes a string 'NULL' (OpenStep)
+
+This options is implied when invoked as plist2json.
+.TP
 .B \-s, \-\-sort
 Sort all dictionary nodes lexicographically by key before converting to the output format.
 .TP