perltidyp - آنلاین در ابر

برنامه:

نام

perltidy - یک تورفتگی اسکریپت پرل و اصلاح کننده

خلاصه

perltidy [ گزینه ها ] file1 file2 file3 ...
(خروجی به file1.tdy، file2.tdy، file3.tdy، ... می رود)
perltidy [گزینه ها] file1 -o outfile
perltidy [گزینه ها] file1 -st >outfile
perltidy [گزینه ها] مجموعه

شرح

Perltidy یک اسکریپت پرل را می خواند و یک اسکریپت تورفتگی و فرمت مجدد می نویسد.

بسیاری از کاربران اطلاعات کافی را در "EXAMPLES" برای شروع پیدا خواهند کرد. کاربران جدید ممکن است
از آموزش کوتاهی که می توانید در آن پیدا کنید بهره مند شوید
http://perltidy.sourceforge.net/tutorial.html

یک کمک راحت برای تعریف سیستماتیک مجموعه ای از پارامترهای سبک را می توان در اینجا یافت
http://perltidy.sourceforge.net/stylekey.html

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

هنگامی که -html پرچم داده شده است، خروجی از طریق یک قالب‌کننده HTML ارسال می‌شود
در "HTML OPTIONS" توضیح داده شده است.

مثال ها

perltidy somefile.pl

با این کار یک فایل تولید می شود somefile.pl.tdy حاوی اسکریپت فرمت مجدد با استفاده از
گزینه‌های پیش‌فرض، که تقریباً به سبک پیشنهادی در آن است پرلاستایل(1). فایل منبع
somefile.pl بدون تغییر است.

perltidy *.pl

اجرای perltidy در همه 'Ow' آنترل فایل های موجود در فهرست فعلی با گزینه های پیش فرض. در
خروجی در فایل هایی با یک ضمیمه خواهد بود .tdy افزونه. برای هر فایلی با خطا،
یک فایل با پسوند وجود خواهد داشت .ERR.

perltidy -b file1.pl file2.pl

تغییر دادن file1.pl و file2.pl در جای خود قرار دهید و از نسخه های اصلی نسخه پشتیبان تهیه کنید file1.pl.bak و
file2.pl.bak. اگر file1.pl.bak و / یا file2.pl.bak در حال حاضر وجود دارند، خواهند بود
رونویسی شده است.

perltidy -b -bext='/' file1.pl file2.pl

مانند مثال قبلی به جز فایل های پشتیبان file1.pl.bak و file2.pl.bak
در صورت عدم وجود خطا حذف خواهد شد.

perltidy -gnu somefile.pl

اجرای perltidy روی فایل somefile.pl با سبکی که به کدگذاری گنو تقریبی دارد
استانداردهای برنامه های C خروجی خواهد بود somefile.pl.tdy.

perltidy -i=3 somefile.pl

اجرای perltidy روی فایل somefile.pl، با 3 ستون برای هر سطح از تورفتگی (-i=3)
به جای 4 ستون پیش فرض هیچ برگه ای در اسکریپت فرمت مجدد وجود نخواهد داشت،
به جز مواردی که قبلاً در نظرات، اسناد pod، نقل قول ها و اسناد اینجا وجود دارد.
خروجی خواهد بود somefile.pl.tdy.

perltidy -i=3 -et=8 somefile.pl

مانند مثال قبلی، با این تفاوت که فضای سفید اصلی با یک برگه درج می شود
کاراکتر در هر 8 فاصله

perltidy -ce -l=72 somefile.pl

اجرای perltidy روی فایل somefile.pl با همه پیش‌فرض‌ها به جز استفاده از «نوع دیگر» (-جایی)
و حداکثر طول خط 72 ستون (-l=72) به جای 80 ستون پیش فرض.

perltidy -g somefile.pl

اجرای perltidy روی فایل somefile.pl و یک فایل لاگ ذخیره کنید somefile.pl.LOG که نشان می دهد
قرار دادن پرانتز، پرانتز و براکت مربع در ابتدای هر خط.

perltidy -html somefile.pl

با این کار یک فایل تولید می شود somefile.pl.html حاوی اسکریپت با نشانه گذاری html. در
فایل خروجی شامل یک شیوه نامه تعبیه شده در بخش قابل ویرایش
برای تغییر ظاهر

perltidy -html -css=mystyle.css somefile.pl

با این کار یک فایل تولید می شود somefile.pl.html حاوی اسکریپت با نشانه گذاری html. این
فایل خروجی حاوی پیوندی به یک فایل شیوه نامه جداگانه خواهد بود mystyle.css. اگر فایل
mystyle.css وجود ندارد، ایجاد خواهد شد. اگر وجود داشته باشد، رونویسی نمی شود.

perltidy -html -pre somefile.pl

یک قطعه html فقط با بخش PRE بنویسید somefile.pl.html. این زمانی مفید است که
قطعه کد برای گنجاندن در یک صفحه وب بزرگتر فرمت می شود. هیچ شیوه نامه ای این کار را نخواهد کرد
در این مورد نوشته شود.

perltidy -html -ss >mystyle.css

یک شیوه نامه بنویسید mystyle.css و خارج شوید.

perltidy -html -frm mymodule.pm

html را با کادری که فهرست مطالب و کد منبع را در خود جای داده است بنویسید. فایل های خروجی
خواهد بود mymodule.pm.html (قاب)، mymodule.pm.toc.html (فهرست مطالب)، و
mymodule.pm.src.html (کد منبع).

OPTIONS - بررسی اجمالی

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

برای هر پارامتر، یک نام طولانی و یک نام کوتاه وجود دارد. نام های کوتاه راحت هستند
برای ورودی صفحه کلید، در حالی که نام های طولانی خود مستند هستند و بنابراین در آنها مفید هستند
اسکریپت ها استفاده از دو خط تیره برای نام های طولانی مرسوم است، اما ممکن است از یکی استفاده شود.

اکثر پارامترهایی که به عنوان پرچم‌های روشن/خاموش عمل می‌کنند را می‌توان با یک "n" اصلی (برای
نام کوتاه) یا یک "نه" یا "نه-" (برای نام طولانی). به عنوان مثال، پرچم به
نقل قول های بلند بیرونی است -الق or - نقل قول های بیرونی-طولانی. پرچم برای رد شدن از این است -nolq or
--nooutdent-long-quotes or --بدون نقل قول های بیرونی-طولانی.

ممکن است گزینه ها با هم جمع نشوند. به عبارت دیگر گزینه ها -q و -g ممکن است وارد نشود
as -qg.

تا زمانی که نام گزینه ها به طور منحصر به فرد شناسایی شوند، ممکن است زودتر فسخ شوند. برای
به عنوان مثال، به جای --dump-token-types، برای ورود کافی است --dump-tok، یا
حتی --dump-t، برای شناسایی منحصر به فرد این دستور.

I / O کنترل
پارامترهای زیر مربوط به فایل هایی است که خوانده و نوشته می شوند.

-h, --کمک
نمایش خلاصه استفاده و خروج.

