نام (NAME)

reuse - ابزاری برای انطباق با توصیه‌های REUSE

خلاصه دستور (SYNOPSIS)

reuse [options] <command>

توضیحات (DESCRIPTION)

ابزار reuse یک ابزار کمکی برای ابتکار عمل REUSE است. کارکرد اصلی آن در reuse-lint(1) https://reuse.readthedocs.io/en/v6.2.0/man/reuse-lint.html، اعتبارسنجی انطباق یک پروژه با مشخصات REUSE است. این ابزار همچنین شامل مجموعه‌ای از قابلیت‌های تسهیل‌کننده است تا توسعه‌دهندگان بتوانند پروژه‌های خود را سازگار کنند.

برای دریافت اطلاعات بیشتر درباره نحوه استفاده از reuse فراتر از مرجع گزینه‌های خط فرمان، مستندات همراه آن را ببینید یا آن را در https://reuse.readthedocs.io بخوانید. برای اطلاعات تکمیلی درباره REUSE، به https://reuse.software مراجعه کنید.

جزئیات (DETAILS)

هنگام جستجو برای برچسب‌های کپی‌رایت و مجوز درون فایل‌ها، این ابزار خود را به‌طور سخت‌گیرانه تنها به توضیحات سرآیند فایل آن‌گونه که در مشخصات تعیین شده محدود نمی‌کند. این ابزار کل فایل را برای یافتن اطلاعات REUSE، چه در کامنت‌ها و چه خارج از آن‌ها، جستجو می‌کند. این امر تضمین می‌کند که ابزار بتواند هر نوع فایل متنی ساده (plain-text) را تجزیه کند، حتی اگر سبک کامنت‌گذاری آن شناخته‌شده نباشد.

این ابزار صحت اعلامیه‌های کپی‌رایت را بررسی نمی‌کند. اگر هر خطی شامل '©'، 'Copyright' یا 'SPDX-FileCopyrightText:' باشد، آن برچسب و تمام موارد پس از آن به عنوان یک اعلامیه کپی‌رایت معتبر تلقی می‌شود، حتی اگر آن اعلامیه کپی‌رایت با مشخصات سازگار نباشد.

گزینه‌ها (OPTIONS)

--debug: فعال‌سازی ثبت گزارش‌های اشکال‌زدایی.

--suppress-deprecation: پنهان‌سازی هشدارهای منسوخ‌شدگی.

--include-submodules: نادیده نگرفتن زیرماژول‌های Git؛ با آن‌ها به گونه‌ای رفتار می‌شود که گویی بخشی از پروژه هستند. این رفتار به‌طور دقیق با مشخصات سازگار نیست.

--include-meson-subprojects: نادیده نگرفتن زیرپروژه‌های Meson (یعنی دایرکتوری subprojects در ریشه پروژه)؛ با آن‌ها به گونه‌ای رفتار می‌شود که گویی بخشی از پروژه هستند. این رفتار به‌طور دقیق با مشخصات سازگار نیست.

--no-multiprocessing: غیرفعال‌سازی بهبوددهنده کارایی چندپردازشی. این گزینه ممکن است هنگام اشکال‌زدایی مفید باشد.

--root PATH: تنظیم ریشه پروژه روی PATH. به طور پیش‌فرض، مقدار آن ریشه مخزن VCS دایرکتوری کاری فعلی یا خود دایرکتوری کاری فعلی است.

--help: نمایش راهنما و خروج. در صورتی که هیچ دستوری داده نشود، این گزینه به صورت ضمنی اعمال می‌شود.

--version: نمایش نگارش و خروج.

محیط (ENVIRONMENT)

ابزار reuse متغیرهای محیطی زیر را رعایت می‌کند.

REUSE_ENCODING_MODULE: به‌جای انتخاب خودکار بهترین ماژول جهت تشخیص کدگذاری فایل‌ها، reuse از ماژول تعریف‌شده در این متغیر استفاده خواهد کرد. مقدار آن باید python-magic، file-magic، charset_normalizer، یا chardet باشد.

دستورها (COMMANDS)

reuse-annotate(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-annotate.html>: افزودن اطلاعات REUSE به فایل‌ها.
reuse-convert-dep5(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-convert-dep5.html>: تبدیل .reuse/dep5 به REUSE.toml.
reuse-download(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-download.html>: بارگیری فایل‌های مجوز.
reuse-lint(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-lint.html>: بررسی انطباق یک پروژه با مشخصات REUSE.
reuse-lint-file(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-lint-file.html>: بررسی انطباق فایل‌های منفرد با مشخصات REUSE.
reuse-spdx(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-spdx.html>: تولید سیاهه اقلام (bill of materials) با فرمت SPDX.
reuse-supported-licenses(1) <https://reuse.readthedocs.io/en/v6.2.0/man/reuse-supported-licenses.html>: چاپ فهرستی از مجوزهای پشتیبانی‌شده.

نویسندگان (AUTHORS)

Free Software Foundation Europe

کپی‌رایت و تکثیر (COPYRIGHT)

2017, Free Software Foundation Europe. CC-BY-SA-4.0