genhtml - Online sa Cloud

PROGRAMA:

NAME

genhtml - Bumuo ng HTML view mula sa mga file ng data ng saklaw ng LCOV

SINOPSIS

genhtml [-h|- Tumulong] [-v|--bersyon]
[-q|--tahimik] [-s|--Ipakita ang mga detalye] [-f|--mga frame]
[-b|--baseline-file] baseline-file
[-o|--output-directory output-directory]
[-t|--pamagat pamagat]
[-d|--description-file paglalarawan-file]
[-k|--panatilihin ang mga paglalarawan] [-c|--css-file css-file]
[-p|--prefix unlapi] [--no-prefix]
[--walang pinagmulan] [--num-spaces num] [--highlight]
[--alamat] [--html-prolog prolog-file]
[--html-epilog epilog-file] [--html-extension karugtong]
[--html-gzip] [--uri-uriin] [--walang-uri]
[--function-coverage] [--walang-function-coverage]
[--saklaw ng sangay] [--walang-sangay-saklaw]
[--demangle-cpp] [--ignore-errors error]
[--config-file config-file] [--rc keyword=halaga]
[--katumpakan num]
(mga) tracefile

DESCRIPTION

Gumawa ng HTML na view ng data ng saklaw na makikita sa tracefile. Tandaan na tracefile maaari ring
isang listahan ng mga filename.

Ang mga HTML output file ay nilikha sa kasalukuyang gumaganang direktoryo maliban kung ang
--output-directory na opsyon ay ginagamit. Kung tracefile nagtatapos sa ".gz", ito ay ipinapalagay na
GZIP-compressed at ang tool na gunzip ay gagamitin upang i-decompress ito nang malinaw.

Tandaan na ang lahat ng source code file ay kailangang naroroon at nababasa sa eksaktong file system
lokasyon kung saan sila ay pinagsama-sama.

Gamitin ang opsyon --css-file upang baguhin ang layout at mga kulay ng nabuong HTML na output. Ang mga file ay
minarkahan sa iba't ibang kulay depende sa nauugnay na rate ng saklaw. Bilang default, ang
ang mga limitasyon sa saklaw para sa mababa, katamtaman at mataas na saklaw ay nakatakda sa 0-75%, 75-90% at 90-100%
porsyento ayon sa pagkakabanggit. Para baguhin ang mga value na ito, gumamit ng mga opsyon sa configuration file
genhtml_hi_limit at genhtml_med_limit.

Tandaan din na kapag nagpapakita ng mga porsyento, ang 0% at 100% ay naka-print lamang kapag ang mga halaga
ay eksaktong 0% at 100% ayon sa pagkakabanggit. Iba pang mga halaga na karaniwang bilugan
sa 0% o 100% ay sa halip ay naka-print bilang pinakamalapit na hindi hangganan na halaga. Ang pag-uugali na ito ay nasa
alinsunod sa na ng gcov(1) kasangkapan.

Opsyon

-h
- Tumulong
Mag-print ng maikling text ng tulong, pagkatapos ay lumabas.

-v
--bersyon
I-print ang numero ng bersyon, pagkatapos ay lumabas.

-q
--tahimik
Huwag mag-print ng mga mensahe ng pag-unlad.

Pinipigilan ang lahat ng output ng pag-unlad ng impormasyon. Kapag ang switch na ito ay pinagana, lamang
ang mga mensahe ng error o babala ay naka-print.

-f
--mga frame
Gumamit ng mga HTML frame para sa source code view.

