From 525d6a7f31a736042860b263d3409f38cdc51820 Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Fri, 5 Jun 2020 17:09:32 +0200 Subject: Add man page for plistutil --- Makefile.am | 2 +- configure.ac | 1 + docs/Makefile.am | 3 +++ docs/plistutil.1 | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 67 insertions(+), 1 deletion(-) create mode 100644 docs/Makefile.am create mode 100644 docs/plistutil.1 diff --git a/Makefile.am b/Makefile.am index 5f36fd7..edfe072 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,6 +1,6 @@ AUTOMAKE_OPTIONS = foreign ACLOCAL_AMFLAGS = -I m4 -SUBDIRS = libcnary src include tools test +SUBDIRS = libcnary src include tools test docs if HAVE_CYTHON SUBDIRS += cython endif diff --git a/configure.ac b/configure.ac index a2edbc4..7b19844 100644 --- a/configure.ac +++ b/configure.ac @@ -288,6 +288,7 @@ src/libplist.pc src/libplist++.pc include/Makefile tools/Makefile +docs/Makefile cython/Makefile test/Makefile fuzz/Makefile diff --git a/docs/Makefile.am b/docs/Makefile.am new file mode 100644 index 0000000..f025791 --- /dev/null +++ b/docs/Makefile.am @@ -0,0 +1,3 @@ +man_MANS = plistutil.1 + +EXTRA_DIST = $(man_MANS) diff --git a/docs/plistutil.1 b/docs/plistutil.1 new file mode 100644 index 0000000..042c94e --- /dev/null +++ b/docs/plistutil.1 @@ -0,0 +1,62 @@ +.TH "plistutil" 1 +.SH NAME +plistutil \- Convert a plist FILE from binary to XML format or vice-versa +.SH SYNOPSIS +.B plistutil +[OPTIONS] +[-i FILE] +[-o FILE] +.SH DESCRIPTION +plistutil allows to convert a file in Property List format from binary to XML format or vice-versa. +.SH OPTIONS +.TP +.B \-i, \-\-infile FILE +Input FILE to convert from. If this argument is omitted or - is passed as +filename, plistutil will read from stdin. +.TP +.B \-o, \-\-outfile FILE +Output FILE to convert to. If this argument is omitted or - is passed as +filename, plistutil will write to stdout. +.TP +.B \-f, \-\-format [bin|xml] +Force output format, regardless of input type. This is useful if the input +format is not known, but the output format should always be in a specific +format (like xml). +.TP +.B \-h, \-\-help +Prints usage information. +.TP +.B \-d, \-\-debug +Enabled extended debug output. +.TP +.B \-v, \-\-version +Print version information +.SH EXAMPLES +.TP +.B plistutil -i test.plist -o out.plist +Convert test.plist and write to out.plist. If test.plist is in XML format, +out.plist will be in binary format. If test.plist is in binary format, +out.plist will be in XML format. +.TP +.B plistutil -i test.plist -o out.plist -f bin +Same as before, but the output will always be in binary format. +.TP +.B plistutil -i test.plist -f xml +Print test.plist as XML plist, regardless of the input format. +.TP +.B plistutil -i test.plist -f xml -o - +Same as before. +.TP +.B cat test.plist |plistutil -f xml +Take plist data from stdin - piped via cat - and write the output as XML +to stdout. +.SH AUTHORS +Zach C. + +Martin Szulecki + +Nikias Bassen +.SH ON THE WEB +https://libimobiledevice.org + +https://github.com/libimobiledevice/libplist -- cgit v1.1-32-gdbae