کامنت‌ها و مستندسازی

کامنت با #، مستندات POD و نشانگر __END__.

کامنت تک‌خطی با #

# این کل یک کامنت است
say "hello";    # کامنت انتهای خط

پرل کامنت چندخطی داخلی ندارد! هر خط باید # خودش را داشته باشد:

# خط اول توضیح
# خط دوم توضیح
# خط سوم توضیح
say "ok";

پرل سیستم مستندسازی داخلی به نام POD (Plain Old Documentation) دارد:

=pod
این بخش مستندات است
و کامپایلر نادیده‌اش می‌گیرد
می‌تواند چند خط باشد
=cut

say "بعد از POD";

=pod شروع و =cut پایان مستندات است. بین این دو، هر چیزی باشد نادیده گرفته می‌شود — مثل کامنت چندخطی!

say "برنامه اصلی";

__END__
هر چیزی بعد از این خط نادیده گرفته می‌شود
حتی کد غلط هم اشکال ندارد

# ===================================
# برنامه: محاسبه میانگین نمرات
# نویسنده: دانش‌آموز لرنینگ سیتی
# ===================================

این مبحث بخشی از دوره آموزش کامل پرل است.