-o=نام فایل، -- outfile=نام فایل
نام فایل خروجی (فقط اگر یک فایل ورودی در حال پردازش باشد). اگر نه
فایل خروجی مشخص شده است و خروجی به خروجی استاندارد هدایت نمی شود (نگاه کنید به
-ست، خروجی به نام filen.tdy. [توجه: - به استاندارد تغییر مسیر نمی دهد
خروجی استفاده کنید -ست بجای.]

-ست, - خروجی استاندارد
Perltidy باید بتواند روی تعداد زیادی فایل به صورت دلخواه کار کند
اجرا شود، با هر خروجی به یک فایل خروجی متفاوت هدایت شود. بدیهی است که این خواهد شد
با خروجی به دستگاه خروجی استاندارد تضاد دارد، بنابراین یک پرچم خاص، -ست,
برای درخواست خروجی به خروجی استاندارد مورد نیاز است. مثلا،

perltidy somefile.pl -st >somefile.new.pl

این گزینه فقط در صورتی قابل استفاده است که فقط یک فایل ورودی وجود داشته باشد. پیش فرض است
-nst or - خروجی غیر استاندارد.

-se, - خروجی خطای استاندارد
اگر perltidy هنگام پردازش فایل خطایی را تشخیص دهد somefile.pl، رفتار پیش فرض آن است
برای نوشتن پیام های خطا در فایل somefile.pl.ERR. استفاده از -se برای ایجاد تمام پیام های خطا
به جای آن به جریان خروجی خطای استاندارد ارسال شود. این بخشنامه ممکن است نفی شود
با -nse. بنابراین، شما ممکن است قرار دهید -se در .perltidyrc و در صورت تمایل آن را لغو کنید
-nse در خط فرمان

خارج=بعدی، --output-file-extension=بعدی
پسوند فایل خروجی را تغییر دهید EXT به جای پیش فرض tdy (و یا اچ تی ام ال
در صورتی که --html گزینه استفاده می شود). به «تعیین پسوندهای فایل» مراجعه کنید.

-اپات= مسیر، --مسیر خروجی= مسیر
هنگامی که perltidy یک نام فایل برای یک فایل خروجی ایجاد می کند، به طور پیش فرض فقط یک فایل را اضافه می کند
پسوند مسیر و نام پایه فایل ورودی. این پارامتر باعث ایجاد مسیر می شود
به تغییر کند مسیر به جای آن.

مسیر باید به یک کاراکتر جداکننده مسیر معتبر ختم شود، اما perltidy سعی خواهد کرد اضافه کند
یکی اگر گم شده باشد

مثلا

perltidy somefile.pl -opath=/ tmp /

تولید خواهد کرد /tmp/somefile.pl.tdy. در غیر این صورت، somefile.pl.tdy در هر چیزی ظاهر خواهد شد
دایرکتوری حاوی somefile.pl.

اگر مسیر حاوی فاصله باشد، باید در گیومه قرار گیرد.

اگر خروجی به خروجی استاندارد یا if هدایت شود، این پارامتر نادیده گرفته می شود
به صراحت با -o=s پارامتر.

-b, --پشتیبان گیری-و-تغییر-درجا
فایل یا فایل های ورودی را در جای خود تغییر دهید و نسخه اصلی را با پسوند ذخیره کنید .bak.
هر موجود .bak فایل حذف خواهد شد برای تغییر نسخه پشتیبان پیش فرض به آیتم بعدی مراجعه کنید
پسوند، و برای حذف کامل فایل پشتیبان.

A -b اگر ورودی از ورودی استاندارد باشد یا به خروجی استاندارد برود، پرچم نادیده گرفته می شود.
یا اگر -html پرچم تنظیم شده است

به ویژه، اگر می خواهید از هر دو استفاده کنید -b پرچم و -pbp
(--perl-best-practices) پرچم، سپس شما باید یک قرار دهید -nst پرچم بعد از -pbp پرچم
زیرا شامل یک -ست پرچم به عنوان یکی از اجزای آن، به این معنی که خروجی خواهد شد
به جریان خروجی استاندارد بروید.

-بکس=بعدی، --پشتیبان-فایل-پسوند=بعدی
این پارامتر دو هدف را دنبال می کند: (1) تغییر پسوند فایل پشتیبان به
چیزی غیر از پیش فرض باشد .bak، و (2) نشان می دهد که فایل پشتیبان وجود ندارد
باید ذخیره شود.

برای تغییر پسوند پیش فرض به چیزی غیر از .bak به "مشخص کردن فایل" مراجعه کنید
برنامه های افزودنی".

یک فایل پشتیبان از منبع همیشه نوشته می شود، اما می توانید درخواست کنید که آن را حذف کنید
در پایان پردازش اگر خطایی وجود نداشت. این خطرناک است مگر اینکه منبع آن باشد
کد با یک سیستم کنترل کد منبع نگهداری می شود.

برای نشان دادن اینکه نسخه پشتیبان باید حذف شود، یک اسلش رو به جلو اضافه کنید. /، در
افزونه. اگر متنی پس از حذف اسلش باقی بماند، برای تعریف استفاده می شود
پسوند فایل پشتیبان (که همیشه ایجاد می شود و فقط در صورت عدم وجود حذف می شود
خطاها).

در اینجا برخی از نمونه ها:

درمان فایل پشتیبان پسوند پسوند
<-bext=bak> F<.bak> نگه دارید (همان رفتار پیش فرض)
<-bext='/'> F<.bak> در صورت نداشتن خطایی حذف کنید
<-bext='/backup'> F<.backup> در صورت نداشتن خطایی حذف کنید
<-bext='original/'> F<.original> در صورت نداشتن خطایی حذف کنید

-w, ---خروجی هشدار
محیط -w باعث می شود هر پیام هشدار غیر مهمی به عنوان خطا گزارش شود. اینها
شامل پیام‌هایی درباره مشکلات احتمالی غلاف، احتمالاً سطح تورفتگی شروع بد،
و احتیاط در مورد استفاده غیر مستقیم از شی. به طور پیش فرض، - or --nowarning-outputاست،
این هشدارها را شامل نشود.

-q, --ساکت
پیام های خطا و بررسی نحو را غیرفعال کنید (برای اجرای تحت ویرایشگر).

به عنوان مثال، اگر از یک ویرایشگر vi-style مانند vim استفاده می کنید، می توانید perltidy را به عنوان یک ویرایشگر اجرا کنید.
فیلتر از داخل ویرایشگر با استفاده از چیزی شبیه به

:n1,n2!perltidy -q

که در آن "n1,n2" متن انتخاب شده را نشان می دهد. بدون -q پرچم، هر پیام خطایی
ممکن است صفحه نمایش شما را به هم بریزد، بنابراین برای استفاده از کلید "Undo" خود آماده باشید.

-لاگ, --ورود به سیستم فایل
ذخیره . LOG فایل، که دارای بسیاری از تشخیص های مفید است. Perltidy همیشه یک ایجاد می کند . LOG
فایل، اما به طور پیش فرض حذف می شود مگر اینکه مشکوک به اشکال برنامه باشد. تنظیم کردن
-لاگ flag فایل log را مجبور می‌کند ذخیره شود.

-g=n, --logfile-gap=n
حداکثر فاصله بین خطوط کد ورودی را در فایل لاگ تنظیم کنید. این هدف از این
flag برای کمک به رفع اشکال خطاهای تودرتو است. مقدار "n" اختیاری است. اگر شما
پرچم را تنظیم کنید -g بدون مقدار "n"، 1 در نظر گرفته می شود، به این معنی که هر
خط در فایل log نوشته می شود. این می تواند مفید باشد اگر شما به دنبال یک
خطای تودرتو پرانتز، پرانتز یا براکت.

محیط -g همچنین باعث می شود که فایل لاگ ذخیره شود، بنابراین لازم نیست که آن را نیز اضافه کنید
-لاگ.

اگر نه -g پرچم داده شده است، مقدار 50 استفاده خواهد شد، به این معنی که حداقل هر 50 ام
خط در لاگ فایل ثبت خواهد شد. این به جلوگیری از فایل های لاگ بیش از حد طولانی کمک می کند.

تنظیم مقدار منفی "n" با تنظیم نکردن یکسان است -g در همه.

-npro --noprofile
هر کدام را نادیده بگیرید .perltidyrc فایل فرمان به طور معمول، perltidy ابتدا در جریان شما به نظر می رسد
دایرکتوری برای a .perltidyrc فایل پارامترها (فرمت در زیر توضیح داده شده است). اگر
یکی را پیدا می‌کند، آن گزینه‌ها را روی مقادیر پیش‌فرض اولیه اعمال می‌کند و سپس آن را اعمال می‌کند
هر چیزی را که در خط فرمان تعریف شده است اعمال می کند. اگر نه .perltidyrc پرونده است
پیدا شد، در فهرست اصلی شما به دنبال یکی می گردد.

اگر تنظیم کنید -npro flag، perltidy به دنبال این فایل نخواهد بود.

-pro=نام فایل or --profile=نام فایل
برای ساده‌سازی تست و تعویض فایل‌های .perltidyrc، ممکن است از این دستور استفاده شود
یک فایل پیکربندی را مشخص کنید که نام پیش فرض .perltidyrc را لغو کند.
نباید در دو طرف علامت '=' فاصله وجود داشته باشد. به عنوان مثال، خط

perltidy -pro=testcfg

باعث ایجاد فایل می شود testcfg به جای پیش فرض استفاده شود .perltidyrc.

نام مسیر با سه نقطه شروع می شود، به عنوان مثال ".../.perltidyrc" نشان می دهد که فایل
باید برای شروع در فهرست فعلی و کار به سمت بالا جستجو شود. این
داشتن چندین پروژه که هر کدام دارای .perltidyrc خاص خود هستند را آسان تر می کند
دایرکتوری های ریشه

-بهترین, -- گزینه های نمایش
لیستی از تمام گزینه های مورد استفاده در را بنویسید . LOG فایل. لطفا ببینید -- گزینه های dump برای
راه ساده تر برای این کار

-f, --force-read-binary
Perltidy را مجبور به پردازش فایل های باینری کنید. برای جلوگیری از تولید پیام های خطای بیش از حد،
perltidy از فایل‌هایی که توسط سیستم به‌عنوان غیر متنی شناسایی شده‌اند پرش می‌کند. با این حال، پرل معتبر است
اسکریپت های حاوی داده های باینری ممکن است گاهی اوقات به عنوان غیر متنی شناسایی شوند و این پرچم
Perltidy را مجبور به پردازش آنها می کند.

قالب بندی OPTIONS

اساسی گزینه
-- بی خبر
این پرچم همه قالب‌بندی‌ها را غیرفعال می‌کند و باعث می‌شود ورودی بدون تغییر در آن کپی شود
خروجی به جز تغییرات احتمالی در کاراکترهای پایان خط و هر پیش و پس
فیلترها این می تواند در رابطه با مجموعه سلسله مراتبی مفید باشد .perltidyrc
فایل ها برای جلوگیری از مرتب کردن کدهای ناخواسته همچنین به "پرش از بخش های انتخاب شده کد" مراجعه کنید
راهی برای جلوگیری از مرتب کردن بخش های خاص کد.

-i=n, --indent-columns=n
از n ستون در هر سطح تورفتگی استفاده کنید (4=n پیش فرض).

-l = n, --maximum-line-length=n
حداکثر طول خط پیش فرض n=80 کاراکتر است. Perltidy سعی خواهد کرد خط را پیدا کند
نقاط شکست برای حفظ خطوط زیر این طول. با این حال، نقل قول های طولانی و نظرات جانبی
ممکن است باعث شود خطوط از این طول بیشتر شود. تنظیمات -l=0 معادل تنظیم است -l = (الف
بزرگ عدد).

-vmll, --variable-maximum-line-length
یک مشکل با استفاده از حداکثر طول خط ثابت با کد بسیار عمیق تو در تو و
ساختارهای داده، زیرا در نهایت مقدار فضای خالی پیشرو برای
نشان دهنده تورفتگی بیشتر یا تمام عرض خط موجود را اشغال می کند و ترک می کند
فضای کمی برای کد یا داده واقعی وجود ندارد. یک راه حل این است که از یک متغیر طولانی استفاده کنید
طول خط. راه حل دیگر استفاده از -vmll پرچم، که اساسا می گوید
perltidy برای نادیده گرفتن فضای سفید پیشرو هنگام اندازه گیری طول خط.

به طور دقیق، زمانی که -vmll پارامتر تنظیم شده است، حداکثر طول خط یک خط از
کد M+L*I خواهد بود، جایی که

M مقدار --maximum-line-length=M (-l=M)، پیش فرض 80 است،
I مقدار --indent-columns=I (-i=I)، پیش فرض 4 است،
L سطح تورفتگی خط کد است

هنگامی که این پرچم تنظیم می شود، انتخاب نقاط شکست برای یک بلوک کد باید باشد
اساساً مستقل از عمق لانه سازی آن است. با این حال، طول خط مطلق،
از جمله فضای سفید پیشرو، هنوز هم می تواند دلخواه بزرگ باشد. این مشکل می تواند باشد
با گنجاندن پارامتر بعدی اجتناب شود.

پیش فرض این است که این کار را انجام ندهید (-nvmll).

-wc=n, --whitespace-cycle=n
این پرچم همچنین مشکلات مربوط به کدهای بسیار عمیق تو در تو و ساختارهای داده را برطرف می کند.
زمانی که عمق تودرتو از مقدار بیشتر شود n فضای سفید پیشرو کاهش خواهد یافت و
دوباره از عمق 1 شروع کنید. نتیجه این است که بلوک‌های کد به کد باز می‌گردند
به جای حرکت خودسرانه به سمت راست به سمت چپ. این به صورت چرخه ای برای هر فرد رخ می دهد
عمق.

برای مثال اگر یک سطح از تورفتگی برابر با 4 فاصله باشد (-i=4، پیش فرض)، و یکی
استفاده -wc=15، اگر فضای سفید پیشرو در یک خط از حدود 4*15=60 بیشتر شود، آن را خالی می کند
به فاصله 4*1=4 کاهش می یابد و از آنجا به افزایش ادامه می دهد. اگر
فضای خالی هرگز از این حد تجاوز نمی کند و قالب بندی بدون تغییر باقی می ماند.

ترکیبی از -vmll و -wc=n راه حلی برای مشکل نمایش ارائه می دهد
هر چند ساختارهای داده و کدهای خودسرانه عمیق در یک پنجره محدود -wc=n می از
البته بدون استفاده شود -vmll.

پیش‌فرض استفاده نکردن از این است که می‌توان با استفاده از آن نیز نشان داد -wc=0.

زبانه ها
استفاده از کاراکترهای برگه تقریباً مطمئناً به قابلیت حمل و نگهداری در آینده منجر می شود
مشکلات، بنابراین پیش فرض و توصیه این است که از آنها استفاده نکنید. برای کسانی که ترجیح می دهند
تب ها، با این حال، دو گزینه متفاوت وجود دارد.

به جز معرفی احتمالاً کاراکترهای تورفتگی برگه، همانطور که در زیر ذکر شده است،
perltidy هیچ کاراکتر برگه ای را به فایل شما وارد نمی کند و هر تبی را حذف می کند
از کد (مگر اینکه درخواست شده باشد که با -fws). اگر هر برگه ای در خود دارید
نظرات، نقل قول ها یا اسناد اینجا باقی خواهند ماند.

-et=n, --entab-leading-whitespace
این پرچم باعث هر n کاراکترهای فضای اولیه باید با یک برگه جایگزین شوند
شخصیت. توجه داشته باشید که عدد صحیح n کاملا مستقل از عدد صحیح است
برای پارامتر تورفتگی مشخص شده است، -i=n.

-t, -- زبانه ها
این پرچم باعث می شود که برای هر سطح یک کاراکتر برگه اصلی درج شود
تورفتگی برخی از ویژگی های دیگر با این گزینه ناسازگار هستند، و اگر
این گزینه ها نیز داده می شود، سپس یک پیام هشدار صادر می شود و این پرچم
تنظیم نخواهد شد. یک مثال این است -lp گزینه.

-dt=n, --default-tabsize=n
اگر خط اول کد ارسال شده به perltidy حاوی برگه های اصلی باشد اما هیچ تبی ندارد
طرح برای جریان خروجی مشخص شده است، سپس perltidy باید چند فاصله را حدس بزند
مربوط به هر برگه پیشرو است. این تعداد فضا n مربوط به هر کدام
زبانه اصلی جریان ورودی ممکن است با مشخص شود -dt=n. پیش فرض است n = 8.

اگر یک طرح برگه برای جریان خروجی مشخص شده باشد، این پرچم هیچ تاثیری ندارد.
زیرا در این صورت فرض می شود که جریان ورودی از همان طرح برگه استفاده می کند و
فضاهای تورفتگی مانند جریان خروجی (هر فرض دیگری منجر به
ویرایش ناپایدار).

-Syn, - بررسی نحو
این پرچم باعث می شود که perltidy "perl -c -T" را برای بررسی نحو ورودی و خروجی اجرا کند.
(برای تغییر پرچم های ارسال شده به perl، مورد بعدی را ببینید، -pscf). نتایج هستند
نوشته شده به . LOG فایلی که در صورت تشخیص خطا در خروجی ذخیره می شود
اسکریپت اگر اسکریپت ورودی دارای خطای نحوی باشد، اسکریپت خروجی بررسی نمی شود.
Perltidy بررسی خود را انجام می دهد، اما این گزینه از perl برای دریافت یک "ثانیه" استفاده می کند
نظر".

اگر پرل خطاهایی را در فایل ورودی گزارش کند، در خطا گزارش نمی شود
خروجی مگر اینکه ---خروجی هشدار پرچم داده شده است.

پیش فرض این است نه برای انجام این نوع بررسی نحوی (اگرچه perltidy همچنان انجام خواهد داد
تا حد امکان خودآزمایی کنید). دلیل آن این است که باعث ایجاد تمام کدها در BEGIN می شود
بلوک هایی که برای همه ماژول های مورد استفاده اجرا می شوند، و این دری را به روی امنیت باز می کند
مسائل و حلقه های بی نهایت در هنگام اجرای perltidy.

-pscf=s, -perl-syntax-check-flags=s
هنگامی که perl برای بررسی نحو فراخوانی می شود، پرچم های عادی "-c -T" هستند. علاوه بر این، اگر
la -x پرچم به perltidy داده می شود، سپس perl نیز a تصویب می شود -x پرچم. باید
به طور معمول نیازی به تغییر این پرچم ها نیست، اما می توان این کار را با آن انجام داد -pscf=s
پرچم. برای مثال، اگر پرچم لکه دار، "-T" مورد نظر نباشد، می توان پرچم را روی آن تنظیم کرد
عادل باشید -pscf=-c.

Perltidy رشته شما را به perl ارسال می کند با این استثنا که a اضافه می کند -c و -x
در صورت مناسب بودن را . LOG فایل دقیقا نشان می دهد که چه پرچم هایی به perl منتقل شده اند.

-io, ---فقط تورفتگی
این پرچم برای غیرفعال کردن تمام قالب‌بندی‌ها و تغییرات شکست خط در غیر خالی استفاده می‌شود
خطوط کد هنگامی که اجرا می شود، تنها تغییر در اسکریپت خواهد بود
تورفتگی و خطوط خالی و هر پرچمی که فضای سفید و خطوط جدید را کنترل کند، این کار را انجام خواهد داد
نادیده گرفته شود. اگر کاملاً از کار خود راضی هستید، ممکن است بخواهید از این استفاده کنید
فضای خالی و خط شکسته می‌شوند و فقط perltidy را می‌خواهند تا تورفتگی را مدیریت کند. (این
همچنین سرعت perltidy را تا ضریب دو افزایش می دهد، بنابراین ممکن است زمانی مفید باشد
از perltidy صرفاً برای کمک به یافتن یک خطای بریس در یک اسکریپت بزرگ استفاده می شود).

تنظیم این پرچم معادل تنظیم است --freeze-newlines و -- انجماد-فضای سفید.

اگر همچنین می خواهید خطوط خالی موجود خود را دقیقاً همانطور که هستند حفظ کنید، می توانید اضافه کنید
--تجمیع-خطوط خالی.

-ole=s, --output-line-ending=s
جایی که s="win"، "dos"، "unix" یا "mac". این پرچم به خط خروجی perltidy می گوید
پایان برای یک سیستم خاص به طور معمول، perltidy فایل ها را با خط می نویسد
شخصیت جداکننده سیستم میزبان پرچم "برد" و "dos" یکسان است
نتيجه

-پل, --حفظ-خط-انتها
این پرچم به perltidy می گوید که فایل های خروجی خود را با همان انتهای خط بنویسد
در صورت امکان فایل ورودی باید برای داس, یونیکسو مک انتهای خط خواهد شد
فقط در صورتی کار می کند که ورودی perltidy از نام فایل (به جای stdin، برای مثال) باشد.
اگر perltidy در تعیین پایان خط فایل ورودی مشکل داشته باشد، به حالت باز می گردد
رفتار پیش فرض استفاده از انتهای خط سیستم میزبان.

-it=n, -- تکرار = n
این پرچم باعث می شود perltidy انجام دهد n تکرارهای کامل دلیل این پرچم است
که زیباسازی کد یک فرآیند تکراری و در برخی موارد خروجی از آن است
اگر برای بار دوم استفاده شود، perltidy می تواند متفاوت باشد. برای اکثر اهداف
پیش فرض از n = 1 باید رضایت بخش باشد با این حال n = 2 می تواند مفید باشد زمانی که یک سبک اصلی
تغییر در حال انجام است، یا زمانی که کد هنگام ورود به کد منبع زیبا می شود
سیستم کنترل. مشخص شده است که بعد از تغییر خروجی بسیار نادر است
2 تکرار. اگر یک مقدار n بزرگتر از 2 ورودی است سپس یک آزمون همگرایی خواهد بود
برای متوقف کردن تکرارها در اسرع وقت، تقریباً همیشه پس از 2 تکرار استفاده می شود.
برای کنترل تکرار ساده، مورد بعدی را ببینید.

وقتی از perltidy برای تولید html استفاده می شود، این پرچم هیچ تاثیری ندارد.

-تبدیل, -- همگرا شدن
این پرچم معادل است -it=4 و برای ساده کردن کنترل تکرار گنجانده شده است. برای
همه اهداف عملی را انجام می دهد یا نمی خواهد مطمئن شود که خروجی است
همگرا هستند، و هیچ مجازاتی برای استفاده از یک محدودیت تکرار بزرگ از زمان perltidy وجود ندارد
همگرایی را بررسی می کند و در اسرع وقت تکرار را متوقف می کند. پیش فرض است
-nconv (بدون بررسی همگرایی). استفاده كردن -تبدیل زمان اجرا تقریباً دو برابر خواهد شد
معمولاً یک تکرار اضافی برای تأیید همگرایی مورد نیاز است.

رمز افتادن کنترل
-ci=n, --continuation-indentation=n
تورفتگی ادامه، فضاهای تورفتگی اضافی است که در صورت وجود یک خط طولانی اعمال می شود
شکسته شده. پیش فرض n=2 است که در اینجا نشان داده شده است:

سطح $ من = # -ci=2
( $max_index_to_go >= 0 ) ? $levels_to_go[0] : $last_output_level;

همان مثال، با n=0، خواندن کمی سخت تر است:

سطح $ من = # -ci=0
( $max_index_to_go >= 0 ) ? $levels_to_go[0] : $last_output_level;

ارزش داده شده به -این همچنین توسط برخی از دستورات زمانی که فضای کوچک مورد نیاز است استفاده می شود.
به عنوان مثال دستوراتی برای بیرون کشیدن برچسب ها، -اولاو کلمات کلیدی را کنترل کنید، -اوکی.

هنگامی که از مقادیر پیش فرض استفاده نمی شود، پیشنهاد می شود که مقدار n داده شده با -ci=n be
بیش از نیمی از تعداد فضاهای اختصاص داده شده به یک تورفتگی کامل نیست
سطح در -i=n فرمان

-sil=n --starting-indentation-level=n
به طور پیش فرض، perltidy فایل ورودی را بررسی می کند و سعی می کند شروع را تعیین کند
سطح تورفتگی در حالی که اغلب صفر است، ممکن است برای یک قطعه کد صفر نباشد
در حال ارسال از یک جلسه ویرایش

برای حدس زدن سطح تورفتگی شروع، perltidy به سادگی آن فرورفتگی را فرض می کند
طرح مورد استفاده برای ایجاد قطعه کد همان است که برای جریان استفاده می شود
فرآیند perltidy این تنها حدس معقولی است که می توان انجام داد. باید باشد
اگر این درست باشد تصحیح کنید، اما در غیر این صورت احتمالا اینطور نخواهد شد. به عنوان مثال، اگر ورودی
اسکریپت با -i=2 نوشته شده است و پرچم های peltidy فعلی دارای -i=4 هستند، اشتباه است
تورفتگی اولیه برای قطعه کدی که حروف اول غیر صفر دارد حدس زده می شود
تورفتگی به همین ترتیب، اگر از یک طرح Entabing در اسکریپت ورودی استفاده شود و نه در
روند فعلی پس از آن تورفتگی حدس زده اشتباه خواهد بود.

اگر روش پیش فرض به درستی کار نمی کند یا می خواهید شروع را تغییر دهید
سطح، استفاده -sil=n، برای مجبور کردن سطح شروع به n باشد.

فهرست تورفتگی با استفاده از -lp, - پرانتزهای خطی
به طور پیش‌فرض، تورفتگی‌های perltidy با 4 فاصله یا هر مقداری که با آن مشخص شده است فهرست می‌شود
-i=n. در اینجا یک لیست کوچک است که به این شکل قالب بندی شده است:

# perltidy (پیش‌فرض)
@month_of_year = (
'ژان'، 'فوریه'، 'مار'، 'آوریل'، 'مه'، 'ژوئن'،
«ژوئیه»، «اوت»، «سپتامبر»، «اکتبر»، «نوامبر»، «دسامبر»
);

استفاده از -lp پرچم گذاری کنید تا تورفتگی اضافی اضافه کنید تا باعث شود داده ها از باز شدن گذشته شروع شوند
پرانتز یک فراخوان یا فهرست فرعی، یا باز کردن براکت مربع از یک آرایه ناشناس، یا
باز کردن بریس مجعد یک هش ناشناس. با این گزینه، لیست بالا خواهد بود
تبدیل شدن به:

# perltidy -lp
@month_of_year = (
'ژان'، 'فوریه'، 'مار'، 'آوریل'، 'مه'، 'ژوئن'،
«ژوئیه»، «اوت»، «سپتامبر»، «اکتبر»، «نوامبر»، «دسامبر»
);

اگر طول خط موجود باشد (نگاه کنید به -l = n ) این فضای زیادی را اجازه نمی دهد، perltidy
کمتر استفاده خواهد کرد. برای قرار دادن جایگزین پرانتز بسته، بخش بعدی را ببینید.

این گزینه روی BLOCKS کد تاثیری ندارد، مانند بلوک های if/then/else که همیشه
از هر چیزی که با آن مشخص شده است استفاده کنید -i=n. همچنین، وجود شکست خط و/یا بلوک
نظرات بین پرانتز باز و بسته ممکن است به طور موقت باعث پرلتیدی شود
به روش پیش فرض خود برگردد.

توجه داشته باشید: -lp گزینه ممکن است همراه با استفاده نشود -t گزینه Tabs ممکن است،
با این حال، با استفاده شود -et=n روش تب

علاوه بر این، هر پارامتری که به طور قابل توجهی توانایی perltidy را محدود می کند
انتخاب خطوط جدید در تضاد با -lp و باعث خواهد شد -lp غیرفعال شود. اینها
شامل -io, -fnl, -نانلو -ndnl. دلیل آن این است که -lp سبک تورفتگی می تواند
به هماهنگی دقیق تعداد دلخواه نقاط شکست نیاز دارد
لیست های سلسله مراتبی، و این پرچم ها ممکن است از آن جلوگیری کنند.

-cti = n, --closing-token-indentation
La -cti = n flag تورفتگی خطی که با ")"، "]"، یا a شروع می شود را کنترل می کند
غیر مسدود کردن "}". چنین خطی دریافت می کند:

-cti = 0 بدون تورفتگی اضافی (پیش‌فرض)
-cti = 1 تورفتگی اضافی به طوری که نشانه بسته شدن
با توکن افتتاحیه آن هماهنگ است.
-cti = 2 یک سطح تورفتگی اضافی اگر خط به نظر می رسد:
) یا ]؛ یا }؛
-cti = 3 یک سطح تورفتگی اضافی همیشه

پرچم ها -cti = 1 و -cti = 2 به خوبی با -lp پرچم (بخش قبلی).

# perltidy -lp -cti=1
@month_of_year = (
'ژان'، 'فوریه'، 'مار'، 'آوریل'، 'مه'، 'ژوئن'،
«ژوئیه»، «اوت»، «سپتامبر»، «اکتبر»، «نوامبر»، «دسامبر»
);

# perltidy -lp -cti=2
@month_of_year = (
'ژان'، 'فوریه'، 'مار'، 'آوریل'، 'مه'، 'ژوئن'،
«ژوئیه»، «اوت»، «سپتامبر»، «اکتبر»، «نوامبر»، «دسامبر»
);

این پرچم‌ها صرفاً اشاره‌ای به فرمت‌کننده هستند و ممکن است همیشه دنبال نشوند. که در
به طور خاص، اگر -lp استفاده نمی شود، تورفتگی برای cti=1 مقید به بودن است
بیش از یک سطح تورفتگی نباشد.

در صورت تمایل، این کنترل را می توان به طور مستقل برای هر یک از محفظه های بسته کننده اعمال کرد
انواع توکن در حقیقت، -cti = n صرفاً مخفف آن است -cpi=n -csbi=n -cbi=n,
که در آن: -cpi or --closing-paren-indentation گروه شاهد )، -csbi or
-- بسته شدن - مربع - براکت - تورفتگی گروه شاهد ]، -cbi or --بسته-بند-تورفتگی
غیر بلوک را کنترل می کند }'s

-icp, --indent-closing-paren
La -icp پرچم معادل است -cti = 2، در بخش قبل توضیح داده شد. در -نیک
پرچم معادل است -cti = 0. آنها برای سازگاری با عقب گنجانده شده اند.

-icb, -- تورفتگی-بستن-پرانتز
La -icb گزینه یک سطح اضافی از تورفتگی به یک مهاربند می دهد که به a خاتمه می دهد
بلوک کد . مثلا،

