نام (NAME)

redo-dot - چاپ نمودار وابستگی redo برای دایرکتوری جاری

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

redo-dot [pattern]

توضیحات (DESCRIPTION)

redo(1) ابزاری برای ساخت فایل‌ها و بازسازی مجدد آن‌ها در صورت تغییر هر یک از وابستگی‌هایشان است. redo-dot نمودار وابستگی را برای دایرکتوری جاری در قالب فایلی چاپ می‌کند که توسط برنامه dot(1) از مجموعه ابزارهای چیدمان Graphviz پشتیبانی می‌شود. اگر دایرکتوری کاری جاری یک دایرکتوری ساخت redo(1) نباشد، redo-dot با یک کد وضعیت نشان‌دهنده شکست خارج می‌شود.

در نمودار وابستگی، هدف‌ها و مبداها با گره‌ها، وابستگی‌ها با یال‌های توپر (پیوسته)، و وابستگی‌های عدم وجود با یال‌های نقطه‌چین نمایش داده می‌شوند. هدف‌هایی با وابستگی‌های غیرقابل‌برآورده دارای خط دور پررنگ (bold) هستند. هدف‌هایی که بسته به ورودیِ redo-stamp(1) بازسازی می‌شوند، خط دور خط‌چین دارند.

یک الگو شامل نویسه‌هایی است که با خودشان تطابق می‌یابند و همچنین فرانویسه‌های «!»، «*»، «؟» و «[» که در صورت قرار گرفتن درون نقل‌قول، معنای ویژه خود را از دست می‌دهند. ستاره («*») با هر رشته‌ای از نویسه‌ها تطابق می‌یابد. علامت سوال («?») با هر تک‌نویسه‌ای مطابقت دارد. براکت چپ («[») و براکت راست («]») آغاز و پایان یک رده نویسه‌ای را مشخص می‌کنند. رده‌های نویسه‌ای با هر نویسه‌ای بین براکت‌ها یا بازه‌ای از نویسه‌ها که با خط تیره («-») تعیین شده است تطابق می‌یابند؛ برای گنجاندن خط تیره واقعی، آن را نویسه اول یا آخر قرار دهید. علامت تعجب («!») به عنوان نخستین نویسه در هر رده نویسه‌ای، آن را نفی می‌کند.

مثال‌ها (EXAMPLES)

redo-dot |dot -Tx11

نمودار کامل وابستگی را در یک پنجره X11 با استفاده از dot(1) نمایش می‌دهد.

redo-dot '*/stdio.h'

نمودار وابستگی را تنها با گره‌هایی خروجی می‌دهد که با الگوی */stdio.h، وابستگی‌های گره‌های منطبق با الگو، و گره‌های وابسته به گره‌های منطبق با الگو مطابقت دارند.

redo-dot |sed s%"$(pwd)"/%%g >deps.dot; dot deps.dot -Tpng >deps.png

نمودار کامل وابستگی را در فایلی به نام deps.dot خروجی می‌دهد، سپس از روی آن یک فایل PNG (Portable Network Graphics) به نام deps.png با استفاده از dot(1) تولید می‌کند. فراخوانی sed(1) دایرکتوری کاری جاری را از نام گره‌ها حذف می‌کند.

تاریخچه (HISTORY)

دستور redo-dot توسط Ælla Chiana Moskopp طراحی و پیاده‌سازی شده است.

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

دستور redo-dot و این صفحه راهنما توسط Ælla Chiana Moskopp نوشته شده‌اند.

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

کپی‌رایت © 2015-2016 Ælla Chiana Moskopp. مجوز AGPLv3+: گنو آفرو جی‌پی‌ال نسخه ۳ یا بالاتر http://www.gnu.org/licenses/agpl-3.0.html. این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

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

sh(1), redo(1), redo-always(1), redo-ifchange(1), redo-ifcreate(1), redo-ood(1), redo-sources(1), redo-stamp(1), redo-targets(1)

گزارش باگ‌ها (BUGS)

اگر نام فایل هدف شامل نویسه تب (tab) یا خط جدید (newline) باشد، ممکن است عملکرد redo-dot با اختلال مواجه شود.