نام (NAME)

alpm-repo-files - قالب پرونده برای فهرست کردن فایل‌ها و پوشه‌های موجود در یک alpm-package.

توضیحات (DESCRIPTION)

قالب alpm-files یک قالب متنی است که پوشه‌ها و فایل‌های موجود در یک alpm-package منفرد را فهرست می‌کند.

چنین فایل‌هایی files نامیده می‌شوند و در فایل‌های alpm-repo-db قرار دارند. آن‌ها توسط نرم‌افزار مدیریت مخزن بسته (مانند dbscripts [1]) ایجاد می‌شوند. نرم‌افزار مدیریت بسته (مانند pacman) از آن‌ها برای فهرست کردن و پرسمان مسیرهای پوشه‌ها و فایل‌های موجود در یک فایل بسته استفاده می‌کند.

مهم است که alpm-repo-files را با alpm-db-files که از همان نام فایل (files) استفاده می‌کند اما در چارچوب یک alpm-db به کار می‌رود، اشتباه نگیرید.

قالب کلی

یک فایل alpm-repo-files یک فایل با کدگذاری UTF-8 و جداشده با خط جدید است.

این فایل شامل یک سربرگ بخش منفرد و صفر یا چند مدخل بخش است. خطوط خالی نادیده گرفته می‌شوند. از یادداشت‌ها (کامنت‌ها) پشتیبانی نمی‌شود.

نخستین خط باید عبارت رشته‌ای %FILES% باشد که سربرگ بخش را نشان می‌دهد. بسته‌های بدون فایل (مانند alpm-meta-packages) ممکن است فقط شامل این سربرگ بخش باشند.

تمامی خطوط بعدی به عنوان مدخل‌های بخش، یکی در هر خط، و مرتب‌شده به ترتیب لغوی تفسیر می‌شوند. هر مدخل بخش نمایانگر مسیر یک فایل یا پوشه منفرد است. قوانین قالب‌بندی زیر بر مسیرها اعمال می‌شوند:

پوشه‌ها همیشه با یک ممیز انتهایی (/) فهرست می‌شوند.
تمام مسیرها نسبت به ریشه سیستم هستند (یعنی /usr/bin/foo به صورت usr/bin/foo نشان داده می‌شود).

مثال‌ها (EXAMPLES)

در ادامه نمونه‌ای از یک فایل alpm-repo-files برای بسته‌ای به نام foo آورده شده است:

%FILES%
usr/
usr/bin/
usr/bin/foo
usr/share/
usr/share/bash-completion/
usr/share/bash-completion/completions/
usr/share/bash-completion/completions/foo
usr/share/doc/
usr/share/doc/foo/
usr/share/doc/foo/README.md
usr/share/fish/
usr/share/fish/vendor_completions.d/
usr/share/fish/vendor_completions.d/foo.fish
usr/share/licenses/
usr/share/licenses/foo/
usr/share/licenses/foo/LICENSE-MIT
usr/share/zsh/
usr/share/zsh/site-functions/
usr/share/zsh/site-functions/_foo

فایل‌های بسته‌بندی‌شده شامل یک فایل دودویی (usr/bin/foo)، یک فایل README (usr/share/doc/foo/README.md) و یک فایل مجوز (usr/share/licenses/foo/LICENSE-MIT) در میان فایل‌های دیگر مانند اسکریپت‌های تکمیل خودکار برای پوسته‌های مختلف هستند.

همچنین ببینید (SEE ALSO)

alpm-db-files(5), alpm(7), alpm-db(7), alpm-package(7), alpm-package-name(7), alpm-package-version(7), alpm-repo(7), alpm-repo-db(7), pacman(8)

یادداشت‌ها (NOTES)

1.: dbscripts
: https://gitlab.archlinux.org/archlinux/dbscripts