Kung pinagana, isang frameset ang gagawin para sa bawat source code file, na nagbibigay ng pangkalahatang-ideya
ng source code bilang isang "naki-click" na larawan. Tandaan na babagal ang opsyong ito
kapansin-pansing paggawa ng output dahil kailangang suriin ang bawat source code character
minsan. Tandaan din na kailangang i-install ang GD.pm Perl module para sa opsyong ito
trabaho (maaaring makuha ito mula sa http://www.cpan.org).

-s
--Ipakita ang mga detalye
Bumuo ng detalyadong view ng direktoryo.

Kapag pinagana ang opsyong ito, genhtml bumubuo ng dalawang bersyon ng bawat view ng file. Isa
naglalaman ng karaniwang impormasyon kasama ang isang link sa isang "detalyadong" bersyon. Ang huli
Bukod pa rito ay naglalaman ng impormasyon tungkol sa kung aling test case ang sumaklaw sa kung ilang linya ng
bawat source file.

-b baseline-file
--baseline-file baseline-file
Gamitin ang data sa baseline-file bilang baseline ng saklaw.

Ang tracefile na tinukoy ni baseline-file ay binabasa at lahat ng bilang ay matatagpuan sa
orihinal tracefile ay nababawasan ng kaukulang mga bilang sa baseline-file
bago lumikha ng anumang output.

Tandaan na kapag ang isang bilang para sa isang partikular na linya sa baseline-file ay mas malaki kaysa sa
bilangin sa tracefile, ang resulta ay zero.

-o output-directory
--output-directory output-directory
Lumikha ng mga file sa output-directory.

Gamitin ang opsyong ito para sabihin genhtml upang isulat ang mga nagresultang file sa ibang direktoryo
kaysa sa kasalukuyan. Kung output-directory ay hindi umiiral, ito ay malilikha.

Maipapayo na gamitin ang pagpipiliang ito dahil depende sa laki ng proyekto, marami
maaaring malikha ang mga file at subdirectory.

-t pamagat
--pamagat pamagat
display pamagat sa header ng lahat ng pahina.

pamagat ay nakasulat sa bahagi ng header ng bawat nabuong pahina ng HTML upang matukoy ang
konteksto kung saan nilikha ang isang partikular na output. Bilang default, ito ang pangalan ng
ang tracefile.

-d paglalarawan-file
--description-file paglalarawan-file
Basahin ang mga paglalarawan ng test case mula sa paglalarawan-file.

Lahat ng paglalarawan ng test case na makikita sa paglalarawan-file at isinangguni sa input
ang data file ay binabasa at isinulat sa isang karagdagang pahina na pagkatapos ay isinasama sa
HTML na output.

Ang format ng file ng paglalarawan-file ay:

para sa bawat test case:
TN:
TD:

Ang mga valid na pangalan ng test case ay maaaring binubuo ng mga titik, numero at underscore na character
('_').
-k
--panatilihin ang mga paglalarawan
Huwag tanggalin ang mga hindi nagamit na paglalarawan ng pagsubok.

Panatilihin ang mga paglalarawan na matatagpuan sa file ng paglalarawan kahit na ipinapahiwatig ng data ng saklaw
na ang nauugnay na kaso ng pagsubok ay hindi sumasaklaw sa anumang linya ng code.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_keep_descriptions.

-c css-file
--css-file css-file
Gumamit ng external style sheet file css-file.

Gamit ang opsyong ito, maaaring tukuyin ang dagdag na .css file na papalit sa
default na isa. Ito ay maaaring makatulong kung ang mga default na kulay ay gusto ng iyong mga mata na tumalon
sa labas ng kanilang mga socket :)

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_css_file.

-p unlapi
--prefix unlapi
Alisin unlapi mula sa lahat ng pangalan ng direktoryo.

Dahil mahirap basahin ang mga listahan na naglalaman ng mahabang filename, mayroong mekanismo
ipinatupad na awtomatikong susubukan na paikliin ang lahat ng mga pangalan ng direktoryo sa
pahina ng pangkalahatang-ideya na nagsisimula sa isang karaniwang prefix. Bilang default, ginagawa ito gamit ang isang
algorithm na sumusubok na mahanap ang prefix na, kapag inilapat, ay mababawasan ang
nagresultang kabuuan ng mga character ng lahat ng pangalan ng direktoryo.

Gamitin ang opsyong ito upang tukuyin ang prefix na aalisin ng iyong sarili.

--no-prefix
Huwag tanggalin ang prefix sa mga pangalan ng direktoryo.

Idi-disable ng switch na ito ang mekanismo ng prefix na inilarawan sa nauna
seksyon.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_no_prefix.

--walang pinagmulan
Huwag gumawa ng source code view.

