.TH ptop 1 "30 may 1999" "Free Pascal" "ptop source beautifier"
.SH "نام (NAME)"
ptop \- زیباساز و مرتب‌کننده سورس‌کد پاسکال با قابلیت پیکربندی برای FPC

ریشه نام احتمالاً برگرفته از Pascal\-TO\-Pascal است.

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

.BI ptop [\-v] [\-i indent] [\-b bufsize ][\-c optsfile] <infile> <outfile>

.SH "توضیحات (DESCRIPTION)"

.B ptop
یک
.I "زیباساز سورس‌کد"
کم‌وبیش قابل پیکربندی برای سورس‌های پاسکال، و به‌ویژه موارد پشتیبانی‌شده توسط FPC (که کم‌وبیش با Turbo Pascal یا Delphi 2.0 سازگار هستند) است.
.PP
ابزار ptop متعلق به بسته
.I "FPC utils"
است، که در حال حاضر شامل
.B ppdep
، 
.B h2pas
، 
.B ppudump
و 
.B ppumove
نیز می‌باشد.

.SH "نحوه استفاده (USAGE)"

.B ptop 
اساساً فایل "infile" را دوباره قالب‌بندی کرده و خروجی را در "outfile" می‌نویسد.
این برنامه از یک فایل پیکربندی استفاده می‌کند که در ادامه توضیح داده شده است، و می‌تواند یک فایل پیکربندی پیش‌فرض را برای ویرایش ایجاد کند (در صورت استفاده از مقادیر پیش‌فرض نیازی به آن نیست).

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h
شرح کوتاهی از این گزینه‌ها را چاپ می‌کند.
.TP
.B \-c
خواندن گزینه‌ها از فایل پیکربندی. استفاده از فایل پیکربندی الزامی نیست، در این صورت ptop به مقادیر پیش‌فرض داخلی بازمی‌گردد. همچنین گزینه \-g را ببینید.
.TP
.BI \-i " indent"
تعداد فاصله‌های تورفتگی (indent) مورد استفاده برای بلوک‌های BEGIN END; و سایر بلوک‌ها را تنظیم می‌کند.
.TP
.BI \-b " bufsize"
اندازه بافر را روی bufsize تنظیم می‌کند. پیش‌فرض 255 است، مقدار 0 نامعتبر در نظر گرفته شده و نادیده گرفته می‌شود.
.TP
.B \-v
حالت پرگو (verbose). در حال حاضر تنها تعداد خطوط خوانده‌شده/نوشته‌شده و برخی از پیام‌های خطا را نمایش می‌دهد.
.TP 
.BI \-g " ptop.cfg"
یک فایل پیکربندی پیش‌فرض را برای ویرایش در فایل 
.I ptop.cfg
می‌نویسد.

.PP
با ptop و فایل پیکربندی آن کار کنید تا به قالب دلخواه خود برسید. قابلیت‌های پیکربندی و امکانات ptop در مقایسه با زیباسازهای سورس‌کد اشتراک‌افزاری (shareware) مانند مواردی که در SIMTEL یافت می‌شود، بسیار گسترده است.
.PP

.SH "قدردانی‌ها (ACKNOWLEDGEMENTS)"

نویسنده برنامه، Michael van Canneyt، که در توضیح قالب ptop.cfg نیز یاری رساند.
.PP
پرسش‌ها/اصلاحات را می‌توان به نشانی fpc\-devel@vekoll.saturnus.vein.hu ارسال کرد.
.PP
همچنین با تشکر از سایر اعضای تیم توسعه FPC.

این برنامه نسخه‌ای مدرن‌شده (شیء‌گرایی، استریم‌ها، افزونه‌های دلفی) بر پایه برنامه‌ای از Peter Grogono است، که او نیز برنامه خود را بر پایه برنامه pretty-printer پاسکال نوشته‌شده توسط Ledgard، Hueras و Singer توسعه داده است. به نشریه SIGPLAN Notices، جلد ۱۲، شماره ۷، جولای ۱۹۷۷، صفحات ۱۰۱ تا ۱۰۵ و PP.DOC/HLP مراجعه کنید.
.BR
این نسخه از PP تحت Pascal/Z نگارش V4.0 یا بالاتر توسعه یافته است.
اصلاحات بسیار جزئی برای Turbo Pascal توسط Willett Kempton در مارس ۱۹۸۴ و اکتبر ۸۴ انجام شد. تحت نگارش ۸ بیتی یا ۱۶ بیتی Turbo اجرا می‌شود.
تنظیمات Toad Hall، بازنویسی برای TP 5، مورخ ۲۸ نوامبر ۸۹.


.SH "همچنین ببینید (SEE ALSO)"
.IP "فایل پیکربندی ptop"
.BR ptop.cfg (5)
.IP "کامپایلر"
.BR  ppc386 (1)
.IP "سایر ابزارهای FPC"
.BR  ppdep (1)
.BR  ppudump (1)
.BR  ppumove (1)
.BR  h2pas (1)