.TH GML2GV,GV2GML 1 "24 June 2011"
.SH "نام (NAME)"
gml2gv,gv2gml \- مبدل‌های GML-DOT
.SH "خلاصه دستور (SYNOPSIS)"
.B gml2gv
[
.B \-?v
]
[
.BI \-g gname
]
[
.BI \-o outfile
]
[ 
.I files
]
.br
.B gv2gml
[
.B \-y
]
[
.B \-?
]
[
.BI \-o outfile
]
[ 
.I files
]

.SH "توضیحات (DESCRIPTION)"
دستور
.B gml2gv
گراف مشخص‌شده در قالب GML را به گرافی در قالب GV (سابقاً DOT) تبدیل می‌کند. 
دستور
.B gv2gml
گراف مشخص‌شده در قالب GV را به گرافی در قالب GML تبدیل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.B \-v
حالت پرگویی (verbose) را فعال می‌کند.
.TP
.B \-y
به جای مشخصات GML، از ویژگی‌ها مطابق با مستندات yWorks.com استفاده می‌کند.
.TP
.B \-?
اطلاعات نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
.TP
.BI \-g "gname"
رشتهٔ \fIgname\fP به عنوان نام گراف ایجادشده استفاده می‌شود.
اگر چندین گراف ایجاد شوند، گراف‌های بعدی از نام
\fIgname\fP به همراه یک عدد صحیح الحاق‌شده استفاده می‌کنند.
.TP
.BI \-o "outfile"
خروجی را در فایل \fIoutfile\fP می‌نویسد. در صورت مشخص نشدن، \fBgml2gv\fP
از خروجی استاندارد (stdout) استفاده می‌کند.
.TP
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP 8
.I files
نام فایل‌های حاوی ۱ یا چند گراف در قالب GML.
اگر هیچ عملوند
.I files
مشخص نشده باشد،
از ورودی استاندارد استفاده خواهد شد.
.SH "کدهای بازگشتی (RETURN CODES)"
در صورتی که هیچ مشکلی در حین تبدیل رخ ندهد، مقدار \fB0\fP
و در صورت بروز هرگونه خطا، مقداری غیرصفر بازگردانده می‌شود.
.SH "محدودیت‌ها (LIMITATIONS)"
از آنجا که مدل‌های گراف و گرافیک هر دو قالب GV و GML تفاوت‌های چشمگیری با یکدیگر دارند، تبدیل در بهترین حالت تقریبی است. به ویژه، مشخص نیست که چگونه یال‌های چندگانه در GML از یکدیگر متمایز می‌شوند، بنابراین یال‌های چندگانه در GV بدون هیچ کلید قابل دسترسی برای کاربر ایجاد می‌شوند. همچنین اطلاعات هیچ مشخصه‌ای از دست نمی‌رود؛ به این صورت که هر مشخصه در GML که به معادل‌های GV تبدیل نشده باشد، به عنوان مشخصه در گراف خروجی حفظ می‌شود.
.P
در حال حاضر، 
.B gv2gml
از زیرگراف‌ها و خوشه‌ها پشتیبانی نمی‌کند. علاوه بر این، به نظر نمی‌رسد سازوکار استانداردی برای تعیین مشخصه‌های پیش‌فرض گره و یال در GML وجود داشته باشد، بنابراین مشخصه‌ها برای هر گره و یال تکرار می‌شوند.
.SH "نویسندگان (AUTHORS)"
Emden R. Gansner <erg@research.att.com>
.SH "همچنین ببینید (SEE ALSO)"
dot(1), libcgraph(3)