Gamitin ang switch na ito kung ayaw mong makakuha ng source code view para sa bawat file.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_no_source.

--num-spaces mga puwang
Palitan ang mga tab sa source view ng num mga puwang.

Ang default na halaga ay 8.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_num_spaces.

--highlight
I-highlight ang mga linya na may na-convert-only na data ng saklaw.

Gamitin ang opsyong ito kasabay ng --diff na opsyon ng lcov para i-highlight ang mga iyon
mga linya na sakop lamang sa mga set ng data na na-convert mula sa nauna
mga bersyon ng source code.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_highlight.

--alamat
Isama ang alamat ng kulay sa output ng HTML.

Gamitin ang opsyong ito upang magsama ng isang alamat na nagpapaliwanag ng kahulugan ng color coding sa
nagresultang HTML na output.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_legend.

--html-prolog prolog-file
Basahin ang customized na HTML prolog mula sa prolog-file.

Gamitin ang opsyong ito upang palitan ang default na HTML prolog (ang unang bahagi ng HTML
source code na humahantong sa at kabilang ang tag) na may mga nilalaman ng
prolog-file. Sa loob ng prolog text, ang mga sumusunod na salita ay papalitan kapag a
nabuo ang pahina:

@pagetitle@
Ang pamagat ng pahina.

@basedir@
Isang kamag-anak na landas na humahantong sa base na direktoryo (hal. para sa paghahanap ng mga css-file).

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_html_prolog.

--html-epilog epilog-file
Basahin ang customized na HTML epilog mula sa epilog-file.

Gamitin ang opsyong ito upang palitan ang default na HTML epilog (ang huling bahagi ng HTML
pinagmulan kasama ang ) kasama ang mga nilalaman ng epilog-file.

Sa loob ng teksto ng epilog, ang mga sumusunod na salita ay papalitan kapag ang isang pahina ay
nabuo:

@basedir@
Isang kamag-anak na landas na humahantong sa base na direktoryo (hal. para sa paghahanap ng mga css-file).

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_html_epilog.

--html-extension karugtong
Gumamit ng customized na extension ng filename para sa mga nabuong HTML na pahina.

Ang opsyon na ito ay kapaki-pakinabang sa mga sitwasyon kung saan may iba't ibang extension ng filename
kinakailangan upang mai-render nang tama ang mga resultang pahina (hal. php). Tandaan na ang isang '.' kalooban
maipasok sa pagitan ng filename at ng extension na tinukoy ng opsyong ito.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_html_extension.

--html-gzip
I-compress ang lahat ng nabuong html file gamit ang gzip at magdagdag ng .htaccess file na tumutukoy
gzip-encoding sa root output directory.

Gamitin ang opsyong ito kung gusto mong makatipid ng espasyo sa iyong webserver. Nangangailangan ng isang webserver
na may suporta sa .htaccess at isang browser na may suporta para sa gzip compressed html.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_html_gzip.

--uri-uriin
--walang-uri
Tukuyin kung isasama ang mga pinagsunod-sunod na view ng mga pangkalahatang-ideya ng file at direktoryo.

Gamitin ang --sort upang isama ang mga pinagsunod-sunod na view o --no-sort upang hindi isama ang mga ito. Pinagsunod-sunod na view
ay Pinagana bilang default.

Kapag pinagana ang mga pinagsunod-sunod na view, ang bawat page ng pangkalahatang-ideya ay maglalaman ng mga link sa mga view ng
ang pahinang iyon ay pinagsunod-sunod ayon sa rate ng saklaw.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_sort.

--function-coverage
--walang-function-coverage
Tukuyin kung magpapakita ng mga buod ng saklaw ng function sa output ng HTML.

Gamitin ang --function-coverage upang paganahin ang mga buod ng saklaw ng function o
--no-function-coverage upang hindi paganahin ito. Ang mga buod ng saklaw ng function ay Pinagana by
default

