manlifter - Online sa Cloud

PROGRAMA:

NAME

manlifter - script ng mass-conversion at test harness para sa doclifter

SINOPSIS

manlifter [-d opsyon] [-e] [-f listfile] [-h] [-I mandir] [-m] [-M] [-o labas]
[-p patch-direktoryo] [-P] [-q] [-v] [-s seksyon] [-X huwag isama] pangalan...

manlifter [-S]

DESCRIPTION

manlifter ay isang script na nagkakasunod-sunod doclifter(1) upang i-convert ang isang buong manual-page tree sa
XML-Docbook, opsyonal din na bumubuo ng HTML mula sa XML. Ang isa pang gamit ay bilang a
torture-test tool para sa doclifter; nagla-log ito ng mga error sa karaniwang output at nangongolekta ng mga timing.

Tinatawag nang walang anumang argumento ng file, sinusubukan ng manlifter na i-convert ang lahat ng karapat-dapat na man page
naka-install sa system, inilalagay ang mga nagresultang xml file sa ilalim ng xmlman sa kasalukuyang
direktoryo. Ang bawat matagumpay na naisalin na pahina na foo.N ay kinopya sa manN/foo.xml sa ilalim ng
direktoryo ng output, hindi alintana kung saang direktoryo ito nanggaling.

Ang isang manu-manong page ay itinuturing na hindi karapat-dapat para sa batch na conversion kung naglalaman ito ng text na nagpapahiwatig
ito ay nabuo mula sa DocBook masters ng mula sa Doxygen.

Para sa bawat source file na sinuri, kung ang patutunguhang file ay umiiral at mas bago kaysa sa
pinagmulan, ang conversion ay nilaktawan; kaya, incremental run ng manlifter gawin ang pinakamaliit na trabaho
kailangan upang panatilihing napapanahon ang target na XML tree. Gayundin, sa -h mode na nagmula sa mga HTML na file ay
ginawa lamang kung kinakailangan.

Mga stub na pahina na makatarungan .so isinasalin ang mga pag-redirect sa mga katumbas na symlink ng XML
mga file (at, may -h, mga HTML na file).

manlifter maaari ding tawaging may isang argumento ng file, na binibigyang kahulugan bilang stem
pangalan ng isang potensyal na manual page. manlifter pagkatapos ay hahanapin ang lahat ng napiling manu-manong seksyon para sa
isang katugmang pahina at sinusubukang i-convert ito. Sa kasong ito, isang kopya ng man page at ang
ang na-convert na bersyon ay ibinaba kaagad sa direktoryo ng output, kasama ang mga pangalan
foobar.man at foobar.man.xml, ayon sa pagkakabanggit. Ang mode na ito ay karaniwang interes lamang
sa doclifter mga developer para sa pag-debug ng program na iyon.

Sa alinman sa mga kaso sa itaas, manlifter ia-uncompress ang file kung mayroon itong .gz, .bz2 o
.Z suffix sa pangalan.

Ang mga pagpipilian ay ang mga sumusunod:

-d
Ipasa ang string argument sa bawat doclifter na tawag bilang mga opsyon. Bawat space-separated token
sa string ay nagiging hiwalay na argumento sa tawag.

-e
Patakbuhin sa log-filter mode (pangunahing interesado sa doclifter mga developer). Sa mode na ito,
manlifter nagbabasa ng log ng pagsubok mula sa karaniwang input at sinasala ito sa paraang umaasa sa
ang -f at -q na mga opsyon. Kung wala sa mga ito ang ibinigay, ang mga mensahe mula sa matagumpay na pagtakbo ay
natanggal at mga error lamang ang naipasa sa karaniwang output.

-f
Karaniwan, patakbuhin ang doclifter sa mga file na pinangalanan ng bawat linya sa file ng argumento. Sa
error-filter mode ang argument ay sa halip ay binibigyang kahulugan bilang regular na pag-filter
pagpapahayag.

-h
Bumuo din ng mga pagsasalin ng HTML sa direktoryo ng output. DocBook citerefentry markup
ay binago sa mga hyperlink sa direktoryo, at isang listahan ng nilalaman ay nabuo sa
index.html

