.\" Copyright (c) 2018 pkgconf authors (see AUTHORS).
.\"
.\" Permission to use, copy, modify, and/or distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" This software is provided 'as is' and without any warranty, express or
.\" implied.  In no event shall the authors be liable for any damages arising
.\" from the use of this software.
.Dd July 19, 2018
.Dt PKGCONF-PERSONALITY 5
.Os
.Sh "نام (NAME)"
.Nm pkgconf-personality
.Nd فرمت فایلهای شخصیت و پیکربندی هدف در pkgconf
.Sh "توضیحات (DESCRIPTION)"
پرونده‌های شخصیت (personality) کامپایل متقاطع در
.Nm pkgconf
سازوکاری سودمند را برای ذخیره‌سازی اطلاعات گوناگون درباره زنجیره‌های ابزار (toolchains) سیستم فراهم می‌کنند.
اطلاعات ذخیره‌شده توسط پرونده‌های
.Nm .personality
شامل اطلاعاتی درباره مسیرهای مورداستفاده زنجیره ابزار کامپایل متقاطع، مانند دایرکتوری sysroot و مسیرهای پیشفرض include و کتابخانه‌ها است.
.Nm pkgconf
از این اطلاعات برای تشخیص اینکه چه اطلاعاتی جهت استفاده از کتابخانه‌ها ضروری است، استفاده می‌کند.
.\"
.Ss "نحو پرونده (FILE SYNTAX)"
پرونده
.Nm .personality
از قالبی الهام‌گرفته از RFC822 پیروی می‌کند.
توضیحات با یک علامت پوند، هش یا مربع (#) آغاز می‌شوند و انتساب متغیرها مشابه پوسته استاندارد POSIX است.
ویژگی‌ها با استفاده از بندهایی (stanzas) به سبک RFC822 تعریف می‌شوند.
.\"
.Ss "ویژگی‌ها (PROPERTIES)"
.\"
ویژگی‌ها با استفاده از بندهایی به سبک RFC822 تنظیم می‌شوند که شامل یک کلیدواژه، به دنبال آن علامت دونقطه (:) و سپس مقداری است که ویژگی باید بر روی آن تنظیم گردد.
جایگزینی متغیرها بدون توجه به نوع ویژگی همواره انجام می‌شود.
.Pp
سه نوع ویژگی وجود دارد:
.\"
.Bl -tag -width indent
.\"
.It Literal
ویژگی بر روی متن صریح مقدار تنظیم خواهد شد.
.\"
.It Fragment List
ویژگی بر روی فهرستی از قطعات (fragments) تجزیه‌شده از متن تنظیم خواهد شد.
متن ورودی باید در قالبی باشد که برای ارسال به یک پوسته POSIX بدون هیچ‌گونه بسط پوسته پس از انجام جایگزینی متغیرها مناسب باشد.
عناصر با علامت دونقطه (:) از یکدیگر جدا می‌شوند.
.\"
.It Boolean
اگر مقدار یکی از موارد: true، yes یا 1 باشد، ویژگی بر روی true تنظیم خواهد شد.
در غیر این صورت بر روی false تنظیم می‌شود.
.\"
.El
.Ss "کلیدواژه‌های ویژگی (PROPERTY KEYWORDS)"
.Bl -tag -width indent
.\"
.It Triplet
سه‌تایی (triplet) مورداستفاده توسط زنجیره ابزار کامپایل متقاطع.
(اجباری؛ متن صریح)
.It SysrootDir
دایرکتوری مورداستفاده توسط ریشه سیستم (sysroot) زنجیره ابزار کامپایل متقاطع.
(اجباری؛ متن صریح)
.It DefaultSearchPaths
فهرستی از دایرکتوری‌ها برای جستجوی پرونده‌های
.Xr pc 5
در آن‌ها.
(اجباری؛ فهرست قطعات)
.It SystemIncludePaths
فهرستی از دایرکتوری‌ها که به صورت پیشفرض در مسیر جستجو برای پرونده‌های include گنجانده می‌شوند.
(اجباری؛ فهرست قطعات)
.It SystemLibraryPaths
فهرستی از دایرکتوری‌ها که به صورت پیشفرض در مسیر جستجو برای کتابخانه‌ها گنجانده می‌شوند.
(اجباری؛ فهرست قطعات)
.It WantDefaultPure
در صورت درست بودن (true)، رفتار پیشفرض pkgconf ترجیح دادن یک گراف وابستگی خالص خواهد بود.
(اختیاری؛ بولی؛ پیشفرض false است)
.It WantDefaultStatic
در صورت درست بودن (true)، رفتار پیشفرض pkgconf کارکرد در حالت پیوند ایستا (static linking) خواهد بود.
(اختیاری؛ بولی؛ پیشفرض false است)
.\"
.El
.Sh "مثال‌ها (EXAMPLES)"
نمونه‌ای از یک پرونده
.Nm .personality :
.Bd -literal
# This is a comment
Triplet: x86_64-pc-linux-gnu
SysrootDir: /home/kaniini/sysroot/x86_64-pc-linux-gnu
DefaultSearchPaths: /home/kaniini/sysroot/x86_64-pc-linux-gnu/lib/pkgconfig:/home/kaniini/sysroot/x86_64-pc-linux-gnu/share/pkgconfig
SystemIncludePaths: /home/kaniini/sysroot/x86_64-pc-linux-gnu/include
SystemLibraryPaths: /home/kaniini/sysroot/x86_64-pc-linux-gnu/lib
.Ed
.Sh "همچنین ببینید (SEE ALSO)"
.Xr pkgconf 1 ,
.Xr pc 5 ,
.Xr pkg.m4 7
.Sh "نویسندگان (AUTHORS)"
.Nm pkgconf
توسط نویسندگان pkgconf توسعه داده شده است (پروندهٔ AUTHORS را ببینید).