.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PERL2LCOV" "1" "2026-07-07" "2.5" "LCOV"
.SH "نام (NAME)"
perl2lcov \- تبدیل داده‌های پوشش کد پرل از Devel::Cover به قالب lcov
.INDENT 0.0
.TP
.B بخش راهنما
1
.TP
.B گروه راهنما
ابزارهای LCOV
.UNINDENT
.SH "نام (NAME)"
.INDENT 0.0
.TP
.B perl2lcov
تبدیل داده‌های پوشش کد پرل از \fBDevel::Cover\fP به قالب lcov
.UNINDENT
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
perl2lcov [\-\-output filename] [\-\-testname name] [options] cover_db+
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBperl2lcov\fP اطلاعات پوشش کد پرل را در یک یا چند دایرکتوری داده‌های پوشش (تولیدشده توسط ماژول \fBDevel::Cover\fP در پرل) پیمایش کرده و آن‌ها را به قالب \fB\&.info\fP در LCOV تبدیل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
علاوه بر گزینه‌های عمومی که توسط سایر ابزارهای مجموعه LCOV پشتیبانی می‌شوند (\fIمانند\fP \fB\-\-comment\fP، \fB\-\-version\-script\fP، \fB\-\-ignore\-error\fP، \fB\-\-substitute\fP، \fB\-\-exclude\fP و \fIغیره\fP)، گزینه‌های اختصاصی این ابزار عبارتند از:
.INDENT 0.0
.TP
.B \fB\-\-output\fP \fIfilename\fP, \fB\-o\fP \fIfilename\fP
داده‌های LCOV در فایل مشخص‌شده نوشته خواهند شد. در صورت عدم استفاده از این گزینه، داده‌ها در فایل \fBperlcov.info\fP در دایرکتوری جاری نوشته می‌شوند.
.TP
.B \fB\-\-testname\fP \fIname\fP
اطلاعات پوشش با نام موردآزمون ارائه‌شده مرتبط خواهند شد. ارائه نام الزامی نیست.
.UNINDENT
.sp
برای جزئیات سایر گزینه‌ها و تنظیمات پیکربندی پشتیبانی‌شده، \fBlcov(1) \%<file://\:\:../\:man/\:lcov\:.1\:.html>\fP و \fBlcovrc(5) \%<file://\:\:../\:man/\:lcovrc\:.5\:.html>\fP را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.sp
تولید داده‌های پوشش کد پرل و تبدیل آن به قالب LCOV:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# نوشتن داده‌های پوشش خط، شاخه، شرط و زیرروال پرل
# در \(aqmyPerlDB\(aq در دایرکتوری جاری
$ perl \-MDevel::Cover=\-db,./myPerlDB,\-coverage,statement,branch,condition,subroutine,\-silent,1 myScript.pl

# یا: نوشتن تمام انواع پوشش شناخته‌شده توسط پرل در \(aqmyPerlDB2\(aq
# توجه داشته باشید که perl2lcov انواعی را که پشتیبانی نمی‌کند
# (pod، time و path) نادیده می‌گیرد
$ perl \-MDevel::Cover=\-db,./myPerlDB2,\-silent,1 myScript.pl

# اجرای \(aqcover\(aq از بسته نصبی Devel::Cover برای استخراج داده‌های
# زمان اجرا به یک شکل کاربردی. این کار همچنین یک گزارش HTML
# در \(aqmyCoverDB\(aq ایجاد می‌کند
$ cover myCoverDB \-silent 1

# اجرای مبدل perl2lcov برای تولید داده‌های با قالب LCOV:
$ perl2lcov \-o perldata.info [\-\-testname myTestName] myCoverDB

# تولید یک گزارش پوشش کد در قالب HTML:
$ genhtml \-o html_report perldata.info
.EE
.UNINDENT
.UNINDENT
.SH "نکات (NOTES)"
.sp
داده‌های تولیدشده توسط \fBDevel::Cover\fP همیشه از نظر داخلی سازگار نیستند. برای مثال:
.INDENT 0.0
.IP \(bu 2
برخی از توابعی که هرگز فراخوانی نمی‌شوند در داده‌های پوشش کد ظاهر نمی‌گردند.
.IP \(bu 2
گاهی ممکن است یک خط اجرا شده به نظر برسد (شمارش اجرای غیرصفر)، اما هیچ‌یک از عبارات شاخه‌ای درون آن ارزیابی نشده باشند. (اگر خط اجرا شده باشد، دست‌کم یکی از شرایط شاخه باید ارزیابی شده باشد.)
.UNINDENT
.sp
این وضعیت می‌تواند باعث شود ابزارهای مختلف در بسته LCOV خطاهایی از نوع \fBinconsistent\fP تولید کنند\&.
.sp
در این حالت، می‌توانید:
.INDENT 0.0
.IP \(bu 2
بررسی‌های سازگاری را کاملاً نادیده بگیرید: بخش \fBskip_consistency_checks\fP در \fBlcovrc(5) \%<file://\:\:../\:man/\:lcovrc\:.5\:.html>\fP را ببینید\&.
.IP \(bu 2
خطا را نادیده بگیرید: بخش \fB\-\-ignore\-error\fP در \fBgenhtml(1) \%<file://\:\:../\:man/\:genhtml\:.1\:.html>\fP را ببینید\&.
.IP \(bu 2
کد مشکل‌ساز را مستثنی کنید: بخش‌های \fB\-\-exclude\fP، \fB\-\-filter\fP و \fB\-\-omit\-lines\fP در \fBgenhtml(1) \%<file://\:\:../\:man/\:genhtml\:.1\:.html>\fP را ببینید\&.
.UNINDENT
.SH "نویسندگان (AUTHORS)"
.sp
Henry Cox <\%<henry\:.cox@\:mediatek\:.com>>
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBlcov(1) \%<file://\:\:../\:man/\:lcov\:.1\:.html>\fP, \fBgenhtml(1) \%<file://\:\:../\:man/\:genhtml\:.1\:.html>\fP, \fBlcovrc(5) \%<file://\:\:../\:man/\:lcovrc\:.5\:.html>\fP
.INDENT 0.0
.IP \(bu 2
مستندات ماژول \fBDevel::Cover\fP
.UNINDENT
.sp
\%<https://\:metacpan\:.org/\:pod/\:Devel::Cover>
.SH "حق نشر (COPYRIGHT)"
2024-2026, LCOV Project
.\" End of generated man page.