-I
Tukuyin ang ugat ng puno ng manual-page. Bilang default ito ay /usr/share/man.

-m
Gumawa ng patch para itama ang huling page na nakuha. Ito ay kinopya, isang editor ang tinatawag
ang kopya (gamit ang environment variable $ EDITOR), at pagkatapos Diff(1) ay tinatawag na bumaba
ang patch sa direktoryo ng prepatch. Nabigo sa isang error kung ang naturang patch ay mayroon na
kasalukuyan.

-M
Iangat ang tinukoy na mga file, pagkatapos ay gawin ang katumbas ng -m na opsyon.

-o
Itakda ang direktoryo ng output kung saan ihuhulog ang mga pagsasalin ng XML-DocBook. Sa pamamagitan ng
default ito ay xmlman sa ilalim ng kasalukuyang direktoryo sa batch mode, o ang kasalukuyang
direktoryo kung hindi man.

-p
Bigyang-kahulugan ang argumento bilang pangalan ng isang direktoryo ng patch (ang default na pangalan ay prepatch
sa ilalim ng kasalukuyang direktoryo). Ang bawat file na pinangalanang foo.N.patch ay binibigyang kahulugan bilang isang patch sa
ilapat sa manwal na pahina foo(N) bago ito isalin ng doclifter.

-P
Paganahin ang pag-profile gamit ang Python hotshot module; ito ay kapaki-pakinabang lamang para sa pag-tune
doclifter para mas mabilis itong tumakbo. Ang raw data ay isinulat sa manlifter.prof, at isang digested
Ang ulat ay idinagdag sa log sa karaniwang output. Babala: ang mga raw data file ay maaari
naging malaki, at ang postprocessing para sa pagbuo ng ulat ay maaaring tumagal hangga't ang
aktwal na pagproseso (o mas matagal!).

-q
Karaniwan, ipasa ang -q (tahimik) na opsyon sa bawat tawag sa doclifter. Sa mode ng error-filter,
ibalik ang isang listahan ng mga file kung saan nabigo ang pagsasalin.

-v
Ipasa ang -v (verbose) na opsyon sa bawat doclifter na tawag. Ang pagpipiliang ito ay maaaring ulitin sa
taasan ang antas ng verbosity.

-s
Tumukoy ng seksyong ii-scan. Gamitin ito nang may argumento; hindi dapat kailangan kapag
paggawa ng isang conversion ng buong puno.

-S
Magtipon ng mga istatistika ng error mula sa a manlifter logfile na ipinakita sa karaniwang input. Ito
ang pagpipilian ay higit na magiging interesante sa doclifter mga developer.

-X
Sa batch mode, ibukod ang mga pahinang nakalista sa file ng argumento. Sinadya upang magamit para sa mga pahina
na kilalang mabuti at napakatagal ng pag-angat, upang mabawasan ang
oras para sa isang pagsubok run. (Karamihan sa mga pahina ay umaangat sa wala pang kalahating segundo, ngunit ang ilan ay maaaring tumagal
15 minuto o mas matagal pa.)

manlifter naglalabas ng logfile sa karaniwang output. Ang file ay nagsisimula sa isang timestamp na linya at a
blangkong linya, at nagtatapos sa isang linya na nagbibigay ng oras ng pagtakbo at iba't ibang kawili-wiling istatistika.
Sa pagitan ng mga ito ay mga stanza, na pinaghihiwalay ng mga blangkong linya, isa para sa bawat file kung saan doclifter
ay tumakbo.

Ang unang linya ng bawat saknong ay nagsisimula sa "!", na sinusundan ng pathname ng pinagmulan
manual pager, na sinusundan ng "=" at ang return status ng doclifter run sa file na iyon.
Kasunod iyon ay isang puwang at doclifterang runtime ni sa ilang segundo.

Ang paunang linyang ito ay maaaring sundan ng mga mensahe ng impormasyon at ang error na output ng
tumakbong doclifter.

manlifter dapat makahanap ng kopya ng doclifter sa alinman sa kasalukuyang direktoryo o isa sa
mga direktoryo ng command sa iyong PATH para tumakbo.

Gumamit ng manlifter online gamit ang mga serbisyo ng onworks.net