Kapag pinagana ang mga buod ng saklaw ng function, ang bawat pahina ng pangkalahatang-ideya ay maglalaman ng
bilang ng mga function na natagpuan at na-hit sa bawat file o direktoryo, kasama ang
nagresultang rate ng saklaw. Bilang karagdagan, ang bawat source code view ay maglalaman ng isang link sa
isang page na naglilista ng lahat ng function na makikita sa file na iyon kasama ang kaukulang bilang ng tawag
para sa mga function na iyon.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_function_coverage.

--saklaw ng sangay
--walang-sangay-saklaw
Tukuyin kung ipapakita ang data ng saklaw ng sangay sa output ng HTML.

Gamitin ang --branch-coverage upang paganahin ang pagpapakita ng saklaw ng sangay o --no-branch-coverage sa
huwag paganahin ito. Ang pagpapakita ng data ng saklaw ng sangay ay Pinagana bilang default

Kapag ang pagpapakita ng saklaw ng sangay ay pinagana, ang bawat pahina ng pangkalahatang-ideya ay maglalaman ng numero
ng mga sangay na natagpuan at na-hit sa bawat file o direktoryo, kasama ang resulta
rate ng saklaw. Bilang karagdagan, ang bawat source code view ay maglalaman ng karagdagang column
na naglilista ng lahat ng sangay ng isang linya na may mga indikasyon kung kinuha ang sangay
o hindi. Ang mga sangay ay ipinapakita sa sumusunod na format:

' + ': Ang sangay ay kinuha kahit isang beses
' - ': Hindi kinuha ang sangay
' # ': Ang pangunahing bloke na naglalaman ng sangay ay hindi kailanman naisakatuparan

Tandaan na maaaring hindi palaging posible na iugnay ang mga sangay sa katumbas
mga pahayag ng source code: sa panahon ng compilation, maaaring i-shuffle ng GCC ang mga branch sa paligid o
alisin ang ilan sa mga ito upang makabuo ng mas mahusay na code.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_branch_coverage.

--demangle-cpp
Tukuyin kung i-demangle ang mga pangalan ng function ng C++.

Gamitin ang opsyong ito kung gusto mong i-convert ang mga pangalan ng panloob na function ng C++ sa tao
nababasang format para ipakita sa page ng pangkalahatang-ideya ng function ng HTML. Ang pagpipiliang ito
ay nangangailangan na ang c++filt tool ay naka-install (tingnan c ++maglinis(1)).

--ignore-errors error
Tukuyin ang isang listahan ng mga error pagkatapos ay magpapatuloy sa pagproseso.

Gamitin ang opsyong ito upang tukuyin ang isang listahan ng isa o higit pang mga klase ng mga error pagkatapos nito
dapat ipagpatuloy ng geninfo ang pagproseso sa halip na i-abort.

error ay maaaring isang listahan na pinaghihiwalay ng kuwit ng mga sumusunod na keyword:

pinagmulan: hindi mahanap ang source code file para sa isang set ng data.

--config-file config-file
Tumukoy ng configuration file na gagamitin.

Kapag tinukoy ang opsyong ito, hindi ang file ng configuration sa buong system
/etc/lcovrc, o ang file ng pagsasaayos ng bawat user ~/.lcovrc binabasa.

Maaaring maging kapaki-pakinabang ang opsyong ito kapag may pangangailangang magpatakbo ng ilang pagkakataon ng genhtml
na may magkakaibang mga pagpipilian sa pagsasaayos ng file nang magkatulad.

--rc keyword=halaga
I-override ang isang direktiba sa pagsasaayos.

Gamitin ang opsyong ito upang tukuyin ang a keyword=halaga pahayag na nangingibabaw sa
kaukulang configuration statement sa lcovrc configuration file. Kaya mo
tukuyin ang opsyong ito nang higit sa isang beses upang i-override ang maramihang configuration statement.
Tingnan lcovrc(5) para sa isang listahan ng magagamit na mga keyword at ang kahulugan nito.

--katumpakan num
Ipakita ang mga rate ng coverage na may num bilang ng mga digit pagkatapos ng decimal-point.

Ang default na halaga ay 1.

Maaari ding permanenteng i-configure ang opsyong ito gamit ang opsyon sa configuration file
genhtml_precision.

Gamitin ang genhtml online gamit ang mga serbisyo ng onworks.net