.\"Copyright (C) 2020 Free Software Foundation, Inc.
.\"Copying and distribution of this file, with or without modification,
.\"are permitted in any medium without royalty provided the copyright
.\"notice and this notice are preserved.
.Dd September 23, 2020
.Dt plutil 1
.Os
.Sh "نام (NAME)"
.Nm plutil
.Nd ابزار کار با فهرست‌های ویژگی (Property list)
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm plutil
.Op Fl command
.Op Fl options
.Ar file
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
می‌تواند برای ویرایش فهرست‌های ویژگی (property lists)، بررسی درستی نحو، یا تبدیل از یک قالب به قالب دیگر استفاده شود. اگر
.Ql -
به عنوان مسیر فایل داده شود، از ورودی استاندارد (stdin) و خروجی استاندارد (stdout) استفاده می‌شود.
.Pp
بخش اول، عملیاتی است که باید انجام شود و یکی از موارد زیر است:
.Bl -tag -width -indent
.It -p
کل plist را در خروجی استاندارد (stdout) با قالب خوانا برای انسانِ GNUStep چاپ می‌کند.
.It -lint
بررسی می‌کند که آیا فایل plist قابل تجزیه و تحلیل است یا خیر.
.It -convert Ar FMT
فهرست ویژگی را به قالب دیگری تبدیل می‌کند.
.Ql FMT
می‌تواند یکی از موارد زیر باشد:
.Bl -tag -width -indent
.It xml1
قالب Apple XML.
.It binary1
قالب Apple binary.
.It openstep
قالب OpenStep (بدون نوع، خوانا برای انسان).
.It gnustep
قالب GNUStep (دارای نوع، خوانا برای انسان).
.It json
قالب JSON (با اتلاف داده، خوانا برای انسان).
.El
نام‌های NSPropertyListFormat نیز پذیرفته می‌شوند.
.It -insert Ar PATH Ar KEY Ar Value
درج مقدار در مسیر کلید مشخص‌شده.
.El
عملیات پیش‌فرض
.Ql -lint
است.
.Pp
گزینه‌های عمومی عبارتند از:
.Bl -tag -width -indent
.El
.Pp
مفهوم "keypath" در plutil یک زنجیره از کلیدهای جداشده با نقطه برای پیمایش شیء plist است. یک keypath خالی به خود شیء اشاره دارد. قالب کلیدها با لیترال‌های رشته‌ای plist در GNUStep مطابقت دارد.
.Sh "نکات پیاده‌سازی (IMPLEMENTATION NOTES)"
.Bl -bullet
.It
رشته‌های نقل‌قول‌شده در keypath یک افزونه GNUStep هستند.
.It
قالب‌های خروجی تحت لفظی (literal) برای زبان‌های Objective-C و Swift هنوز پیاده‌سازی نشده‌اند.
.El
.Sh "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت مقدار 0 و در صورت بروز خطا مقدار غیرصفر برگردانده می‌شود.
.Sh "مثال‌ها (EXAMPLES)"
.Sh "عیب‌یابی (DIAGNOSTICS)"
.Sh "همچنین ببینید (SEE ALSO)"
.Xr pl 1
.Xr pldes 1
.Sh "نویسندگان (AUTHORS)"
.An -nosplit
این نسخه از
.Nm
توسط
.An Mingye Wang Aq Mt arthur2e5@aosc.io
نوشته شده است.
.Nm
نخستین بار در Mac OS X 10.2 ظاهر شد و قابلیت‌های مرتبط با مسیر را در حدود Mac OS X 10.13 دریافت کرد.