اگر ($task) {
yy();
} # -icb
دیگر {
zzz();
}

پیش فرض این است که این کار را انجام ندهید که با نشان داده شده است -nicb.

-الق, - نقل قول های بیرونی-طولانی
چه زمانی -الق مجموعه ای است، خطوطی که یک رشته نقل قول طولانی تر از مقدار است حداکثر خط-
طول برای خوانایی بیشتر، تورفتگی آنها حذف خواهد شد. این است
پیش فرض برای جلوگیری از چنین بیرون زدگی، استفاده کنید -nolq or --nooutdent-long-lines.

-اول, --خطوط بیرونی
این دستور معادل است - نقل قول های بیرونی-طولانی و -- نظرات طولانی-بیگانهو
برای سازگاری با نسخه های قبلی perltidy گنجانده شده است. نفی
این نیز کار می کند، -نول or --nooutdent-long-lines، و معادل تنظیم است -nolq
و -nolc.

برچسب های بیرون زده: -اولا, --برچسب های بیرونی
این دستور باعث می شود که برچسب ها با 2 فاصله (یا هر چیز دیگری) بزرگ شوند -این بوده است
تنظیم کنید)، در صورت امکان. این پیش فرض است. مثلا:

$i من
حلقه: while ($i = ) {
chomp($i);
بعدی مگر اینکه $i;
FIXIT ($ I) ؛
}

استفاده کنید -نولا به برچسب های برجسته نیست.

کلمات کلیدی برجسته
-اوکی, - کلیدواژه های بیرونی
دستور -اوکی باعث می‌شود برخی از کلیدواژه‌های کنترلی پیشرو با 2 بزرگتر شوند
فضاها (یا هر چیز دیگری -این تنظیم شده است)، در صورت امکان. به طور پیش فرض، این کلمات کلیدی
عبارتند از "Redo"، "next"، "Last"، "Goto" و "Return". قصد این است که اینها را بسازند
کنترل کلمات کلیدی آسان تر برای دیدن برای تغییر این لیست از کلمات کلیدی که قدیمی هستند،
بخش بعدی را ببینید

به عنوان مثال، استفاده از "perltidy -okw" در مثال قبلی نشان می دهد:

$i من
حلقه: while ($i = ) {
chomp($i);
بعدی مگر اینکه $i;
FIXIT ($ I) ؛
}

پیش فرض این است که این کار را انجام ندهید.

تعیین کلمات کلیدی خارج شده: -okwl=رشته, --outdent-keyword-list=رشته
از این دستور می توان برای تغییر کلیدواژه هایی استفاده کرد که با -اوکی
فرمان پارامتر رشته یک لیست مورد نیاز از کلمات کلیدی پرل است که باید
در صورت وجود بیش از یک نقل قول قرار داده شود. به خودی خود هیچگونه ایجاد نمی کند
بیرونی رخ می دهد، بنابراین -اوکی دستور همچنان مورد نیاز است.

به عنوان مثال، دستورات "-okwl="next last redo goto" -okw" باعث این چهار مورد می شود
کلمات کلیدی باید منسوخ شوند قرار دادن هر کدام احتمالا ساده ترین است -اوکول فرمان در a
.perltidyrc فایل.

فضای سفید کنترل
فضای خالی به فضای خالی بین متغیرها، عملگرها و سایر نشانه های کد اشاره دارد.

-fws, -- انجماد-فضای سفید
این پرچم باعث می‌شود که فضای خالی اصلی شما بدون تغییر باقی بماند و بقیه موارد ایجاد شود
دستورات فضای خالی در این بخش، بخش تورفتگی کد و نظر
بخش کنترل نادیده گرفته شود.

سفت بودن پرانتزهای مجعد، پرانتز و براکت های مربعی.
در اینجا اصطلاح "سفت" به معنای نزدیکی است که با آن جفت محصور شده است
نشانه ها، مانند پرانتز، حاوی مقادیر داخل هستند. مقدار عددی 0،
1 یا 2 سفتی را مشخص می کند که 0 کمترین سفت بودن و 2 تنگ ترین است.
فضاهای درون کانتینرها همیشه متقارن هستند، بنابراین اگر بعد از "(" فاصله ای وجود داشته باشد، پس
یک فاصله قبل از ")" مربوطه وجود خواهد داشت.

La -pt=n or --paren-tightness=n پارامتر فضای درون پرانتز را کنترل می کند. را
مثال زیر تأثیر سه مقدار ممکن، 0، 1 و 2 را نشان می دهد:

if ( ( my $len_tab = length( $tabstr ) ) > 0 ) { # -pt=0
if ( ( my $len_tab = length($tabstr) ) > 0 ) { # -pt=1 (پیش‌فرض)
if ((my $len_tab = length($tabstr)) > 0) { # -pt=2

وقتی n 0 باشد، همیشه یک فاصله در سمت راست «(» و در سمت چپ «)» وجود دارد.
برای n=2 هرگز فاصله وجود ندارد. برای n=1، پیش فرض، یک فاصله وجود دارد مگر اینکه
کمیت در پرنس یک نشانه واحد است، مانند یک شناسه یا یک رشته نقل قول.

به همین ترتیب، پارامتر -sbt=n or --square-bracket-tightness=n فضا را کنترل می کند
در داخل پرانتز، همانطور که در زیر نشان داده شده است.

$width = $col[ $j + $k ] - $col[ $j ]; # -sbt=0
$width = $col[ $j + $k ] - $col[$j]; # -sbt=1 (پیش‌فرض)
$width = $col[$j + $k] - $col[$j]; # -SBT = 2

مهاربندهای فرفری که حاوی بلوک های کد نیستند توسط پارامتر کنترل می شوند -bt = n or
-- پرانتز-سفتی=n.

$obj->{ $parsed_sql->{ 'table' [0] }; # -bt=0
$obj->{ $parsed_sql->{'table'}[0] }; # -bt=1 (پیش‌فرض)
$obj->{$parsed_sql->{'table'}[0]}; # -bt=2

و در نهایت، بریس های فرفری که حاوی بلوک های کد هستند توسط پارامتر کنترل می شوند
-bbt=n or --block-brace-tightness=n همانطور که در مثال زیر نشان داده شده است.

%bf = نقشه { $_ => -M $_ } grep { /\.deb$/ } dirents '.'; # -bbt=0 (پیش‌فرض)
%bf = نقشه { $_ => -M $_ } grep {/\.deb$/} dirents '.'; # -bbt=1
%bf = نقشه {$_ => -M $_} grep {/\.deb$/} dirents '.'; # -bbt=2

برای ساده کردن ورودی در صورتی که همه پرچم‌های تنگی دارای یک مقدار باشند ،
پارامتر <-act=n> یا -همه کانتینرها-محکم = n مخفف
ترکیب <-pt=n -sbt=n -bt=n -bbt=n>.

-tso, ---اپراتورهای محرمانه
پرچم -tso باعث می شود توالی های نشانه پرل خاصی (عملگرهای مخفی) که ممکن است باشند
به عنوان یک اپراتور منفرد در نظر گرفته می شود که باید "محکم" (بدون فاصله) قالب بندی شود. را
اپراتورهایی که در حال حاضر توسط این پرچم اصلاح شده اند عبارتند از:

0+ +0 ()x!! ~~<> ,=> =( )=

به عنوان مثال دنباله 0 +، که یک رشته را به عدد تبدیل می کند، فرمت می شود
بدون فاصله: 0+ وقتی که -tso پرچم تنظیم شده است این علامت به طور پیش فرض خاموش است.

-sts, --فضا-پایانه-نقطه ویرگول
برخی از برنامه نویسان یک فاصله را قبل از تمام نقطه ویرگول های پایانی ترجیح می دهند. پیش فرض برای هیچ است
چنین فضایی، و با نشان داده شده است -nsts or --nospace-terminal-semicolon.

$i = 1 ; # - sts
$i = 1; # -nsts (پیش‌فرض)

-sfs, --فضا برای نقطه ویرگول
نقطه ویرگول در داخل برای حلقه ها ممکن است گاهی اوقات به سختی دیده شوند، به خصوص زمانی که کاما هستند
نیز وجود دارد. این گزینه فضاهایی را در دو طرف این نقطه ویرگول های خاص قرار می دهد.
و پیش فرض است. استفاده کنید -nsfs or --nospace-for-semi-colon برای غیرفعال کردن آن

برای ( @a = @$ap, $u = shift @a ; @a ; $u = $v ) { # -sfs (پیش‌فرض)
برای ( @a = @$ap, $u = shift @a; @a; $u = $v ) { # -nsfs

صعودی, --افزودن نقطه ویرگول
محیط صعودی به perltidy اجازه می دهد تا هر نقطه ویرگول اختیاری گم شده را در انتهای a اضافه کند
خطی که در خط بعدی یک بریس مجعد بسته می شود. این است
پیش فرض، و ممکن است با غیر فعال شود -nasc or --noadd-نقطه ویرگول.

-dsm, --حذف-نقطه ویرگول
محیط -dsm به perltidy اجازه می دهد تا نیم ویرگول های اضافی را که به سادگی خالی هستند حذف کند
بیانیه. این پیش فرض است و ممکن است با آن غیرفعال شود -ndsm or
--nodelete-نقطه ویرگول. (البته در صورت حذف چنین نقطه ویرگول هایی حذف نمی شوند
یک نظر جانبی را به یک نظر بلوکی ارتقا دهید).

-اوس, --افزودن-فضای سفید
تنظیم این گزینه به perltidy اجازه می دهد تا کدهای بهبود فضای خالی خاصی را اضافه کند
خوانایی این پیش فرض است. اگر نمی خواهید فضای خالی اضافه شود، اما می خواهید
مایل به حذف مقداری فضای خالی، استفاده کنید -ناوس. (استفاده کنید -fws برای ترک فضای خالی
کاملا بدون تغییر).

-dws, --حذف-قدیمی-فضای سفید
تنظیم این گزینه به perltidy اجازه می دهد تا مقداری فضای سفید قدیمی بین کاراکترها را حذف کند.
در صورت لزوم این پیش فرض است. اگر نمی خواهید هیچ فضای سفید قدیمی حذف شود،
استفاده کنید -ndws or -فضای سفید-نودست.

کنترل‌های فضای خالی دقیق در اطراف نشانه‌ها
برای کسانی که می خواهند کنترل دقیق تری بر فضای خالی اطراف توکن ها داشته باشند، وجود دارد
چهار پارامتر که می توانند به طور مستقیم قوانین فضای خالی پیش فرض را تغییر دهند
perltidy برای هر نشانه. آن ها هستند:

-wls=s or --want-left-space=s,

-nwls=s or --nowant-left-space=s,

-wrs=s or --want-right-space=s,

-nwrs=s or --nowant-right-space=s.

این پارامترها هر کدام با یک رشته نقل قول دنبال می شوند. s، حاوی لیستی از نشانه ها
انواع بیش از یکی از هر یک از این پارامترها نباید مشخص شود، زیرا
تکرار یک پارامتر خط فرمان همیشه قبل از perltidy، پارامتر قبلی را بازنویسی می کند
تا به حال آن را می بیند

برای نشان دادن نحوه استفاده از اینها، فرض کنید می‌خواهید فضایی وجود نداشته باشد
هر دو طرف انواع توکن = + - / *. دو پارامتر زیر را مشخص می کند
این آرزو:

-nwls="= + - / *" -nwrs="= + - / *"

(توجه داشته باشید که انواع توکن ها در گیومه هستند و با فاصله از هم جدا می شوند).
با این قوانین فضای خالی اصلاح شده، خط ریاضی زیر:

$root = -$b + sqrt( $b * $b - 4. * $a * $c ) / ( 2. * $a );

این می شود:

$root=-$b+sqrt( $b*$b-4.*$a*$c )/( 2.*$a );

این پارامترها باید به‌عنوان نکاتی در مورد قوانین ثابت در نظر گرفته شوند،
زیرا perltidy باید سعی کند تضادهایی را که بین آنها و همه آنها ایجاد می شود حل کند
قوانین دیگری که از آن استفاده می کند. یکی از تضادهایی که ممکن است ایجاد شود این است که، بین دو نشانه،
توکن چپ فاصله می خواهد و سمت راست نه. در این مورد، نشانه نیست
خواستن یک فضا اولویت دارد

برای ایجاد این نوع، فهرستی از انواع توکن ها ضروری است
ورودی چنین لیستی را می توان با دستور به دست آورد --dump-token-types. را نیز امتحان کنید
-D روی یک قطعه کد کوتاه پرچم گذاری کنید و به فایل .DEBUG نگاه کنید تا آن را ببینید
نشانه گذاری

هشدار حتما این نشانه ها را در نقل قول قرار دهید تا از سوء تعبیر آنها جلوگیری شود
پوسته فرمان شما

فاصله بین کلمات کلیدی خاص و پرانتز باز
هنگامی که یک پرانتز باز از یک کلمه کلیدی Perl پیروی می کند، هیچ فاصله ای بعد از آن وارد نمی شود
کلمه کلیدی، مگر اینکه (به طور پیش فرض) یکی از این موارد باشد:

محلی من ما و یا eq ne if else elif تا زمانی که مگر
در حالی که برای foreach حالت سوئیچ بازگشت داده شده است

این پیش فرض ها را می توان با دو دستور تغییر داد:

-sak=s or --space-after-keyword=s کلمات کلیدی را اضافه می کند

-nsak=s or --nospace-after-keyword=s کلمات کلیدی را حذف می کند

جایی که s لیستی از کلمات کلیدی است (در صورت لزوم در نقل قول). مثلا،

my ( $a, $b, $c ) = @_; # پیش فرض
my( $a, $b, $c ) = @_; # -nsak="محلی من"

مخفف اختصاری -nsak='*' معادل گنجاندن تمام کلمات کلیدی در بالا است
فهرست

وقتی هر دو -nsak=s و -sak=s دستورات گنجانده شده است -nsak=s فرمان اجرا می شود
اولین. به عنوان مثال، برای داشتن فاصله فقط بعد از کلمات کلیدی (my, local, our) می توانید
استفاده کنید -nsak="*" -sak="من محلی ما".

برای قرار دادن فاصله بعد از همه کلمات کلیدی، مورد بعدی را ببینید.

فاصله بین تمام کلمات کلیدی و پرانتز باز
هنگامی که یک پرانتز باز از یک تابع یا کلمه کلیدی پیروی می کند، هیچ فاصله ای بعد از آن وارد نمی شود
کلمه کلیدی به جز کلمات کلیدی ذکر شده در مورد قبلی. برای اینکه همیشه یک فاصله بگذاریم
بین یک تابع یا کلمه کلیدی و پرانتز باز کننده آن، از دستور استفاده کنید:

-skp or --space-keyword-paren

احتمالاً شما نیز می خواهید از پرچم استفاده کنید -sfp (مورد بعدی) نیز.

فاصله بین نام همه توابع و پرانتزهای باز
هنگامی که یک پرانتز باز از یک تابع پیروی می کند، به طور پیش فرض یک فاصله معرفی نمی شود. به
باعث استفاده از فضا معرفی شود:

-sfp or --space-function-paren

myfunc( $a, $b, $c ); # پیش فرض
myfunc ($a، $b، $c)؛ # -sfp

احتمالاً شما نیز می خواهید از پرچم استفاده کنید -skp (مورد قبلی) نیز.

کوتاه کردن فضای خالی اطراف نقل قول های "qw".
-tqw or -- trim-qw رفتار پیش فرض کوتاه کردن فضاهای اطراف چند خط را ارائه می دهد
نقل قول های "qw" و تورفتگی مناسب آنها.

-ntqw or --notrim-qw ایجاد فضای سفید پیشرو و انتهایی در اطراف "qw" چند خطی
نقل قول ها بدون تغییر باقی بمانند این گزینه به طور معمول ضروری نخواهد بود، اما بود
برای مقاصد آزمایشی اضافه شده است، زیرا در برخی از نسخه های perl، نقل قول های "qw" کاهش می یابد
درخت نحو را تغییر می دهد.

برش فضای خالی انتهایی از خطوط POD
-trp or -- trim-pod فضای خالی انتهایی را از خطوط POD حذف می کند. پیش فرض است
که این کار را نکنیم

اظهار نظر کنترل
Perltidy راه های زیادی برای کنترل ظاهر کامنت های بلاک و جانبی دارد
نظرات. عبارت مسدود کردن توضیح در اینجا به یک نظر تمام خط اشاره دارد، در حالی که طرف توضیح
به نظری اشاره خواهد کرد که در خطی در سمت راست برخی از کدها ظاهر می شود.

-ibc, --indent-block-comments
کامنت‌های مسدود کردن معمولاً زمانی بهترین به نظر می‌رسند که در همان سطح کد فرورفته باشند
که آنها را دنبال می کند. این رفتار پیش‌فرض است، اما می‌توانید از آن استفاده کنید -nibc برای نگه داشتن بلوک
نظرات چپ توجیه شده به عنوان مثال:

# این نظر تورفتگی دارد (-ibc، پیش‌فرض)
if ($task) { yyyy(); }

جایگزین است -nibc:

# این نظر دارای تورفتگی نیست (-nibc)
if ($task) { yyyy(); }

مورد بعدی را نیز ببینید، -isbc، و همچنین -SBC، برای راه های دیگر برای داشتن مقداری تورفتگی
و برخی از نظرات بلوک خارج شده.

-isbc, --indent-spaced-block-comments
اگر فضای پیشرو در خط وجود نداشته باشد، نظر تورفتگی نخواهد داشت، و
در غیر این صورت ممکن است.

اگر هر دو -ibc و -isbc پس تنظیم می شوند -isbc اولویت دارد

-olc, -- نظرات طولانی-بیگانه
چه زمانی -olc تنظیم شده است، خطوطی که تمام خط (بلاک) نظرات طولانی تر از مقدار هستند
حداکثر طول خط تورفتگی آنها حذف خواهد شد. این پیش فرض است. استفاده کنید
-nolc برای جلوگیری از بیرون زدگی

-msc=n, --minimum-space-to-comment=n
نظرات جانبی زمانی به بهترین شکل به نظر می رسند که چندین فاصله در سمت راست کد ردیف شوند. Perltidy
سعی خواهد کرد نظرات را حداقل n فاصله در سمت راست نگه دارد. پیش فرض n=4 فاصله است.

-fpsc=n, --fixed-position-side-comment=n
این پارامتر به perltidy می گوید که نظرات جانبی را در شماره ستون ردیف کند n هر زمان که
ممکن است. پیش فرض، n=0، این کار را انجام نمی دهد.

-iscl, --نادیده گرفتن-سمت-طول نظرات
این پارامتر باعث می شود که perltidy در هنگام تنظیم خط، طول کامنت های جانبی را نادیده بگیرد
می شکند. به طور پیش فرض، -نیزکل، شامل طول کامنت های جانبی هنگام شکستن است
خطوط برای ماندن در طول تعیین شده توسط -l = n پارامتر طول خط حداکثر
برای مثال، خط تک طولانی زیر با -l=80 و -iscl دست نخورده باقی می‌ماند:

perltidy -l=80 -iscl
$vmsfile =~ s/;[\d\-]*$//; # برش شماره نسخه. می توانیم از نسخه جدیدتر نیز استفاده کنیم

در حالی که بدون پرچم -iscl خط شکسته می شود:

perltidy -l=80
$vmsfile =~ s/;[\d\-]*$//
; # برش شماره نسخه. می توانیم از نسخه جدیدتر نیز استفاده کنیم

-hsc, -- آویزان - سمت - نظرات
به‌طور پیش‌فرض، perltidy سعی می‌کند «کامنت‌های جانبی آویزان» را شناسایی و تراز کند
چیزی مثل این:

$IGNORE من = 0; # این یک نظر جانبی است
# این یک نظر جانبی معلق است
# و این هم همینطور

یک نظر در صورتی که (1) بلافاصله پس از a دنبال شود، یک نظر جانبی معلق در نظر گرفته می شود
با یک کامنت جانبی، یا یک کامنت کناری آویز دیگر خط بکشید، و (2) مقداری وجود دارد
فضای سفید پیشرو در خط. برای غیرفعال کردن این ویژگی، استفاده کنید -nhsc or
--nohanging-side-comments. اگر قبل از کامنت های بلوک یک خط خالی وجود داشته باشد یا هیچ خطی وجود نداشته باشد
با فضای خالی پیشرو، آنها به عنوان نظرات جانبی آویزان اشتباه نخواهند شد.

بستن نظرات جانبی
یک نظر جانبی بسته شدن یک نظر ویژه است که perltidy می تواند به طور خودکار ایجاد کند
و بعد از بند بسته شدن یک بلوک کد قرار دهید. آنها می توانند برای کد مفید باشند
تعمیر و نگهداری و رفع اشکال دستور -csc (و یا نظرات - بسته شدن) اضافه می کند یا
به روز رسانی بسته شدن نظرات جانبی. به عنوان مثال، در اینجا یک قطعه کد کوچک است

پیام فرعی {
if ( !defined( $_[0] ) ) {
print("سلام، جهان\n");
}
دیگر {
print($_[0], "\n");
}
}

و در اینجا نتیجه پردازش با "perltidy -csc" است:

پیام فرعی {
if ( !defined( $_[0] ) ) {
print("سلام، جهان\n");
}
دیگر {
print($_[0], "\n");
}
} ## پایان پیام فرعی

یک نظر جانبی پایانی برای "sub message" در این مورد اضافه شد، اما نه برای "if"
و بلوک های "دیگر"، زیرا آنها زیر حد 6 خط برای افزودن بسته شدن بودند
نظرات جانبی این محدودیت ممکن است با -csci دستور، در زیر توضیح داده شده است.

دستور -dcsc (و یا --حذف-بستن-کنار-کامنت ها) این روند را معکوس می کند و
این نظرات را حذف می کند

چندین دستور برای تغییر رفتار این دو دستور اصلی در دسترس است.
-csc و -dcsc:

-csci=n، یا --closing-side-comment-interval=n
که در آن "n" حداقل تعداد خطوطی است که یک بلوک برای a باید داشته باشد
نظر جانبی بسته شدن برای اضافه شدن مقدار پیش فرض "n=6" است. برای نشان دادن:

# perltidy -csci=2 -csc
پیام فرعی {
if ( !defined( $_[0] ) ) {
print("سلام، جهان\n");
} ## پایان اگر ( !defined( $_[0] ))
دیگر {
print($_[0], "\n");
} ## end else [ if ( !defined( $_[0] ))
} ## پایان پیام فرعی

اکنون بلوک های «if» و «else» کامنت می شوند. با این حال، در حال حاضر این بسیار تبدیل شده است
به هم ریخته

-cscp=string، یا --closing-side-comment-prefix=string
که در آن رشته پیشوندی است که قبل از نام نوع بلوک استفاده می شود. به طور پیش فرض
پیشوند، نشان داده شده در بالا، "## پایان" است. این رشته به سمت بسته شدن اضافه خواهد شد
نظرات، و همچنین برای شناسایی آنها به منظور به روز رسانی، حذف،
و آنها را قالب بندی کنید. هر نظری که به عنوان یک نظر پایانی شناسایی شود قرار خواهد گرفت
فقط یک فضای منفرد در سمت راست مهاربند بسته شدن آن.

-cscl=string، یا --closing-side-comment-list-string
که در آن "string" لیستی از انواع بلوک است که باید با بسته شدن نظرات جانبی برچسب گذاری شوند.
به‌طور پیش‌فرض، همه انواع بلوک کد با یک کلمه کلیدی یا برچسب (مانند «اگر»، قبل از آن
"sub" و غیره) برچسب گذاری خواهند شد. را -cscl دستور لیست پیش فرض را به
هر نوع بلوک انتخابی باشد. به "تعیین انواع بلوک" مراجعه کنید. به عنوان مثال
دستور زیر درخواست می کند که فقط بلوک های "sub"، برچسب ها، "BEGIN" و "END" باشند.
تحت تأثیر هر کدام -csc or -dcsc عمل:

-cscl="sub : BEGIN END"

-csct=n، یا --closing-side-comment-maximum-text=n
متنی که به انواع بلوک‌های خاص اضافه می‌شود، مانند بلوک «اگر»، هر چیزی است که دروغ می‌گوید
بین کلمه کلیدی معرفی کننده بلوک، مانند "اگر" و مهاربند باز.
از آنجایی که ممکن است این متن برای یک نظر جانبی زیاد باشد، باید محدودیتی وجود داشته باشد،
و این هدف از این پارامتر است. مقدار پیش فرض "n=20" است، به این معنی
که پس از رسیدن به طول آن، هیچ نشانه اضافی به این متن اضافه نخواهد شد
20 کاراکتر متن حذف شده با "..." نشان داده شده است. (توکن ها، از جمله زیر
با این حال، نام ها هرگز کوتاه نمی شوند، بنابراین طول واقعی ممکن است از این بیشتر شود). به
نشان دهید، در مثال بالا، متن ضمیمه اولین بلوک "(
!defined( $_[0] )...". محدودیت موجود "n=20" باعث شد این متن
بریده شده، همانطور که با "..." نشان داده شده است. برای کنترل بیشتر، پرچم بعدی را ببینید
متن کوتاه شده

-cscb، یا ---بسته-سمت-نظرات-متعادل
همانطور که در مورد قبل بحث شد، وقتی که closing-side-comment-maximum-text
از حد مجاز فراتر رفته است. متن نظر باید کوتاه شود. نسخه های قدیمی تر perltidy
با سه نقطه خاتمه می یابد، و هنوز هم می توان با -ncscb به آن دست یافت:

perltidy -csc -ncscb
} ## end foreach my $foo (مرتب کردن { $b cmp $a ...

با این حال، این باعث ایجاد مشکل در ویرایشگرهایی می شود که نمی توانند نظرات را تشخیص دهند یا هستند
برای انجام این کار پیکربندی نشده است زیرا نمی توانند به درستی در متن "پرش" انجام دهند.
La -cscb پرچم اضافه شده است تا با اضافه کردن تعادل مناسب به آنها کمک کند
ساختار:

perltidy -csc -cscb
} ## end foreach my $foo (مرتب کردن { $b cmp $a ... })

پیش فرض این است -cscb.

-csce=n، یا --closing-side-comment-else-flag=n
به طور پیش فرض، n = 0، متن عبارت "if" آغازین را بعد از هر ترمینال قرار می دهد
"دیگر".

If n = 2 استفاده می شود، سپس به هر "elsif" متن آغازین "if" نیز داده می شود.
بیانیه. همچنین، یک "دیگر" شامل متن "السیف" قبلی خواهد بود.
بیانیه. توجه داشته باشید که این ممکن است منجر به برخی نظرات جانبی بسته شدن طولانی شود.

If n = 1 استفاده می شود، نتایج مشابه خواهد بود n = 2 هر زمان که خط حاصل
طول کمتر از حداکثر مجاز است. = آیتم -cscb، یا
---بسته-سمت-نظرات-متعادل

هنگام استفاده از کامنت‌های سمت بسته، و محدودیت حداکثر متن نظر در سمت بسته
بیش از حد است، سپس متن نظر باید مخفف شود. با خاتمه می یابد
سه نقطه اگر -cscb پرچم نفی می شود:

perltidy -csc -ncscb
} ## end foreach my $foo (مرتب کردن { $b cmp $a ...

این باعث ایجاد مشکل در ویرایشگرهای قدیمی می شود که نظرات را تشخیص نمی دهند زیرا
آنها نمی توانند به درستی در متن "جهش" پیدا کنند. در -cscb پرچم سعی می کند کمک کند
آنها را با الحاق ساختارهای متعادل کننده ترمینال مناسب:

perltidy -csc -cscb
} ## end foreach my $foo (مرتب کردن { $b cmp $a ... })

پیش فرض این است -cscb.

-cscw، یا --بستن-سمت-نظر-اخطار
این پارامتر برای کمک به انتقال اولیه به استفاده از
بستن نظرات جانبی این باعث می شود که دو چیز اتفاق بیفتد اگر یک نظر جانبی بسته شود
یک نظر جانبی بسته شدنی موجود و متفاوت را جایگزین می‌کند: اول، یک پیام خطا
صادر خواهد شد و ثانیاً نظر جانبی اصلی به تنهایی بر روی الف قرار می گیرد
خط نظر جدید مشخص شده برای توجه بعدی.

هدف این است که از هجوم نظرات جانبی دست نویس موجود جلوگیری شود
برای مطابقت با الگوی بسته شدن نظرات جانبی. این پرچم فقط باید مورد نیاز باشد
اولین اجرا با -csc.

مهم یادداشت on بستن طرف نظرات:

کامنت های کناری بسته فقط روی خطوطی قرار می گیرند که با بند بسته شدن خاتمه می یابند.
برخی از سبک های بسته شدن، مانند استفاده از وسایل دیگر در نوازش (-جایی، مانع از
تولید برخی از نظرات جانبی پایانی

· لطفاً توجه داشته باشید که افزودن یا حذف نظرات جانبی در حال بسته شدن فقط انجام می شود
از طریق دستورات -csc or -dcsc. سایر دستورات، در صورت استفاده، صرفاً اصلاح می شوند
رفتار این دو دستور

· توصیه می شود که -cscw پرچم به همراه استفاده شود -csc در اولین استفاده از
perltidy در یک فایل داده شده این از دست دادن هر نظر جانبی موجود جلوگیری می کند
داده هایی که اتفاقاً دارای پیشوند csc هستند.

· یک بار استفاده کنید -csc، باید به استفاده از آن ادامه دهید تا هر گونه نظر جانبی بسته شود
با تغییر کد صحیح باقی می مانند. در غیر این صورت این نظرات نادرست خواهد بود
همانطور که کد به روز می شود.

· اگر نظرات جانبی پایانی تولید شده توسط perltidy را ویرایش کنید، باید تغییر دهید
پیشوند با پیشوند نظر پایانی متفاوت باشد. در غیر این صورت، شما
با اجرای مجدد perltidy با، ویرایش ها از بین خواهند رفت -csc. به عنوان مثال، شما می توانید
به سادگی "## end" را به "## End" تغییر دهید، زیرا آزمون به حروف بزرگ و کوچک حساس است. شما ممکن است
همچنین می خواهید از -Scc پرچم گذاری کنید تا این نظرات جانبی بسته شدن اصلاح شده را با فاصله نگه دارید
مانند نظرات پایانی واقعی.

· ایجاد موقت نظرات جانبی پایانی یک تکنیک مفید برای کاوش است
و/یا اشکال زدایی یک اسکریپت پرل، به خصوص اسکریپتی که توسط شخص دیگری نوشته شده است. تو می توانی
همیشه آنها را با -dcsc.

نظرات بلوک استاتیک
نظرات بلوک ایستا، نظرات بلوکی با یک الگوی خاص، "##" توسط
به طور پیش فرض، که با آن کمی متفاوت از سایر نظرات بلوک رفتار می شود. آنها
به طور موثر طوری رفتار می کنند که انگار در امتداد لبه های چپ و بالای خود چسب دارند، زیرا آنها
هنگامی که هیچ فضای خالی در آنها وجود ندارد، به لبه سمت چپ و خط قبلی بچسبید
مکان ها این گزینه به ویژه برای کنترل نحوه نظر دادن کد مفید است
نمایش داده.

-SBC, -- Static-block-Comments
چه زمانی -SBC استفاده می شود، یک نظر بلوکی با یک الگوی خاص پیشرو، "##" توسط
پیش‌فرض، به‌ویژه با آن برخورد خواهد شد.

نظرات شناسایی شده به شرح زیر است:

· اگر فضای پیشرو در خط وجود نداشته باشد، نظر وجود نخواهد داشت
تورفتگی دارد، و در غیر این صورت ممکن است،

· هیچ خط خالی جدیدی قبل از چنین نظری درج نخواهد شد و

· چنین نظری هرگز تبدیل به یک نظر جانبی معلق نخواهد شد.

به عنوان مثال، با فرض اینکه @month_of_year به صورت چپ تنظیم شده است:

@month_of_year = ( # -sbc (پیش‌فرض)
«ژان»، «فوریه»، «مارس»، «آوریل»، «مه»، «ژوئن»، «ژوئیه»، «اوت»، «سپتامبر»، «اکتبر»،
## 'دسامبر'، 'نوامبر'
'نوامبر'، 'دسامبر')؛

بدون این قرارداد، کد بالا تبدیل می شود

@month_of_year = ( # -nsbc
«ژان»، «فوریه»، «مارس»، «آوریل»، «مه»، «ژوئن»، «ژوئیه»، «اوت»، «سپتامبر»، «اکتبر»،

## 'دسامبر'، 'نوامبر'
'نوامبر'، 'دسامبر'
);

که آنقدر واضح نیست پیش فرض استفاده است -SBC. این ممکن است با غیر فعال شود
-nsbc.

-sbcp=string, --static-block-comment-prefix=string
این پارامتر پیشوند مورد استفاده برای شناسایی نظرات بلوک ایستا را تعریف می کند
-SBC پارامتر تنظیم شده است پیشوند پیش فرض "##" است که مربوط به "-sbcp=##" است.
پیشوند در واقع بخشی از الگوی پرل است که برای مطابقت با خطوط استفاده می شود و باید
یا با "#" یا "^#" شروع شود. در حالت اول یک پیشوند ^\s* به آن اضافه می شود
با هر فضای سفید پیشرو مطابقت داشته باشد، در حالی که در حالت دوم الگو فقط مطابقت دارد
نظرات بدون فضای خالی پیشرو. به عنوان مثال، برای شناسایی همه نظرات به عنوان
نظرات بلوک ایستا، می توان از "-sbcp=#" استفاده کرد. برای شناسایی تمام تنظیمات چپ
نظرات به عنوان نظرات بلوک ایستا، از "-sbcp='^#'" استفاده کنید.

لطفا توجه داشته باشید که -sbcp فقط الگوی مورد استفاده برای شناسایی بلوک استاتیک را تعریف می کند
نظرات؛ استفاده نمی شود مگر اینکه سوئیچ -SBC تنظیم شده است. همچنین لطفا باشید
آگاه باشید که از آنجایی که این رشته در یک عبارت منظم پرل استفاده می شود که شناسایی می کند
این نظرات، باید امکان تشکیل یک عبارت منظم معتبر را داشته باشد.

الگویی که می تواند مفید باشد این است:

-sbcp=^#{2,}[^\s#]

این الگو به یک کامنت بلوک ثابت نیاز دارد تا حداقل یک کاراکتر داشته باشد
نه # است و نه فاصله. این اجازه می دهد تا یک خط فقط حاوی کاراکترهای '#' باشد
به عنوان یک نظر بلوک ایستا رد شد. چنین خطوطی اغلب در ابتدا و
انتهای اطلاعات هدر در زیر روال ها و نباید از آن جدا شود
نظرات مداخله ای، که معمولا با یک "#" شروع می شوند.

-OSBC, --outdent-static-block-comments
دستور -OSBC باعث می شود نظرات بلوک ایستا با 2 فاصله (یا
هر چه -ci=n تنظیم شده است)، در صورت امکان.

نظرات سمت استاتیک
نظرات جانبی استاتیک، نظرات جانبی با الگوی پیشرو خاص هستند. این گزینه
می تواند برای کنترل نحوه نمایش کد نظر داده شده در زمانی که یک سمت است مفید باشد
اظهار نظر.

-Scc, -- Static-side-Comments
چه زمانی -Scc استفاده می شود، یک نظر جانبی با یک الگوی راهنما ثابت، که "##" توسط
به طور پیش فرض، تنها با یک فاصله از کاراکتر قبلی فاصله خواهد داشت، و این کار را خواهد کرد
به صورت عمودی با سایر نظرات جانبی همسو نشوند.

پیش فرض این است -nssc.

-sscp=string, --static-side-comment-prefix=string
این پارامتر پیشوندی را که برای شناسایی نظرات جانبی ثابت استفاده می‌شود، تعریف می‌کند
-Scc پارامتر تنظیم شده است پیشوند پیش فرض "##" است که مربوط به "-sscp=##" است.

لطفا توجه داشته باشید که -sscp فقط الگوی مورد استفاده برای شناسایی سمت استاتیک را تعریف می کند
نظرات؛ استفاده نمی شود مگر اینکه سوئیچ -Scc تنظیم شده است. همچنین توجه داشته باشید که این
رشته در یک عبارت منظم پرل استفاده می شود که این نظرات را مشخص می کند، بنابراین
باید یک عبارت منظم معتبر را فعال کند.

پرش منتخب بخش ها of رمز
خطوط انتخاب شده کد ممکن است به طور کلمه به کلمه بدون هیچ قالب بندی به خروجی ارسال شود. این
این ویژگی به طور پیش فرض فعال است اما می توان با آن غیرفعال کرد بدون فرمت-پرش or -nfs
پرچم. برای جلوگیری از پر کردن کد با نشانگرها، باید به مقدار کم استفاده شود، اما ممکن است اینطور باشد
برای حل مشکلات گاه به گاه مفید است. برای مثال ممکن است مفید باشد
بدون تغییر تورفتگی کدهای قدیمی نظر داده شده، حفظ تورفتگی طولانی
بلوک‌های کامنت‌های هم‌تراز شده بدون تغییر، بدون تغییر قالب‌بندی فهرست خاص، یا
کار بر روی یک نقص در perltidy.

-fs, --قالب-پرش
این پرچم که به طور پیش فرض فعال است، باعث ایجاد هر کدی بین شروع ویژه و
نشانگرهای پایانی برای ارسال به خروجی بدون قالب بندی. به طور پیش فرض
نشانگر شروع #<<< و نشانگر پایانی پیش فرض #>>> است اما ممکن است تغییر کنند
(به موارد بعدی زیر مراجعه کنید). ممکن است متن اضافی در این خطوط نظر ویژه ظاهر شود
به شرطی که حداقل با یک فاصله از نشانگر جدا شود. مثلا

#<< اجازه ندهید perltidy این را لمس کند
لیست @ من = (1،
1، 1،
1، 2، 1،
1 ، 3 ، 3 ، 1 ،
1، 4، 6، 4، 1،)؛
#>>>

نشانگرهای نظر ممکن است در هر مکانی که یک نظر مسدود ظاهر می شود قرار داده شوند. اگر
به نظر نمی رسد کار کنند، از پرچم -log استفاده کنید و آن را بررسی کنید . LOG فایل. استفاده کنید
-nfs برای غیرفعال کردن این ویژگی

-fsb=string, --format-skipping-begin=string
La -fsb=string پارامتر ممکن است برای تغییر نشانگر شروع برای قالب استفاده شود
پرش پیش فرض معادل -fsb='#<<<' است. رشته ای که وارد می کنید باید
با یک # شروع می شود و در صورت لزوم باید در گیومه باشد تا از پوسته فرمان عبور کنید
سیستم شما این در واقع متن اصلی یک الگو است که توسط
یک '\s' را اضافه کنید، بنابراین باید برای گرفتن کاراکترها، اسلش‌های معکوس نیز اضافه کنید
به معنای واقعی کلمه نه به عنوان الگو.

برخی از مثال‌ها نشان می‌دهند که چگونه رشته‌های نمونه به الگو تبدیل می‌شوند:

-fsb='#\{\{\{' تبدیل به /^#\{\{\{\{\s/ می‌شود که با #{{{، اما نه با #{{{{
-fsb='#\*\*' تبدیل به /^#\*\*\s/ می شود که با #** مطابقت دارد اما نه #***
-fsb='#\*{2,}' تبدیل به /^#\*{2,}\s/ می‌شود که با #** و #***** مطابقت دارد.

-fse=string, --format-skipping-end=string
La -fsb=string پارامتر مربوطه ای است که برای تغییر نشانگر پایانی استفاده می شود
رد شدن از قالب پیش فرض معادل -fse='#<<' است.

لاین شکستن کنترل
پارامترهای این بخش پس از خطوط غیر خالی کد شکسته می شوند. خطوط خالی
به طور جداگانه توسط پارامترهای موجود در بخش "کنترل خط خالی" کنترل می شوند.

-fnl, --freeze-newlines
اگر نمی خواهید هیچ تغییری در خطوط شکسته در خطوط کد در اسکریپت خود ایجاد کنید،
تنظیم -fnl، و آنها ثابت می مانند و بقیه دستورات در این بخش و
بخش‌های «کنترل قالب‌بندی فهرست»، «حفظ یا نادیده گرفتن شکست‌های خط موجود».
شما ممکن است بخواهید از آن استفاده کنید -نول با این.

توجه: اگر می خواهید خطوط خالی خود را دقیقاً همانطور که هستند حفظ کنید، می توانید از آن استفاده کنید
-fbl پرچمی که در بخش "کنترل خط خالی" توضیح داده شده است.

-جایی, --در آغوش گرفته-دیگر
سبک «نوازش دادن دیگر» را فعال کنید، که در آن «else» و «elsif» بلافاصله دنبال می‌شوند
پس از بستن بریس فرفری بلوک قبلی. پیش فرض این است که از نوازش استفاده نکنید
others، و با پرچم نشان داده شده است -nce or -- نوازش-دیگر. در اینجا یک مقایسه است
از گزینه های جایگزین:

اگر ($task) {
yy();
} else { # -ce
zzz();
}

اگر ($task) {
yy();
}
else { # -nce (پیش‌فرض)
zzz();
}

-bl, ---باز کردن-بند-بر-خط جدید
از پرچم استفاده کنید -bl برای قرار دادن بریس باز کننده روی یک خط جدید:

if ($input_file eq '-' ) # -bl
{
مهم_function();
}

این پرچم برای همه بلوک‌های ساختاری، از جمله زیر نام‌گذاری‌شده (مگر اینکه -sbl
پرچم تنظیم شده است - مورد بعدی را ببینید).

سبک پیش فرض، -nbl، یک مهاربند باز را در همان خط کلمه کلیدی قرار می دهد
معرفی آن مثلا،

if ( $input_file eq '-' ) { # -nbl (پیش‌فرض)

-sbl, --opening-sub-brace-on-new-line
پرچم -sbl می توان برای نادیده گرفتن مقدار استفاده کرد -bl برای بریس های باز از نام
زیر مثلا،

perltidy -sbl

این نتیجه را ایجاد می کند:

پیام فرعی
{
if (!defined($_[0])) {
print("سلام، جهان\n");
}
دیگر {
print($_[0]، "\n");
}
}

این پرچم نفی شده است -nsbl. اگر -sbl مشخص نشده است، مقدار -bl استفاده می شود.

-asbl, --opening-anonymous-sub-brace-on-new-line
پرچم -asbl مانند -sbl پرچم را با این تفاوت که در عوض برای زیرهای ناشناس اعمال می شود
از زیرمجموعه های نامگذاری شده مثلا

perltidy -asbl

این نتیجه را ایجاد می کند:

$a = زیر
{
if ( !defined( $_[0] ) ) {
print("سلام، جهان\n");
}
دیگر {
print($_[0], "\n");
}
};

این پرچم نفی شده است -ناسبل، و پیش فرض است -ناسبل.

-bli, --پرانتز-چپ-و-تورفتگی
پرچم -bli مثل این هست که -bl اما علاوه بر آن باعث یک واحد تداوم می شود
تورفتگی (نگاه کنید به -این ) باید قبل از مهاربندهای بلوک باز و بسته قرار گیرد.

به عنوان مثال،

if ( $input_file eq '-' ) # -bli
{
مهم_function();
}

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

-blil=s, --brace-left-and-indent-list=s
از این پارامتر برای تغییر انواع مهاربندهای بلوک استفاده کنید -bli پرچم
اعمال میشود؛ به "تعیین انواع بلوک" مراجعه کنید. مثلا، -blil='اگر السیف دیگر' اعمال می شود
آن را فقط به بلوک های "if/elsif/else".

-Bar, ---باز کردن-بست-همیشه-رو-راست
سبک پیش فرض، -nbl در صورت وجود، مهاربند بلوک کد باز را روی خط جدیدی قرار می دهد
در همان خط با کلمه کلیدی باز قرار نمی گیرد، مانند این:

اگر ($bigwasteofspace1 &&$bigwasteofspace2
|| $bigwasteofspace3 && $bigwasteofspace4 )
{
بزرگ_اتلاف_زمان();
}

برای اینکه بند بازکننده را مجبور کنید همیشه در سمت راست باشد، از آن استفاده کنید -Bar پرچم. در این
مورد، مثال بالا می شود

اگر ($bigwasteofspace1 &&$bigwasteofspace2
|| $bigwasteofspace3 && $bigwasteofspace4 ) {
بزرگ_اتلاف_زمان();
}

اگر هر دوی اینها تعارض رخ دهد -bl و -Bar مشخص شده اند.

-otr, --opening-token-right و پرچم های مرتبط
La -otr flag اشاره ای است به اینکه perltidy نباید بین کاما و an فاصله ایجاد کند
رمز باز کردن مثلا:

# قالب بندی پیش فرض
فشار @{ $self->{$module}{$key} }،
{
accno => $ref->{accno}،
توضیحات => $ref->{description}
};

# perltidy -otr
فشار @{ $self->{$module}{$key} }، {
accno => $ref->{accno}،
توضیحات => $ref->{description}
};

پرچم -otr در واقع مخفف سه پرچم دیگر است که می توان از آنها استفاده کرد
در صورت تمایل، پرانتز، بریس هش و براکت مربع را جداگانه کنترل کنید:

-opr یا --opening-paren-right
-ohbr یا --opening-hash-brace-right
-osbr یا --opening-square-bracket-right

سفتی عمودی بریس های مجعد غیر بلوکی، پرانتز و براکت های مربعی.
این پارامترها چیزی را که سفتی عمودی نامیده می شود، کنترل می کنند. در اینجا اصلی هستند
نکته ها:

· نشانه های باز (به جز مهاربندهای بلوک) توسط کنترل می شوند -vt=n، یا
--عمودی-سفتی=n، که در آن

-vt=0 همیشه پس از باز کردن توکن (پیش‌فرض) یک خط را می‌شکند.
-vt=1 نمی شکند مگر اینکه بیش از یک تولید کند
گام در تورفتگی در یک خط.
-vt=2 پس از باز کردن توکن هرگز خطی را نشکنید

· همچنین باید از -lp وقتی از -vt پرچم؛ دلیل آن توضیح داده شده است
زیر کلیک کنید.

· نشانه های بسته (به جز مهاربندهای بلوک) توسط کنترل می شوند -vtc=n، یا
--vertical-tightness-closing=n، که در آن

-vtc=0 همیشه یک خط را قبل از یک توکن بسته می‌شکند (پیش‌فرض)،
-vtc=1 قبل از توکن بسته شدن که دنبال می شود شکسته نشود
با نقطه ویرگول یا نشانه پایانی دیگر، و in نیست
یک محیط لیست
-vtc=2 هرگز قبل از یک توکن بسته نمی شود.

قوانین برای -vtc=1 برای حفظ تعادل معقول بین
فشرده بودن و خوانایی در لیست های پیچیده

· کنترل های مختلف ممکن است برای انواع مختلف توکن اعمال شود، و همینطور است
امکان کنترل بریس های بلوک؛ زیر را ببینید.

· در نهایت، لطفاً توجه داشته باشید که این پرچم‌های عمودی تنگی صرفاً اشاره‌ای به آن هستند
قالب‌کننده، و همیشه نمی‌تواند آنها را دنبال کند. چیزهایی که آن را دشوار می کند یا
غیر ممکن شامل نظرات، خطوط خالی، بلوک های کد در یک لیست و
احتمالاً فقدان -lp پارامتر. همچنین، این پرچم ها ممکن است برای خیلی نادیده گرفته شوند
لیست های کوچک (طول ۲ یا ۳ خط).

در اینجا برخی از نمونه ها:

# perltidy -lp -vt=0 -vtc=0
%romanNumerals = (
یک => 'من'،
دو => 'II'،
سه => 'III'،
چهار => 'IV'،
);

# perltidy -lp -vt=1 -vtc=0
%romanNumerals = ( one => 'I',
دو => 'II'،
سه => 'III'،
چهار => 'IV'،
);

# perltidy -lp -vt=1 -vtc=1
%romanNumerals = ( one => 'I',
دو => 'II'،
سه => 'III'،
چهار => 'IV', );

تفاوت میان -vt=1 و -vt=2 در اینجا نشان داده شده است:

# perltidy -lp -vt=1
$init->add(
mysprintf( "(void)find_threadsv(%s);",
cstring ($threadsv_names[ $op->targ ] )
)
);

# perltidy -lp -vt=2
$init->add( mysprintf( "(void)find_threadsv(%s);"
cstring ($threadsv_names[ $op->targ ] )
)
);

با -vt=1، خطی که به "add(") ختم می شود با خط بعدی ترکیب نمی شود زیرا
خط بعدی متعادل نیست. این می تواند به خوانایی کمک کند، اما -vt=2 را می توان به استفاده
این قانون را نادیده بگیرید

فشرده ترین و کم خواندن ترین کد با هر دو "-vt=2" و "-vtc=2" تولید می شود:

# perltidy -lp -vt=2 -vtc=2
$init->add( mysprintf( "(void)find_threadsv(%s);"
cstring( $threadsv_names[ $op->targ ] ) ) );

توجه کنید که چگونه کد در همه این مثال ها به صورت عمودی جمع می شود -vt افزایش،
اما تورفتگی بدون تغییر باقی می ماند. این به این دلیل است که perltidy را پیاده سازی می کند -vt
پارامتر با قالب بندی اول به عنوان اگر -vt=0، و سپس به سادگی یک خط خروجی را بازنویسی کنید
در بالای بعدی، در صورت امکان، برای رسیدن به سفتی عمودی مورد نظر. در -lp
سبک تورفتگی طوری طراحی شده است که به این فروپاشی عمودی اجازه می دهد که رخ دهد
چرا برای آن مورد نیاز است -vt پارامتر.

La -vt=n و -vtc=n پارامترها برای هر نوع ژتون ظرف اعمال می شود. در صورت تمایل،
کنترل های سفتی عمودی را می توان به طور مستقل برای هر یک از بسته ها اعمال کرد
انواع توکن ظرف

پارامترهای کنترل پرانتز هستند -pvt=n or --paren-vertical-tightness=n,
و -pcvt = n or --paren-vertical-tightness-closing=n.

به همین ترتیب، پارامترهای براکت مربع هستند -sbvt=n or
--square-bracket-vertical-tightness=nو -sbcvt = n or
--square-bracket-vertical-tightness-closing=n.

در نهایت، پارامترهای کنترل مهاربندهای بلوک غیر کد هستند -bvt=n or
---brace-vertical-tightness=nو -bcvt=n or --brace-vertical-tightness-closing=n.

در واقع پارامتر -vt=n در واقع فقط یک مخفف برای -pvt=n -bvt=n
sbvt=n، و به همین ترتیب -vtc=n مخفف است -pvtc=n -bvtc=n sbvtc=n.

-bbvt=n or --block-brace-vertical-tightness=n
La -bbvt=n پرچم درست مثل -vt=n پرچم گذاری کنید اما برای باز کردن پرانتزهای بلوک کد اعمال می شود.

-bbvt=0 شکست پس از باز کردن مهاربند بلوک (پیش‌فرض).
-bbvt=1 شکسته نمی شود مگر اینکه بیش از یک تولید کند
گام در تورفتگی در یک خط.
-bbvt=2 بعد از باز کردن مهاربند شکسته نمی شود.

استفاده از هر کدام نیز ضروری است -bl or -bli برای این کار، زیرا، همانطور که با
سایر کنترل‌های تنگی عمودی، به سادگی با بازنویسی یک خط اجرا می‌شود
با یک مهاربند بلوک باز کننده با خط بعدی پایان می یابد. مثلا:

# perltidy -bli -bbvt=0
if ( open( FILE, "< $File" ) )
{
در حالی که ($File = )
{
$In .= $File;
$count++;
}
بستن (FILE)؛
}

# perltidy -bli -bbvt=1
if ( open( FILE, "< $File" ) )
{ while ($File = )
{ $In .= $File;
$count++;
}
بستن (FILE)؛
}

به طور پیش فرض این برای بلوک های مرتبط با کلمات کلیدی اعمال می شود if, السیف, دیگر, مگر,
برای, برای هر, زیر, در حین, تاو همچنین با یک برچسب قبلی. این را می توان تغییر داد
با پارامتر -bbvtl=رشته، یا --block-brace-vertical-tightness-list=string,
جایی که رشته لیستی از انواع بلوک های جدا شده با فاصله است. برای اطلاعات بیشتر در مورد
مقادیر احتمالی این رشته، به "تعیین انواع بلوک" مراجعه کنید.

برای مثال، اگر بخواهیم این سبک را فقط برای بلوک‌های «if»، «elsif» و «else» اعمال کنیم،
ما می توانیم از "perltidy -bli -bbvt=1 -bbvtl='if elsif else'" استفاده کنیم.

هیچ کنترل سفتی عمودی برای بستن مهاربندهای بلوک وجود ندارد. با یک استثنا
آنها در خطوط جداگانه قرار خواهند گرفت. استثنا این است که یک آبشار بسته شدن
مهاربندهای بلوک ممکن است روی یک خط انباشته شوند. دیدن -scbb.

-sot, - توکن های باز کردن پشته و پرچم های مرتبط
La -sot flag به perltidy می‌گوید تا در صورت امکان، توکن‌های بازکننده را «پشته» کند تا از خطوط جلوگیری کند
با توکن های باز کردن جدا شده

مثلا:

# پیش فرض
$opt_c = متن::CSV_XS->جدید(
{
باینری => 1،
sep_char => $opt_c،
always_quote => 1،
}
);

# -sot
$opt_c = متن::CSV_XS->جدید( {
باینری => 1،
sep_char => $opt_c،
always_quote => 1،
}
);

برای کنترل دقیق توکن‌های بسته شدن فردی، می‌توان از کنترل‌های زیر استفاده کرد:

-sop یا --stack-opening-paren
-sohb یا --stack-opening-hash-brace
-sosb یا --stack-opening-square-bracket
هق هق یا --stack-opening-block-brace

پرچم -sot مخفف است -سوپ -صهب -sosb.

پرچم -گریه کن مخفف است -bbvt=2 -bbvtl='*'. این یک آبشار از
باز کردن مهاربندهای بلوک روی یک خط ظاهر می شود، اگرچه این یک اتفاق غیر معمول است
به جز در اسکریپت های تست.

-sct, - توکن های بسته-پشته و پرچم های مرتبط
La -sct flag به perltidy می‌گوید تا در صورت امکان توکن‌های بسته را «پشته» کند تا از خطوط جلوگیری کند
با توکن های بسته ای جدا شده

مثلا:

# پیش فرض
$opt_c = متن::CSV_XS->جدید(
{
باینری => 1،
sep_char => $opt_c،
always_quote => 1،
}
);

# -sct
$opt_c = متن::CSV_XS->جدید(
{
باینری => 1،
sep_char => $opt_c،
always_quote => 1،
})

La -sct پرچم تا حدودی شبیه به -vtc پرچم، و در برخی موارد می تواند یک نشان دهد
نتیجه مشابه تفاوت این است که -vtc پرچم‌ها سعی می‌کنند از خطوط با پیشرو اجتناب کنند
باز کردن توکن ها با "پنهان کردن" آنها در انتهای خط قبلی، در حالی که -sct پرچم
صرفاً سعی می کند تعداد خطوط را با توکن های بسته جدا شده با انباشتن کاهش دهد
آنها را اما سعی نمی کند آنها را پنهان کند. مثلا:

# -vtc=2
$opt_c = متن::CSV_XS->جدید(
{
باینری => 1،
sep_char => $opt_c،
always_quote => 1, } );

برای کنترل دقیق انباشتن توکن‌های بسته شدن فردی به شرح زیر است
می توان از کنترل ها استفاده کرد:

-scp یا --stack-closing-paren
-schb یا --stack-closing-hash-brace
-scsb یا --stack-closing-square-bracket
-scbb یا --stack-closing-block-brace

پرچم -sct مخفف انباشتن توکن های بسته شدن غیر بلوکی است، -scp -schb
-scsb.

انباشته شدن مهاربندهای بلوک بسته، -scbb، باعث ایجاد آبشاری از بلوک بسته شدن ایزوله می شود
مهاربندهایی که باید مانند مثال زیر در یک خط ترکیب شوند:

# -scbb:
برای $w1 (@w1) {
برای $w2 (@w2) {
برای $w3 (@w3) {
برای $w4 (@w4) {
push( @lines, "$w1 $w2 $w3 $w4\n");
} } }

برای ساده‌تر کردن ورودی حتی بیشتر برای مواردی که هم باز کردن و هم بسته شدن
ظروف بلوک روی هم چیده شده اند، پرچم -کیسه or -- پشته همه ظروف است
مخفف برای -sot -sot.

-dnl, --حذف-قدیمی-خطوط جدید
به طور پیش فرض، perltidy ابتدا تمام مکان های قدیمی شکست خط را حذف می کند و سپس به دنبال آن می گردد
نقاط شکست خوب برای مطابقت با طول خط مورد نظر. استفاده کنید -ndnl or
--nodelete-old-newlines برای مجبور کردن perltidy به حفظ تمام نقاط شکست خط قدیمی.

-anl, --افزودن-خطوط جدید
به‌طور پیش‌فرض، perltidy برای ایجاد ادامه‌های خط، در صورت لزوم، شکسته‌های خط را اضافه می‌کند
خطوط طولانی و برای بهبود ظاهر فیلمنامه. استفاده کنید -نانل or --noadd-newlines به
جلوگیری از هر گونه شکست خط جدید

این پرچم مانع از حذف شکست های خط موجود توسط perltidy نمی شود. دیدن
--freeze-newlines برای جلوگیری از تغییرات در نقاط شکست خط.

کنترل اینکه آیا perltidy قبل یا بعد از اپراتورها می شکند
چهار پارامتر خط فرمان تا حدودی کنترلی را بر روی اینکه آیا یک خط باید شکسته شود، فراهم می کند
قبل یا بعد از انواع توکن های خاص دو پارامتر کنترل دقیق را ارائه می دهند:

-wba=s or --want-break-after=sو

-wbb=s or --want-break-before=s.

این پارامترها هر کدام با یک رشته نقل قول دنبال می شوند. s، حاوی لیستی از نشانه ها
انواع (فقط با فاصله از هم جدا می شوند). بیش از یکی از هر یک از این پارامترها نباید
مشخص شود، زیرا تکرار یک پارامتر خط فرمان همیشه روی آن بازنویسی می شود
قبلی قبل از اینکه perltidy آن را ببیند.

به طور پیش فرض، perltidy می شکند بعد از این انواع توکن:
% + - * / x != == >= <= =~ !~ < > | &
= **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=

و perltidy می شکند قبل از این انواع توکن به طور پیش فرض:
. << >> -> && || //

برای نشان دادن، برای ایجاد شکست بعد از عملگر الحاق، به جای «.»، به جای
قبل از آن، خط فرمان خواهد بود

-wba="."

به عنوان مثال دیگر، دستور زیر باعث شکست عملگرهای ریاضی می شود
'+'، '-'، '/'، و '*':

-wbb="+ - / *"

این دستورات باید برای اکثر انواع توکن‌هایی که perltidy استفاده می‌کند به خوبی کار کنند (استفاده از
--dump-token-types برای یک لیست). را نیز امتحان کنید -D پرچم روی یک قطعه کوتاه از کد و
برای مشاهده توکن سازی به فایل .DEBUG نگاه کنید. با این حال، برای چند نوع نشانه وجود دارد
ممکن است در تضاد با منطق سخت سیمی باشد که باعث نتایج غیرمنتظره شود. یک مثال این است
بریس های فرفری که باید با پارامتر کنترل شوند bl برای آن فراهم شده است
هدف

هشدار حتما این نشانه ها را در نقل قول قرار دهید تا از سوء تعبیر آنها جلوگیری شود
پوسته فرمان شما

دو پارامتر اضافی در دسترس است که هر چند بیشتر ارائه نمی دهند
قابلیت، می تواند ورودی را ساده کند عبارتند از:

-بائو or -------------------------------------------,

-ببائو or -- break-fore-all-operators.

-baao پیش‌فرض را روی شکستن بعد از همه عملگرهای زیر تنظیم می‌کند:

% + - * / x != == >= <= =~ !~ < > | &
= **= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x=
. : && || و یا err xor

و -ببائو flag پیش فرض را قبل از همه این عملگرها شکسته می کند. اینها می توانند
برای تعریف اولویت اولیه شکست که می تواند با تنظیم دقیق استفاده شود -wba
و -wbb پرچم ها به عنوان مثال، برای شکستن قبل از همه عملگرها به جز a = یکی می توانست استفاده کند
--bbao -wba='=' به جای لیست کردن تک تک اپراتورهای پرل به جز = در -wbb
پرچم.

کنترل فهرست قالب بندی
Perltidy تلاش می کند تا آرایه های مقادیر جدا شده با کاما را در جداول قرار دهد که خوب به نظر می رسند.
الگوریتم‌های پیش‌فرض آن معمولاً به خوبی کار می‌کنند، و با هر نسخه بهبود می‌یابند.
اما چندین پارامتر برای کنترل قالب بندی لیست موجود است.

-boc, -- break-at-old-comma-breakpoints
این پرچم به perltidy می گوید که سعی کنید تمام کاماهای قدیمی را بشکنید. این پیش فرض نیست.
به طور معمول، perltidy بهترین حدس را در قالب بندی لیست می دهد و به ندرت از کامای قدیمی استفاده می کند.
نقاط شکست معمولاً این کار خوب است، اما در نظر بگیرید:

لیست @ من = (1،
1، 1،
1، 2، 1،
1 ، 3 ، 3 ، 1 ،
1، 4، 6، 4، 1،)؛

قالب بندی پیش فرض این را به یک خط صاف می کند:

# perltidy (پیش‌فرض)
فهرست @ my = ( 1، 1، 1، 1، 2، 1، 1، 3، 3، 1، 1، 4، 6، 4، 1، );

که ساختار را پنهان می کند. استفاده كردن -boc، به علاوه پرچم های اضافی برای حفظ نسخه اصلی
سبک، بازده

# perltidy -boc -lp -pt=2 -vt=1 -vtc=1
لیست @ من = (1،
1، 1،
1، 2، 1،
1 ، 3 ، 3 ، 1 ،
1، 4، 6، 4، 1،)؛

نقطه ضعف این پرچم این است که همه جداول موجود در فایل باید از قبل به خوبی باشند
قالب بندی شده است. برای امکان دیگر، پرچم -fs را در «پرش از بخش‌های انتخاب شده از» ببینید
کد".

-mft=n, --maximum-fields-per-table=n
اگر تعداد فیلدهای محاسبه شده برای هر جدول بیشتر شود n، سپس به کاهش می یابد
n. مقدار پیش فرض برای n یک عدد بزرگ است، 40. در حالی که این مقدار احتمالا باید
به عنوان یک قانون کلی بدون تغییر باقی بماند، ممکن است در بخش کوچکی از کد استفاده شود
فهرستی را مجبور کنید که تعداد خاصی از فیلدها در هر خط داشته باشد، و سپس یکی از آنها -boc
می‌توان از پرچم برای حفظ این قالب‌بندی استفاده کرد، یا می‌توان یک نظر را معرفی کرد
جایی برای منجمد کردن قالب بندی در برنامه های آینده perltidy.

# perltidy -mft=2
@month_of_year = (
"ژان"، "فوریه"،
'مار'، 'آوریل'،
«مه»، «جون»،
'ژوئیه'، 'اوت'،
'سپتامبر'، 'اکتبر'،
'نوامبر'، 'دسامبر'
);

-cab=n, --comma-arrow-breakpoints=n
ویرگول که از پیکان کاما، '=>' پیروی می کند، مورد توجه ویژه قرار می گیرد. در یک مدت طولانی
در فهرست، شکستن تمام این کاماها معمول است. از این پارامتر می توان برای کنترل استفاده کرد
چگونه perltidy در این کاما می شکند. (اما اگر ویرگول قدیمی باشد هیچ تاثیری نخواهد داشت
استراحت اجباری است زیرا -boc استفاده می شود). مقادیر ممکن از n هستند:

n=0 شکست در تمام کاماهای بعد از =>
n=1 stable: شکستن تمام کاماها بعد از => اگر ظرف باز است،
به جز ظروف یک خطی
n=2 در تمام کاماها بعد از => شکسته شود، اما سعی کنید حداکثر را تشکیل دهید
حداکثر طول ظرف یک خط
n=3 به هیچ وجه با ویرگول بعد از => رفتار نکنید
n=4 همه چیز را بشکنید: مانند n=0 اما یک ظرف کوتاه را نیز بشکنید
a => در صورت استفاده از -vt=0 کاما به دنبال ندارد
n=5 پایدار: مانند n=1 اما همچنین در ظروف یک خطی باز می شکند
-vt=0 استفاده می شود (پیش فرض)

به عنوان مثال، با توجه به تک خط زیر، perltidy به طور پیش فرض هیچ اضافه نمی کند
خط شکسته می شود زیرا ظرف یک خطی موجود را می شکند:

bless { B => $B, Root => $Root } => $package;

با استفاده از -Cab = 0 بعد از هر آیتم پیکانی با کاما یک استراحت اجباری می کند:

# perltidy -cab=0:
برکت {
B => B $،
Root => $Root
} => $package;

اگر perltidy متعاقباً با این کانتینر شکسته اجرا شود، به طور پیش‌فرض اجرا می‌شود
شکستن بعد از هر '=>' زیرا ظرف اکنون خراب است. برای اصلاح یک خط
ظرف، پارامتر -Cab = 2 می تواند استفاده شود.

پرچم -Cab = 3 می توان برای جلوگیری از برخورد ویژه با این کاماها استفاده کرد. که در
در این مورد، آیتمی مانند "01" => 31 به عنوان یک مورد در یک جدول در نظر گرفته می شود. در
تعداد فیلدهای این جدول با همان قوانینی که برای آنها استفاده می شود تعیین می شود
هر میز دیگری به عنوان مثال.

# perltidy -cab=3
%last_day من = (
"01" => 31، "02" => 29، "03" => 31، "04" => 30،
"05" => 31، "06" => 30، "07" => 31، "08" => 31،
"09" => 30، "10" => 31، "11" => 30، "12" => 31
);

حفظ or نادیده گرفتن موجود لاین می شکند
چندین پارامتر اضافی برای کنترل میزان خط موجود است
شکست در اسکریپت ورودی بر اسکریپت خروجی تأثیر می گذارد. در بیشتر موارد، پیش فرض است
مقادیر پارامتر به گونه ای تنظیم می شوند که در صورت امکان انتخاب، سبک خروجی از آن پیروی می کند
سبک ورودی به عنوان مثال، اگر یک ظرف منطقی کوتاه در اسکریپت ورودی شکسته شود،
سپس رفتار پیش فرض این است که در اسکریپت خروجی شکسته باقی بماند.

بیشتر پارامترهای این بخش فقط برای یک تبدیل یکباره مورد نیاز هستند
یک اسکریپت از طول کانتینر کوتاه تا طول کانتینر بلندتر. اثر معکوس،
از تبدیل طول ظروف بلند به طول های کوتاه تر، می توان به طور موقت به دست آورد
با استفاده از حداکثر طول خط کوتاه

-بول, -- break-at-old-logical-breakpoints
به‌طور پیش‌فرض، اگر یک عبارت منطقی در «&&»، «||»، «and» یا «یا» شکسته شود، سپس
ظرف شکسته خواهد ماند همچنین، در کلمات کلیدی داخلی "اگر" و "اگر"
به طور معمول حفظ خواهد شد. برای جلوگیری از این امر و در نتیجه تشکیل خطوط طولانی تر، استفاده کنید -nbol.

-بوک, -- break-at-old-keyword-breakpoints
به طور پیش‌فرض، perltidy قبل از کلمات کلیدی یک نقطه شکست را حفظ می‌کند که ممکن است لیست‌ها را برگرداند.
مانند «مرتب کردن» و . این اجازه می دهد تا زنجیره های این اپراتورها یک نمایش داده شوند
در هر خط استفاده کنید -nbok برای جلوگیری از حفظ این نقاط شکست.

-بله, -- break-at-قدیمی-سه تایی-نقاط گسست
به طور پیش فرض، اگر یک عملگر شرطی (سه تایی) در یک ":" شکسته شود، این کار انجام می شود
شکسته بماند برای جلوگیری از این امر و در نتیجه تشکیل خطوط طولانی تر، استفاده کنید -nbot.

-بو, -- break-at-old-attribute-breakpoints
به‌طور پیش‌فرض، اگر فهرست ویژگی‌ها با یک «:» در فایل مبدأ شکسته شود، آن‌وقت خواهد بود
شکسته بماند به عنوان مثال، با توجه به کد زیر، خط در ":" شکسته می شود
حفظ خواهد شد:

@ من
: رشته
: به طور پیش فرض(1)
: Get('Name' => 'foo') : Set('Name');

اگر مشخصه ها در یک خط در کد منبع قرار داشته باشند، در a باقی می مانند
در صورت امکان تک خط

برای جلوگیری از این امر، و در نتیجه همیشه خطوط طولانی‌تری تشکیل می‌دهند، استفاده کنید -nboa.

-iob, -نقاط گسست قدیمی را نادیده بگیرید
از این پرچم استفاده کنید تا به perltidy بگویید شکست های خط موجود را تا حداکثر میزان نادیده بگیرد
ممکن است. این باعث تولید طولانی ترین ظروف ممکن، صرف نظر از این خواهد شد
نوع، که از حد طول خط تجاوز نمی کند.

-بوس, --keep-interior-semicarons
استفاده از -بوس پرچم را برای جلوگیری از شکستن نقطه ویرگول در صورتی که شکستی در آن وجود نداشته باشد
فایل ورودی معمولاً perltidy بعد از هر نقطه ویرگول یک خط جدید قرار می دهد که
یک دستور را خاتمه می دهد مگر اینکه چندین دستور در یک پرانتز یک خطی وجود داشته باشد
مسدود کردن. برای نشان دادن، خطوط ورودی زیر را در نظر بگیرید:

dbmclose(%verb_delim); unef %verb_delim;
dbmclose(%expanded); unef %expanded;

پیش‌فرض این است که بعد از هر دستور شکسته می‌شود و می‌دهد

dbmclose(%verb_delim);
unef %verb_delim;
dbmclose(%expanded);
unef %expanded;

با ناخوشایند -بوس عبارات متعدد حفظ می شوند:

dbmclose(%verb_delim); unef %verb_delim;
dbmclose(%expanded); unef %expanded;

اظهارات همچنان مشمول مقدار مشخص شده هستند حداکثر طول خط و
در صورت تجاوز از این حداکثر شکسته می شود.

جای خالی لاین کنترل
خطوط خالی می توانند خوانایی یک اسکریپت را بهبود بخشند اگر به دقت قرار داده شوند.
Perltidy چندین دستور برای کنترل درج، نگهداری و حذف دارد
خطوط خالی

-fbl, --تجمیع-خطوط خالی
تنظیم -fbl اگر می خواهید خطوط خالی اسکریپت شما دقیقاً به همان شکلی که هستند باقی بمانند.
بقیه پارامترهای این بخش ممکن است نادیده گرفته شوند. (توجه: تنظیم
-fbl پرچم معادل تنظیم است -mbl=0 و -kbl=2).

-بی بی سی, --blanks-for-comment
یک خط خالی قبل از یک نظر تمام خط معرفی می شود. این پیش فرض است. استفاده کنید
-nbbc or --noblanks-pre-comment برای جلوگیری از وجود چنین خطوط خالی
معرفی کرد.

-blbs=n, --blank-lines-before-subs=n
پارامتر -blbs=n کمترین درخواست را دارد n خطوط خالی قبل از یک تعریف فرعی است که
نظری را دنبال نمی کند و بیش از یک خط است. پیش فرض است
<-blbs=1>. شروع و END بلوک ها گنجانده شده است.

تعداد درخواستی دستور خالی بدون توجه به مقدار درج خواهد شد
--maximum-consecutive-blank-lines=n (-mbl=n) با این استثنا که اگر -mbl=0 سپس نه
خالی ها خروجی خواهند شد.

این پارامتر با مقدار تعامل دارد k از پارامتر
--maximum-consecutive-blank-lines=k (-mbl=k) به شرح زیر است:

1 اگر -mbl=0 سپس هیچ جای خالی خروجی نخواهد بود. این اجازه می دهد تا همه خالی ها سرکوب شوند
با یک پارامتر در غیر این صورت،

2. اگر تعداد خطوط خالی قدیمی در فیلمنامه کمتر از n سپس اضافی
جاهای خالی برای ایجاد کل درج می شود n بدون توجه به ارزش -mbl=k.

3. اگر تعداد خطوط خالی قدیمی در اسکریپت برابر یا بیشتر شود n سپس این
پارامتر هیچ تاثیری ندارد، اما مجموع از مقدار مشخص شده در پارامتر تجاوز نخواهد کرد
-mbl=k پرچم.

-blbp=n, --blank-lines-before-packages=n
پارامتر -blbp=n کمترین درخواست را دارد n خطوط خالی قبل از بسته ای قرار می گیرند که این کار را انجام می دهد
یک نظر را دنبال نکنید پیش فرض <-blbp=1> است.

این پارامتر با مقدار تعامل دارد k از پارامتر
--maximum-consecutive-blank-lines=k (-mbl=k) به همان روشی که برای
مورد قبلی -blbs=n.

-bbs, --sblanks-for-subs
برای سازگاری با نسخه های قبلی، -bbs or --sblanks-for-subs معادل است
به -blbp=1 و -blbs=1.

به همین ترتیب، -nbbs or --noblanks-pre-subs برابر است با -blbp=0 و -blbs=0.

-ببب, --blanks-for-blocks
یک خط خالی قبل از بلوک‌های کدگذاری که توسط آن‌ها مشخص شده‌اند، معرفی می‌شود برای, برای هر,
در حین, تاو if, مگر، در شرایط زیر:

· قبل از بلوک نظری وجود ندارد.

· بلوک یک بلوک یک خطی نیست.

· تعداد خطوط متوالی غیر خالی در عمق فرورفتگی فعلی برابر است
کمترین -lbl (بخش بعدی را ببینید).

این پیش فرض است. هدف این گزینه معرفی فضایی در داخل است
کدگذاری متراکم این با نفی می شود -nbbb or --noblanks-pre-blocks.

-lbl=n --long-block-line-count=n
این کنترل می‌کند که هر چند وقت یک‌بار به perltidy اجازه اضافه کردن خطوط خالی قبل از بلوک خاص داده می‌شود
انواع (به بخش قبل مراجعه کنید). پیش فرض 8 است. وارد کردن مقدار 0 معادل است
برای وارد کردن تعداد بسیار زیاد

-mbl=n --maximum-consecutive-blank-lines=n
این پارامتر حداکثر تعداد خطوط خالی متوالی را مشخص می کند
خروجی در بخش های کد یک اسکریپت. پیش فرض n=1 است. اگر فایل ورودی دارد
بیش از n خط خالی متوالی، تعداد به n کاهش می یابد به جز موارد ذکر شده
بالا برای -blbp و -بلبس مولفه های. اگر n = 0 سپس هیچ خط خالی خروجی نخواهد بود
(مگر اینکه تمام خطوط خالی قدیمی با -kbl=2 پرچم بخش بعدی).

بدیهی است که این پرچم برای بخش‌های پاد، اسناد اینجا و نقل قول‌ها اعمال نمی‌شود.

-kbl=n, --keep-old-blank-lines=n
La -kbl=n پرچم به شما امکان کنترل نحوه برخورد با خطوط خالی موجود را می دهد.

مقادیر ممکن از n هستند:

n=0 همه خطوط خالی قدیمی را نادیده بگیرید
n=1 پایدار: جای خالی قدیمی را نگه دارید، اما با مقدار پرچم B<-mbl=n> محدود شود.
n=2 تمام خطوط خالی قدیمی را بدون توجه به ارزش پرچم B<-mbl=n> حفظ کنید.

پیش فرض این است n = 1.

-گریه, -خطوط بلک-اختیاری-بلع
این معادل است kbl=0 و برای سازگاری با نسخه های قبلی گنجانده شده است.

-نسوب, --noswallow-optionional-blank-lines
این معادل است kbl=1 و برای سازگاری با نسخه های قبلی گنجانده شده است.

سبک
یک سبک به مجموعه مناسبی از پارامترهای موجود اشاره دارد.

-gnu, - سبک gnu
-gnu به استانداردهای کدگذاری گنو تقریبی می دهد (که برای پرل اعمال نمی شود)
همانطور که گاهی اوقات اجرا می شوند. در حال حاضر، این سبک سبک پیش فرض را لغو می کند
با پارامترهای زیر:

-lp -bl -noll -pt=2 -bt=2 -sbt=2 -icp

-pbp, --perl-best-practices
-pbp مخفف پارامترهای کتاب است پرل بهترین تمرین توسط دامیان
کانوی:

-l=78 -i=4 -ci=4 -st -se -vt=2 -cti=0 -pt=1 -bt=1 -sbt=1 -bbt=1 -nsfs -nolq
-wbb="% + - * / x != == >= <= =~ !~ < > | & =
**= += *= &= <<= &&= -= /= |= >>= ||= //= .= %= ^= x="

لطفاً توجه داشته باشید که این مجموعه پارامتر شامل پرچم -st و -se است که باعث ایجاد perltidy می شود
فقط روی یک فایل به عنوان فیلتر عمل کنید. اینها را می توان با قرار دادن لغو کرد -nst و / یا -nse
بعد از پارامتر -pbp.

همچنین توجه داشته باشید که مقدار تورفتگی ادامه، -ci=4، برابر است با مقدار
تورفتگی کامل، -i=4. در برخی از عبارات پیچیده، perltidy بهتر تولید می کند
نتایج با -ci=2 است. این را می توان با قرار دادن -ci=2 بعد از -pbp پیاده سازی کرد
پارامتر. مثلا،

# perltidy -pbp
$self->{_text} = (
بخش $ ? ''
: $type eq 'اقلام' ? "ورودی بخش $"
: "بخش مربوط به $section"
)
است. (
صفحه $
? ( $section ? ' in ' : '' ). "صفحه شخصی $page$page_ext"
: "در جای دیگر این سند"
);

# perltidy -pbp -ci=2
$self->{_text} = (
بخش $ ? ''
: $type eq 'اقلام' ? "ورودی بخش $"
: "بخش مربوط به $section"
)
است. (
صفحه $
? ( $section ? ' in ' : '' ). "صفحه شخصی $page$page_ext"
: "در جای دیگر این سند"
);

دیگر کنترل
حذف متن انتخاب شده
Perltidy می تواند به طور انتخابی نظرات و/یا اسناد پاد را حذف کند. دستور -dac
or - حذف همه نظرات تمام نظرات را حذف خواهد کرد و تمام اسناد غلاف، ترک
فقط کد و هر خط کنترل سیستم پیشرو.

دستور -درد or ---delete-pod تمام اسناد غلاف (اما نه نظرات) را حذف می کند.

دو دستوری که نظرات را حذف می کنند (اما نه pod) عبارتند از: -dbc or --حذف-بلاک-نظرات
و -dsc or - حذف نظرات. (نظرات جانبی آویزان با حذف خواهند شد
نظرات را در اینجا مسدود کنید.)

نکات منفی این دستورات نیز کار می کنند و پیش فرض هستند. وقتی نظرات را مسدود کنید
حذف شوند، هر "هش بنگ" پیشرو حفظ خواهد شد. همچنین، اگر -x پرچم استفاده می شود،
هر فرمان سیستمی قبل از هش بنگ پیشرو حفظ خواهد شد (حتی اگر در آن باشد
فرم نظرات).

نوشتن متن انتخاب شده در یک فایل
هنگامی که perltidy یک فایل متنی فرمت شده می نویسد، این قابلیت را دارد که انتخاب شده را نیز ارسال کند
متن به یک فایل با a .TEE افزونه. این متن می تواند شامل نظرات و پاد باشد
مستندات.

دستور -tac or --تی-همه نظرات همه نظرات را خواهد نوشت و همه غلاف
مستندات.

دستور -tp or -- تی پاد تمام اسناد غلاف (اما نه نظرات) را خواهد نوشت.

دستوراتی که نظرات را می نویسند (اما نه pod) عبارتند از: -tbc or --tee-block-comments و
-tsc or - نظرات سمت چپ. (نظرات کناری آویزان با بلاک نوشته می شود
نظرات اینجا.)

نکات منفی این دستورات نیز کار می کنند و پیش فرض هستند.

با استفاده از .perltidyrc پرونده فرمان
اگر به طور مکرر از perltidy استفاده می کنید، احتمالا تا زمانی که a را ایجاد نکنید، خوشحال نخواهید شد
.perltidyrc برای جلوگیری از تایپ پارامترهای رایج استفاده کنید. Perltidy ابتدا نگاه خواهد کرد
در دایرکتوری فعلی شما برای یک فایل دستوری به نام .perltidyrc. اگر پیدا نکرد
یک، آن را به دنبال یکی در مکان های استاندارد دیگر ادامه خواهد داد.

این مکان های دیگر وابسته به سیستم هستند و ممکن است با دستور نمایش داده شوند
"perltidy -dpro". تحت سیستم های یونیکس، ابتدا به دنبال متغیر محیطی می گردد
PERLTIDY. سپس آن را به دنبال یک .perltidyrc فایل را در فهرست اصلی و سپس
برای یک فایل در سراسر سیستم /usr/محلی/etc/perltidyrc، و سپس به دنبال آن خواهد بود
/etc/perltidyrc. توجه داشته باشید که این دو فایل اخیر در سراسر سیستم، پیشرو ندارند
نقطه. اطلاعات بیشتر وابسته به سیستم در فایل INSTALL یافت می شود
با perltidy توزیع می شود.

در ویندوز، perltidy یک فایل پیکربندی به نام perltidy.ini را نیز جستجو می کند
از آنجایی که ویندوز فایل های با نقطه اصلی (.) را مجاز نمی کند. از "perltidy -dpro" استفاده کنید
مکان های احتمالی سیستم خود را ببینید. یک مثال ممکن است ج: \ اسناد و
تنظیمات\همه کاربران\perltidy.ini.

گزینه دیگر استفاده از متغیر محیطی PERLTIDY است. روش برای
تنظیم متغیرهای محیط به نسخه ویندوزی که استفاده می کنید بستگی دارد.
دستورالعمل های مربوط به ویندوز 95 و نسخه های بعدی را می توانید در اینجا بیابید:

http://www.netmanage.com/000/20021101_005_tcm21-6336.pdf

در ویندوز NT / 2000 / XP متغیر محیطی PERLTIDY را می توان در هر یک از آنها قرار داد
بخش کاربر یا بخش سیستم. مورد بعدی فایل پیکربندی را رایج می کند
به همه کاربران روی دستگاه حتماً مسیر کامل فایل پیکربندی را وارد کنید
در مقدار متغیر محیطی سابق. PERLTIDY=C:\ اسناد و
تنظیمات\perltidy.ini

فایل پیکربندی فرمت آزاد است و به سادگی فهرستی از پارامترها، درست مانند آنها
در خط فرمان وارد می شود. ممکن است از هر تعداد خط، با هر تعداد، استفاده شود
از پارامترها در هر خط، اگرچه ممکن است خواندن آن با یک پارامتر در هر خط راحت‌تر باشد
خط متن نظر با # شروع می شود، و همچنین باید یک فاصله قبل از # for وجود داشته باشد
نظرات جانبی این ایده خوبی است که پارامترهای پیچیده را به صورت تکی یا دوگانه قرار دهید
نقل قول ها

در اینجا مثالی از a .perltidyrc فایل:

# این یک فایل پیکربندی ساده .perltidyrc است
# این یک سبک با فاصله زیاد را اجرا می کند
-se # خطا به خروجی خطای استاندارد
-w # همه هشدارها را نشان می دهد
مهاربندهای -bl # روی خطوط جدید
-pt=0 # پرنس اصلا سفت نیست
-bt=0 # بریس سفت نیست
-sbt=0 # براکت مربع محکم نیست

پارامترهای موجود در .perltidyrc فایل ابتدا نصب می شود، بنابراین هر پارامتری داده می شود
خط فرمان بر آنها اولویت خواهد داشت.

برای جلوگیری از سردرگمی، perltidy هر دستوری را در فایل .perltidyrc نادیده می گیرد.
باعث نوعی تخلیه و خروج شود. اینها هستند:

-h -v -ddf -dln -dop -dsn -dtt -dwls -dwrs -ss

چندین گزینه وجود دارد که ممکن است در رفع اشکال مفید باشد .perltidyrc فایل:

· یک دستور بسیار مفید است --dump-profile or -dpro. فهرستی از همه را می نویسد
نام فایل های پیکربندی بر روی خروجی استاندارد تست شده و در صورت یافتن فایل، آن را بررسی می کند
قبل از خروج، محتوا را به خروجی استاندارد تخلیه می کند. بنابراین، برای پیدا کردن کجا
perltidy به دنبال فایل‌های پیکربندی خود می‌گردد، و اگر یکی را انتخاب کند، فقط کدام را انتخاب می‌کند
را وارد کنید

perltidy -dpro

· توسعه و آزمایش فایل های پیکربندی با نام های جایگزین ممکن است ساده ترین باشد،
و آنها را با -pro=نام فایل در خط فرمان سپس نام مورد نظر را تغییر دهید
فایل به .perltidyrc هنگامی که به پایان رسید.

· پارامترهای موجود در .perltidyrc فایل را می توان با -npro گزینه.

· دستورات -- گزینه های dump, --dump-defaults, - نام‌های طولانیو
- نامهای کوتاه، که همه در زیر توضیح داده شده است، ممکن است همه مفید باشند.

ایجاد یک مخفف جدید
یک نماد ویژه برای استفاده در a موجود است .perltidyrc فایل برای ایجاد یک
مخفف گروهی از گزینه ها. از این می توان برای ایجاد یک مختصر برای یکی استفاده کرد
یا سبک های بیشتری که اغلب، اما نه همیشه، استفاده می شوند. علامت گذاری گروه بندی است
گزینه های درون پرانتزهای فرفری که قبل از آنها نام نام مستعار (بدون
خطوط پیشرو)، مانند این:

کلمه جدید {
-OPT1
-OPT2
}

جایی که کلمه جدید مخفف است و انتخاب 1و غیره، پارامترهای موجود هستند or دیگر
مخفف ها. شرط اصلی نحوی این است که مخفف جدید باید از ابتدا شروع شود
یک خط جدید فاصله قبل و بعد از بریس های فرفری اختیاری است. برای یک خاص
به عنوان مثال، خط زیر

هوادار {-bl -pt=0 -bt=0 -sbt=0}

را می توان در یک قرار داد .perltidyrc فایل، و سپس به میل خود فراخوانی می شود

perltidy -airy somefile.pl

(از "-هوا" یا "--هوا" ممکن است استفاده شود).

رد شدن از دستورات غیر پرل پیشرو با -x or --به دنبال-هش-بنگ
اگر اسکریپت شما دارای خطوط اصلی دستورات سیستم یا متن دیگری است که معتبر نیستند
کد پرل، و از ابتدای کد پرل با یک "هش بنگ" جدا می شوند.
خط، (یک خط به شکل "#!...perl")، باید از آن استفاده کنید -x پرچم برای گفتن perltidy
هیچ خطی را قبل از خط "hash-bang" تجزیه و قالب بندی نکنید. این گزینه نیز
هنگام بررسی نحو، پرل را با یک پرچم -x فراخوانی می کند. این گزینه در ابتدا بود
اضافه شده است تا به perltidy اجازه دهد تا اسکریپت های VMS تعاملی را تجزیه کند، اما باید برای آن استفاده شود
هر اسکریپتی که معمولاً با "perl -x" فراخوانی می شود.

غیرقابل خواندن یک فایل
هدف perltidy بهبود خوانایی فایل ها است، اما دو مورد وجود دارد
دستوراتی که اثر معکوس دارند، -- مانگل و -- اکسترود کردن. آنها در واقع هستند
صرفاً نام مستعار برای ترکیبی از پارامترهای دیگر. هر دوی اینها همه امکان پذیر است
فضای خالی، اما نظرات و اسناد پاد را بگذارید، به طوری که آنها اساسا باشند
برگشت پذیر تفاوت اینها در این است -- مانگل کمترین ممکن را قرار می دهد
خط در یک اسکریپت در حالی که می شکند -- اکسترود کردن حداکثر ممکن را قرار می دهد. توجه داشته باشید که اینها
گزینه ها هیچ ابهام معنی داری ارائه نمی دهند، زیرا می توان از perltidy استفاده کرد
فایل ها را دوباره فرمت کنید آنها در ابتدا برای کمک به آزمایش توکن سازی توسعه داده شدند
منطق perltidy، اما آنها کاربردهای دیگری دارند. یک مورد استفاده برای -- مانگل زیر است:

perltidy --mangle myfile.pl -st | perltidy -o myfile.pl.new

این حداکثر تعداد بلوک های یک خطی ممکن را تشکیل می دهد (به بخش بعدی مراجعه کنید)، و
گاهی اوقات می تواند به پاکسازی یک اسکریپت با فرمت بد کمک کند.

می توان از یک تکنیک مشابه استفاده کرد -- اکسترود کردن بجای -- مانگل برای ایجاد حداقل
تعداد بلوک های یک خطی

استفاده دیگر برای -- مانگل ترکیب آن با -dac برای کاهش حجم فایل پرل
اسکریپت

بلوک های یک خطی
در مورد بلوک های یک خطی باید به چند نکته توجه کرد. بلوک یک خطی است
چیزی مثل این،

اگر ($x > 0) { $y = 1 / $x }

که در آن محتویات داخل بریس های فرفری به اندازه ای کوتاه است که روی یک خط قرار می گیرد.

با چند استثنا، perltidy بلوک های یک خطی موجود را در صورت امکان حفظ می کند
در محدودیت طول خط، اما تلاشی برای ایجاد موارد جدید نمی کند. در دیگر
کلمات، perltidy سعی می کند از سبک بلوک یک خطی فایل ورودی پیروی کند.

با این حال، اگر یک بلوک یک خطی بیشتر از حداکثر طول خط باشد، این کار انجام خواهد شد
به چند خط شکسته شود وقتی این اتفاق می افتد، perltidy هر کدام را بررسی می کند و اضافه می کند
نقطه ویرگول پایانی اختیاری (مگر اینکه -nasc از گزینه استفاده می شود) اگر بلوک a باشد
بلوک کد

استثنا اصلی این است که perltidy سعی می کند بلوک های یک خطی جدید را به دنبال خود تشکیل دهد
کلمات کلیدی "map"، "eval" و "sort"، زیرا این بلوک های کد اغلب کوچک هستند و
به وضوح در یک خط نمایش داده می شود.

قوانین بلوک یک خطی می تواند با گزینه cuddled-else تضاد داشته باشد. وقتی که دیگری را در آغوش گرفت
گزینه مورد استفاده قرار می گیرد، perltidy بلوک های یک خطی موجود را حفظ می کند، حتی اگر آنها رعایت نکنند
قالب بندی در آغوش گرفته.

گاهی اوقات، زمانی که بلوک های یک خطی شکسته می شوند زیرا از خط موجود فراتر می روند
طول، قالب بندی سبک پرانتز درخواستی را نقض می کند. اگر این اتفاق بیفتد،
فرمت مجدد اسکریپت برای بار دوم باید مشکل را اصلاح کند.

اشکال زدایی
پرچم‌های زیر برای اشکال‌زدایی در دسترس هستند:

--dump-defaults or -ddf گزینه پیش فرض را روی خروجی استاندارد می نویسد و خارج می شود

--dump-profile or -dpro نام فایل پیکربندی فعلی و آن را می نویسد
محتویات به خروجی استاندارد و خروج.

-- گزینه های dump or -داپ گزینه فعلی را روی خروجی استاندارد می نویسد و خارج می شود.

- نام‌های طولانی or -dln تمام نام‌های طولانی خط فرمان را می‌نویسد (به
Get_options) به خروجی استاندارد و خروج.

- نامهای کوتاه or -dsn تمام نام های کوتاه خط فرمان را در خروجی استاندارد می نویسد
و ترک

--dump-token-types or -dtt لیستی از انواع توکن ها را در خروجی استاندارد می نویسد
و ترک

--dump-want-left-space or -dwls هش %want_left_space را به حالت استاندارد خواهد نوشت
خروجی و خروج. به بخش کنترل فضای خالی اطراف نشانه ها مراجعه کنید.

--dump-want-right-space or -dwrs هش %want_right_space را به حالت استاندارد خواهد نوشت
خروجی و خروج. به بخش کنترل فضای خالی اطراف نشانه ها مراجعه کنید.

--بدون حفظ کردن or -nmem به خاطره نویسی تبدیل خواهد شد. حافظه‌گذاری می‌تواند زمان اجرا را کاهش دهد
اجرای perltidy به طور مکرر در یک فرآیند واحد. به طور پیش فرض روشن است اما می تواند باشد
غیرفعال شده برای تست با -nmem.

-اشکال زدایی یک فایل با پسوند می نویسد اشکال زدایی برای هر فایل ورودی که نشان می دهد
توکن سازی تمام خطوط کد

کار با MakeMaker، AutoLoader و SelfLoader
اولین خط $VERSION از یک فایل که ممکن است توسط MakeMaker ارزیابی شود، عبور داده می شود
بدون تغییر به جز تورفتگی. استفاده کنید --nopass-version-line، یا -npvl، غیر فعال کردن
این ویژگی

اگر از ماژول AutoLoader استفاده شود، perltidy پس از مشاهده به قالب بندی کد ادامه می دهد
یک خط __END__ استفاده کنید --nolook-for-autoloader، یا -nlal، برای غیرفعال کردن این ویژگی.

به همین ترتیب، اگر از ماژول SelfLoader استفاده شود، perltidy به قالب بندی کد ادامه می دهد
پس از دیدن یک خط __DATA__. استفاده کنید --nolook-for-selfloader، یا -nlsl، غیر فعال کردن
این ویژگی

حل مشکلات نسخه قدیمی پرل
Perltidy شامل تعدادی قوانین است که به جلوگیری از ظرافت ها و مشکلات شناخته شده کمک می کند
با نسخه های قدیمی پرل، و این قوانین همیشه بر هر چیزی اولویت دارند
پرچم های قالب بندی تنظیم شده است. به عنوان مثال، perltidy معمولاً از شروع a اجتناب می کند
خط جدید با کلمه بدون کلمه، زیرا در صورت فعال بودن "استفاده از سخت" ممکن است مشکل ایجاد کند.

هیچ راهی برای نادیده گرفتن این قوانین وجود ندارد.

HTML OPTIONS

La -html سوئیچ اصلی
پرچم -html باعث می شود که perltidy یک فایل html با پسوند بنویسد . HTML غیر فعال. بنابراین برای
برای مثال دستور زیر

perltidy -html somefile.pl

یک فایل html رنگی با نام تولید خواهد کرد somefile.pl.html که ممکن است مشاهده شود
با یک مرورگر

لطفا توجه داشته باشید:: در این حالت perltidy هیچ فرمت فایل ورودی را انجام نمی دهد و
یک فایل فرمت شده با پسوند نمی نویسد .tdy. این بدان معنی است که دو perltidy
اجراها برای ایجاد یک کپی کاملاً فرمت شده و html از یک اسکریپت مورد نیاز هستند.

La -پیش پرچم برای قطعه کد
هنگامی که -پیش پرچم داده شده است، فقط بخش از پیش قالب بندی شده، در داخل و
برچسب ها، خروجی خواهد شد. این کار گنجاندن خروجی در فایل های دیگر را ساده می کند.
پیش فرض خروجی یک صفحه وب کامل است.

La -nnn پرچم برای شماره گذاری خطوط
هنگامی که -nnn پرچم داده شده است، خطوط خروجی شماره گذاری خواهند شد.

La -toc، یا --html-table-of-contents پرچم
به‌طور پیش‌فرض، فهرستی از محتویات بسته‌ها و زیر روال‌ها در قسمت نوشته می‌شود
شروع خروجی html استفاده کنید -ntoc برای جلوگیری از این این ممکن است مفید باشد، برای مثال،
برای یک سند پاد که حاوی تعدادی قطعه کد نامرتبط است. فقط این پرچم
بر فهرست مطالب کد تأثیر می گذارد. بر هیچ فهرستی از مطالب تأثیری ندارد
تولید شده توسط pod2html (به مورد بعدی مراجعه کنید).

La غلاف، یا --pod2html پرچم
دو گزینه برای قالب بندی اسناد غلاف وجود دارد. پیش فرض این است که عبور کنید
pod از طریق ماژول Pod::Html (که اساس ابزار pod2html را تشکیل می دهد). هر
بخش های کد توسط perltidy فرمت می شوند و نتایج ادغام می شوند. توجه: perltidy
هنگامی که از Pod::Html استفاده می شود یک فایل موقت ایجاد می کند. به "فایل ها" مراجعه کنید. همچنین، Pod::Html ایجاد می کند
فایل های موقت برای کش آن

توجه: Perltidy تعداد خطوط "=cut" را می شمارد و متن پاد را به
در بالای فایل html اگر یک "=cut" وجود داشته باشد، یا متن پاد را در حالت اصلی خود باقی می گذارد
در غیر این صورت سفارش دهید (همراه با کد).

بسیاری از پرچم های پذیرفته شده توسط pod2html ممکن است در خط فرمان perltidy گنجانده شوند.
و به pod2html منتقل می شوند. در برخی موارد، پرچم ها دارای پیشوند "pod" هستند
تاکید کنید که آنها برای pod2html هستند و این پیشوند قبل از آنها حذف خواهد شد
به pod2html منتقل می شوند. پرچم هایی که دارای پیشوند اضافی "pod" هستند عبارتند از:

--[no]poheadader --[no]podindex --[no]podrecurse --[no]podquiet
--[no]podverbose --podflush

پرچم هایی که نسبت به استفاده از آنها در pod2html تغییری نکرده اند عبارتند از:

--backlink=s --cachedir=s --htmlroot=s --libpods=s --title=s
--podpath=s --podroot=s

که در آن 's' یک رشته کاراکتر مناسب است. همه این پرچم ها در دسترس نیستند
نسخه های قدیمی Pod::Html. برای اطلاعات بیشتر به مستندات Pod::Html خود مراجعه کنید.

جایگزین، نشان داده شده با -npod، استفاده از Pod::Html نیست، بلکه برای قالب بندی است
متن پاد به صورت مورب (یا هر آنچه که صفحه سبک نشان می دهد)، بدون html خاص
نشانه گذاری این مفید است، برای مثال، اگر از pod به عنوان یک راه جایگزین استفاده می شود
نظرات بنویس

La -frm، یا --قاب ها پرچم
به طور پیش فرض، یک فایل خروجی html تولید می شود. این را می توان با تغییر داد -frm
گزینه ای که یک قاب ایجاد می کند که فهرست مطالب را در پانل سمت چپ نگه می دارد
کد منبع در سمت راست این امر مرور کد را ساده می کند. برای مثال فرض کنید
که فایل ورودی است MyModule.pm. سپس، برای انتخاب های پسوند فایل پیش فرض، اینها
سه فایل ایجاد خواهد شد:

MyModule.pm.html - قاب
MyModule.pm.toc.html - فهرست مطالب
MyModule.pm.src.html - کد منبع فرمت شده

بدیهی است که این طرح نامگذاری فایل مستلزم آن است که خروجی به یک فایل واقعی هدایت شود (مانند
برخلاف، مثلاً، خروجی استاندارد). اگر اینطور نیست یا پسوند فایل
ناشناخته است، -frm گزینه نادیده گرفته خواهد شد.

La -text=s، یا --html-toc-extension پرچم
از این پرچم برای تعیین پسوند فایل اضافی فایل فهرست مطالب استفاده کنید
از فریم های html استفاده می شود. پیش فرض "toc" است. به "تعیین پسوندهای فایل" مراجعه کنید.

La -sext=s، یا --html-src-extension پرچم
از این پرچم برای مشخص کردن پسوند فایل اضافی فایل محتوا در فریم های html استفاده کنید
استفاده می شود. پیش فرض "src" است. به "تعیین پسوندهای فایل" مراجعه کنید.

La -هنت، یا --html-entities پرچم
این پرچم استفاده از Html::Entities را برای قالب بندی html کنترل می کند. به طور پیش فرض،
ماژول Html::Entities برای رمزگذاری نمادهای خاص استفاده می شود. این ممکن است درست نباشد
چیزی برای برخی از ترکیبات مرورگر/زبان. از --nohtml-entities یا -nhent to استفاده کنید
جلوگیری از این

شیوه نامه ها
برگه های سبک کنترل و تنظیم ظاهر html را بسیار راحت می کند
صفحات رفتار پیش‌فرض نوشتن یک صفحه از html با یک شیوه نامه تعبیه شده است.

یک جایگزین برای یک شیوه نامه تعبیه شده ایجاد یک صفحه با پیوند به یک است
برگه سبک خارجی این با نشان داده شده است -css=نام فایل، جایی که خارجی
شیوه نامه است نام فایل. برگه سبک خارجی نام فایل ایجاد خواهد شد اگر و
فقط در صورتی که وجود نداشته باشد. این گزینه برای کنترل چندین صفحه مفید است
یک شیوه نامه واحد

برای ایجاد perltidy برای نوشتن یک شیوه نامه به خروجی استاندارد و خروج، از -ss، یا
-- شیوه نامه، پرچم. اگر شیوه نامه برای برخی نوشته نشود، مفید است
دلیل، مانند اگر -پیش پرچم استفاده شد بنابراین، برای مثال،

perltidy -html -ss >mystyle.css

یک شیوه نامه با ویژگی های پیش فرض برای فایل می نویسد mystyle.css.

استفاده از شیوه نامه تشویق می شود، اما یک صفحه وب بدون شیوه نامه می تواند
با پرچم ایجاد شده است -nss. اگر باید مطمئن شوید که بزرگتر هستید از این گزینه استفاده کنید
مرورگرها (به طور کلی، نسخه های قبل از 4.0 Netscape Navigator و اینترنت
Explorer) می‌تواند رنگ‌بندی نحوی فایل‌های html را نمایش دهد.

کنترل خصوصیات HTML
توجه: معمولاً پذیرش ویژگی های پیش فرض و سپس ویرایش آن راحت تر است
شیوه نامه ای که تولید می شود. با این حال، این بخش نحوه کنترل را نشان می دهد
خواص با پرچم به perltidy.

رنگ های نحو ممکن است از مقادیر پیش فرض خود با پرچم های طولانی تغییر کنند
فرم، -html-color-x=nیا راحت تر فرم کوتاه، -hcx=n، که در آن x
یکی از کلمات زیر است، و x مخفف مربوطه است:

نوع توکن xx
---------- ----------
نظر دیدگاه ج
عدد عددی n
شناسه شناسه i
bareword، تابع bareword w
کلمه کلیدی کلمه کلیدی k
کاملاً، الگوی نقل قول q
اینجا doc text here-doc-text h
اینجا doc target here-doc-target hh
نقطه گذاری نقطه گذاری pu
پرانتز پرانتز ص
مهاربندهای سازه ای سازه s
نقطه ویرگول نقطه ویرگول sc
کولون کولون شرکت
کاما کاما سانتی متر
برچسب برچسب j
زیر تعریف نام زیربرنامه m
متن pod pod-text pd

یک مجموعه پیش فرض از رنگ ها تعریف شده است، اما ممکن است با ارائه مقادیر تغییر کنند
به هر یک از پارامترهای زیر، که در آن n یا یک مقدار رنگ شش رقمی RGB است یا
نام ascii برای یک رنگ، مانند "قرمز".

برای نشان دادن، دستور زیر یک فایل html تولید می کند somefile.pl.html با
کلمات کلیدی "آکوا":

perltidy -html -hck=00ffff somefile.pl

و این باید برای اکثر مرورگرها معادل باشد:

perltidy -html -hck=aqua somefile.pl

Perltidy فقط هر نام غیر هگزی را که در فایل html می بیند می نویسد. به شرح زیر
16 نام رنگ در استاندارد HTML 3.2 تعریف شده است:

سیاه => 000000،
نقره => c0c0c0،
خاکستری => 808080،
سفید => افففف،
مارون => 800000،
قرمز => ff0000،
بنفش => 800080،
فوشیا => ff00ff،
سبز => 008000،
آهک => 00ff00،
زیتون => 808000،
زرد => ffff00
نیروی دریایی => 000080،
آبی => 0000ff،
سبز => 008080،
aqua => 00ffff،

بسیاری از نام‌های بیشتر در مرورگرهای خاص پشتیبانی می‌شوند، اما استفاده از هگز امن‌ترین کار است
کدهای رنگ های دیگر جداول رنگ مفید را می توان با جستجوی اینترنتی پیدا کرد
برای "جدول رنگ HTML".

علاوه بر رنگ، دو ویژگی کاراکتر دیگر ممکن است تنظیم شود: پررنگ و مورب. برای تنظیم یک
نوع رمز برای استفاده پررنگ، از پرچم استفاده کنید --html-bold-x or -hbx، که در آن x or x هستند
نام های بلند یا کوتاه از جدول بالا. برعکس، برای تنظیم یک نوع رمز روی NOT
استفاده از پررنگ، استفاده --nohtml-bold-x or -nhbx.

به همین ترتیب، برای تنظیم نوع توکن برای استفاده از فونت ایتالیک، از پرچم استفاده کنید --html-italic-x
or -هیکس، دوباره کجا x or x نام های بلند یا کوتاه جدول بالا هستند.
و برای تنظیم یک نوع توکن به گونه ای که از حروف کج استفاده نشود، از آن استفاده کنید --nohtml-italic-x or -nhix.

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

perltidy -html -hbs -hck=00FF00 -nhbk -hik somefile.pl

رنگ پس زمینه را می توان با آن مشخص کرد --html-color-background=n، یا -hcbg=n برای
کوتاه، که در آن n یک مقدار RGB 6 کاراکتری است. رنگ پیش فرض متن مقدار است
داده شده به نقطه گذاری، که به عنوان پیش فرض سیاه است.

در اینجا نکات و نکاتی وجود دارد:

1. اگر مجموعه ترجیحی از این پارامترها را پیدا کردید، ممکن است بخواهید a ایجاد کنید
.perltidyrc فایل حاوی آنها برای توضیح به صفحه perltidy man مراجعه کنید.

2. به جای تعیین مقادیر برای این پارامترها، احتمالاً پذیرش آن آسان تر است
پیش فرض ها و سپس یک شیوه نامه را ویرایش کنید. شیوه نامه حاوی نظراتی است که
باید این کار را آسان کند.

3. فایل‌های html رنگی می‌توانند بسیار بزرگ باشند، بنابراین ممکن است بهتر باشد که بزرگ‌تر تقسیم شوند.
برای بهبود زمان دانلود، فایل ها را به قطعات کوچکتر تبدیل کنید.

مقداری مشترک INPUT کنوانسیون ها

تعیین مسدود کردن انواع
چندین پارامتر که به انواع بلوک کد اشاره می کنند ممکن است با تعیین یک نیز سفارشی شوند
لیست مرتبط انواع بلوک نوع بلوک نام کلمه کلیدی است که
آن بلوک را معرفی می کند، مانند if, دیگر، یا زیر. یک استثنا یک بلوک برچسب دار است که
هیچ کلمه کلیدی ندارد و باید فقط با دو نقطه مشخص شود. برای مشخص کردن همه بلوک ها استفاده کنید '*'.

به عنوان مثال، پارامتر زیر بلوک های "sub"، labels، "BEGIN" و "END" را مشخص می کند:

-cscl="sub : BEGIN END"

(معنای پارامتر -cscl در بالا توضیح داده شده است.) توجه داشته باشید که نقل قول لازم است
در اطراف لیست انواع بلوک به دلیل فاصله. برای مثال دیگر، موارد زیر
لیست تمام انواع بلوک را برای تنگی عمودی مشخص می کند:

-bbvtl='*'

تعیین پرونده گسترش دهنده ها
چندین پارامتر اجازه می دهد پسوندهای فایل پیش فرض لغو شوند. به عنوان مثال، یک نسخه پشتیبان
پسوند فایل ممکن است با مشخص شود -Bext = ext، که در آن EXT یک پسوند جدید است. به ترتیب
برای ارائه مقداری انعطاف به کاربر، از قرارداد زیر در همه موارد استفاده می شود
تصمیم بگیرید که آیا یک '.' باید استفاده شود. اگر پسوند "ext" با "AZ"، "az" شروع شود،
یا "0-9"، سپس با یک ' میانی به نام فایل اضافه می شود. (یا شاید یک
'_' در سیستم های VMS). در غیر این صورت مستقیماً ضمیمه خواهد شد.

به عنوان مثال، فرض کنید فایل است somefile.pl. برای "-bext=old"، یک '.' برای دادن اضافه می شود
somefile.pl.old. برای "-bext=.old"، هیچ '.' اضافی وجود ندارد. اضافه شده است، بنابراین دوباره فایل پشتیبان
is somefile.pl.old. برای "-bext=~"، هیچ نقطه ای اضافه نمی شود و فایل پشتیبان نیز خواهد بود
somefile.pl~ .

سوئیچ ها که اردیبهشت BE نفی شد

لیست زیر تمام نام‌های پارامتر کوتاه را نشان می‌دهد که به یک پیشوند 'n' اجازه می‌دهد تا آن را تولید کند
شکل نفی:

D anl asc aws b bbb bbc bbs bl bli boc bok bol bot ce
csc dac dbc dcsc ddf dln dnl dop dp dpro dsc dsm dsn dtt dwls
dwrs dws f fll frm fs hsc html ibc icb icp iob isbc lal log
lp lsl ohbr okw ola oll opr opt osbr otr ple pod pvl q
sbc sbl schb scp scsb sct se sfp sfs skp sob sohb sop sosb sot
ssc st sts syn t tac tbc toc tp tqw tsc wx bar kis

به طور معادل، پیشوند "نه" یا "نه-" در نام های طولانی مربوطه ممکن است استفاده شود.

محدودیت ها

محدودیت های تجزیه
Perltidy باید روی اکثر اسکریپت های perl به درستی کار کند. خودآزمایی زیادی انجام می دهد،
اما با این حال، ممکن است یک خطا معرفی شود و شناسایی نشود.
بنابراین، تهیه نسخه پشتیبان دقیق و تست اسکریپت های فرمت شده ضروری است.

محدودیت اصلی فعلی این است که perltidy ماژول های موجود در "use" را اسکن نمی کند.
بیانیه. این امر باعث می‌شود که حدس زدن زمینه هر کلمه خالی که معرفی شده است ضروری باشد
توسط چنین ماژول هایی Perltidy الگوریتم‌های حدس‌زنی خوبی دارد، اما خطاناپذیر نیستند.
زمانی که باید حدس بزند، پیامی در فایل log می گذارد.

در صورت برخورد با اشکال، لطفاً آن را گزارش دهید.

چه perltidy تجزیه و فرمت نمی کند
Perltidy تورفتگی می کند اما نظرات و نقل قول های "qw" را دوباره قالب بندی نمی کند. Perltidy وارد نمی شود
به هر طریقی محتوای اسناد اینجا یا متن نقل قول شده را تغییر دهید، حتی اگر حاوی آنها باشد
کد منبع (اما شما می توانید آنها را جداگانه فرمت کنید). Perltidy ندارد
بخش های "قالب" را به هر نحوی فرمت کنید. و البته پاد را اصلاح نمی کند
اسناد.

با استفاده از خدمات onworks.net از perltidyp به صورت آنلاین استفاده کنید