.\" Copyright (c) 2002 Marcus Harnisch <marcus.harnisch@gmx.net>
.\"
.\" This is free documenation. It is provided to you without any
.\" warranty that it is useful or that you can understand it.
.\"
.\" You are granted the right to use and redistribute the source code
.\" or parts of it (even single words and letters), provided that the
.\" copyright notice and the license terms will not be removed.
.\"
.TH prune 1

.SH "نام (NAME)"
prune \- هرس کردن و برش زیرگراف‌ها در گراف‌های جهت‌دار
.SH "خلاصه دستور (SYNOPSIS)"
.B prune
[
.BI \-n " node"
]
[
.BI \-N " attrspec"
]
[
.B \-v
]
[
.BR \- ( h | ? )
]
[
.I files ...
]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B prune
گراف‌های جهت‌دار را در همان قالبی که توسط 
.B dot(1)
استفاده می‌شود می‌خواند و زیرگراف‌های ریشه‌گرفته از گره‌های مشخص‌شده در خط فرمان را از طریق گزینه‌ها حذف (هرس) می‌کند. خود این گره‌ها حذف نخواهند شد، اما می‌توان به آن‌ها ویژگی‌هایی (صفاتی) اختصاص داد تا توسط یک ویرایشگر جریان گراف مانند
.B gvpr(1)
به راحتی مکان‌یابی شوند.
.B prune
چرخه‌ها، حلقه‌ها و یال‌های چندگانه را به درستی مدیریت می‌کند.
.PP
هر دو گزینه می‌توانند چندین بار در خط فرمان ظاهر شوند. تمام زیرگراف‌های ریشه‌گرفته از گره‌های مربوطه مشخص‌شده پردازش خواهند شد. اگر گره‌ای وجود نداشته باشد،
.B prune
از آن صرف‌نظر کرده و یک پیام هشدار در stderr چاپ می‌کند.
اگر چندین صفت مشخص شود، آن‌ها به تمامی گره‌هایی که پردازش شده‌اند اعمال خواهند شد.
.B prune
نتیجه را در خروجی استاندارد (stdout) می‌نویسد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-n " name"
نام گره‌ای را که باید هرس شود مشخص می‌کند.
.TP
.BI \-N " attrspec"
صفتی را مشخص می‌کند که برای هر گره هرس‌شده تنظیم می‌شود (یا در صورت وجود، تغییر می‌یابد).
.I attrspec
رشته‌ای به صورت
.IR attr "=" value
است.
.TP
.B \-v
خروجی با جزئیات کامل (Verbose).
.TP
.BR \-h " "\-?
راهنمای استفاده را چاپ کرده و خارج می‌شود.
.SH "مثال‌ها (EXAMPLES)"
یک گراف ورودی
.I test.gv
به صورت
.PP
	digraph DG {
.br
	  A \-> B;
.br
	  A \-> C;
.br

.br
	  B \-> D;
.br
	  B \-> E;
.br
	}
.br

، که با دستور زیر پردازش شود:
.PP
	prune \-n B test.gv
.PP
خروجی زیر را تولید می‌کند (کد واقعی ممکن است با فرمت‌بندی اندکی متفاوت باشد):
.PP
	digraph DG {
.br
	  A \-> B;
.br
	  A \-> C;
.br
	}
.br

یک گراف ورودی دیگر
.I test.gv
به صورت
.PP
	digraph DG {
.br
	  A \-> B;
.br
	  A \-> C;
.br

.br
	  B \-> D;
.br
	  B \-> E;
.br

.br
	  C \-> E;
.br
	}
.br

(به یال اضافی از
.I C
به
.I E
توجه کنید)، که با دستور زیر پردازش شود:
.PP
	prune \-n B \-N color=red test.gv
.PP
نتیجه زیر را خواهد داشت:
.PP
	digraph DG {
.br
	  B [color=red];
.br
	  A \-> B;
.br
	  A \-> C;
.br
	  C \-> E;
.br
	}
.br

گره
.I E
حذف نشده است زیرا والد دوم آن یعنی
.I C
هرس نشده است.

.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B prune
در صورت اجرای موفقیت‌آمیز مقدار ۰ را برمی‌گرداند.
در صورت بروز خطا مقدار ۱ را برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.BR dot (1),
.BR gvpr (1)

.SH "نویسندگان (AUTHORS)"
Marcus Harnisch <marcus.harnisch@gmx.net>