manlifter - ອອນໄລນ໌ໃນຄລາວ

ໂຄງການ:

NAME

manlifter - script ການແປງມະຫາຊົນແລະການທົດສອບ harness ສໍາລັບ doclifter

ສະຫຼຸບສັງລວມ

manlifter [-ງ ທາງເລືອກ] [-e] [-f ລາຍການໄຟລ໌] [-ຊ] [-I mandir] [-ມ] [-ມ] [-ອ ຂີ້ຮ້າຍ]
[-ປ patch-directory] [-P] [-q] [-v] [-s ສ່ວນ] [-X ຍົກເວັ້ນ] ຊື່...

manlifter [-S]

ລາຍລະອຽດ

manlifter ແມ່ນສະຄຣິບທີ່ຈັດລໍາດັບ doclifter(1​) ການ​ປ່ຽນ​ຕົ້ນ​ໄມ້​ຫນ້າ​ຄູ່​ມື​ທັງ​ຫມົດ​ເປັນ​
XML-Docbook, ທາງເລືອກຍັງສ້າງ HTML ຈາກ XML. ການນໍາໃຊ້ອີກອັນຫນຶ່ງແມ່ນເປັນ
torture-test tool ສໍາລັບ doclifter; ມັນບັນທຶກຄວາມຜິດພາດກັບຜົນຜະລິດມາດຕະຖານແລະເກັບກໍາເວລາ.

ເອີ້ນວ່າໂດຍບໍ່ມີການໂຕ້ຖຽງໄຟລ໌ໃດໆ, manlifter ພະຍາຍາມແປງຫນ້າຜູ້ຊາຍທີ່ມີສິດທັງຫມົດ
ຕິດຕັ້ງຢູ່ໃນລະບົບ, ການວາງໄຟລ໌ xml ຜົນໄດ້ຮັບພາຍໃຕ້ xmlman ໃນປະຈຸບັນ
ໄດເລກະທໍລີ. ແຕ່ລະໜ້າແປສຳເລັດແລ້ວ foo.N ຖືກຄັດລອກໄປທີ່ manN/foo.xml ຢູ່ລຸ່ມໜ້າ
ໄດເຣັກທໍຣີຜົນຜະລິດ, ໂດຍບໍ່ຄໍານຶງເຖິງສິ່ງທີ່ໄດເລກະທໍລີແຫຼ່ງທີ່ມາ.

ຫນ້າຄູ່ມືແມ່ນຖືວ່າບໍ່ມີສິດສໍາລັບການປ່ຽນເປັນຊຸດຖ້າມັນມີຂໍ້ຄວາມທີ່ຊີ້ບອກ
ມັນໄດ້ຖືກສ້າງຂື້ນຈາກຕົ້ນສະບັບຂອງ DocBook ຈາກ Doxygen.

ສໍາ​ລັບ​ແຕ່​ລະ​ໄຟລ​໌​ແຫຼ່ງ​ທີ່​ກວດ​ສອບ​, ຖ້າ​ຫາກ​ວ່າ​ໄຟລ​໌​ຈຸດ​ຫມາຍ​ປາຍ​ທາງ​ມີ​ຢູ່​ແລະ​ແມ່ນ​ໃຫມ່​ກ​່​ວາ​
ແຫຼ່ງ, ການປ່ຽນໃຈເຫລື້ອມໃສແມ່ນຂ້າມ; ດັ່ງນັ້ນ, ໄລຍະເພີ່ມຂຶ້ນຂອງ manlifter ເຮັດວຽກຫນ້ອຍທີ່ສຸດ
ຕ້ອງການເພື່ອຮັກສາຕົ້ນໄມ້ XML ເປົ້າຫມາຍໃຫ້ທັນສະໄຫມ. ເຊັ່ນດຽວກັນ, ໄຟລ໌ HTML ທີ່ມາຈາກຮູບແບບ -h ແມ່ນ
ເຮັດໄດ້ພຽງແຕ່ໃນເວລາທີ່ຈໍາເປັນ.

ຫນ້າ stub ທີ່ພຽງແຕ່ ດັ່ງນັ້ນ, ການປ່ຽນເສັ້ນທາງຖືກແປເປັນ symlinks ທີ່ສອດຄ້ອງກັນຂອງ XML
ໄຟລ໌ (ແລະ, ກັບ -h, ໄຟລ໌ HTML).

manlifter ອາດຈະຖືກເອີ້ນດ້ວຍການໂຕ້ຖຽງໄຟລ໌ດຽວ, ເຊິ່ງຖືກຕີຄວາມວ່າລໍາຕົ້ນ
ຊື່ຂອງຫນ້າຄູ່ມືທີ່ເປັນໄປໄດ້. manlifter ຈາກນັ້ນຊອກຫາພາກສ່ວນຄູ່ມືທັງໝົດທີ່ເລືອກ
ຫນ້າທີ່ກົງກັນແລະພະຍາຍາມແປງມັນ. ໃນກໍລະນີນີ້, ສໍາເນົາຂອງຫນ້າຜູ້ຊາຍແລະ
ສະ​ບັບ​ທີ່​ປ່ຽນ​ໃຈ​ເຫລື້ອມ​ໃສ​ໄດ້​ຖືກ​ຫຼຸດ​ລົງ​ໃນ​ທັນ​ທີ beheath ລະ​ບົບ​ການ​ຜະ​ລິດ​ໄດ້​, ມີ​ຊື່​
foobar.man ແລະ foobar.man.xml, ຕາມລໍາດັບ. ຮູບແບບນີ້ແມ່ນປົກກະຕິພຽງແຕ່ມີຄວາມສົນໃຈເທົ່ານັ້ນ
to doclifter ນັກພັດທະນາສໍາລັບການ debugging ໂຄງການນັ້ນ.

ໃນທັງສອງກໍລະນີຂ້າງເທິງ, manlifter ຈະຍົກເລີກການບີບອັດໄຟລ໌ຖ້າມັນມີ .gz, .bz2 ຫຼື
.Z ຕໍ່ທ້າຍຊື່.

ທາງເລືອກມີດັ່ງນີ້:

-d
ຖ່າຍທອດ string argument ໄປຫາແຕ່ລະ doclifter call ເປັນທາງເລືອກ. ແຕ່ລະ token ແຍກຊ່ອງ
ໃນ string ກາຍເປັນ argument ແຍກຕ່າງຫາກໃນການໂທ.

-e
ດໍາເນີນການໃນຮູບແບບ log-filter (ສ່ວນໃຫຍ່ແມ່ນມີຄວາມສົນໃຈ doclifter ນັກພັດທະນາ). ໃນ​ຮູບ​ແບບ​ນີ້​,
manlifter ອ່ານບັນທຶກການທົດສອບຈາກວັດສະດຸປ້ອນມາດຕະຖານແລະການກັ່ນຕອງມັນໃນວິທີການ aa ຂຶ້ນກັບ
ຕົວເລືອກ -f ແລະ -q. ຖ້າທັງສອງອັນນີ້ບໍ່ຖືກມອບໃຫ້, ຂໍ້ຄວາມຈາກການແລ່ນທີ່ປະສົບຜົນສໍາເລັດແມ່ນ
ຖອດອອກແລະມີພຽງແຕ່ຄວາມຜິດພາດທີ່ຜ່ານໄປສູ່ຜົນຜະລິດມາດຕະຖານ.

-f
ໂດຍປົກກະຕິ, ແລ່ນ doclifter ໃນໄຟລ໌ທີ່ມີຊື່ແຕ່ລະແຖວໃນໄຟລ໌ argument. ໃນ
error-filter mode ການ argument ແທນທີ່ຈະຖືກຕີຄວາມວ່າເປັນການກັ່ນຕອງປົກກະຕິ
ການສະແດງອອກ.

-h
ຍັງສ້າງການແປພາສາ HTML ເຂົ້າໄປໃນໄດເລກະທໍລີຜົນຜະລິດ. DocBook citerefentry markup
ຖືກປ່ຽນເປັນ hyperlinks ໃນໄດເລກະທໍລີ, ແລະລາຍຊື່ເນື້ອຫາແມ່ນຖືກສ້າງຂຶ້ນ
index.html.

-I
ລະບຸຮາກຂອງຕົ້ນໄມ້ໜ້າຄູ່ມື. ໂດຍຄ່າເລີ່ມຕົ້ນນີ້ແມ່ນ /usr/share/man.

-m
ແກ້ໄຂໜ້າສຸດທ້າຍທີ່ດຶງມາ. ມັນຖືກຄັດລອກ, ບັນນາທິການຖືກເອີ້ນ
ສໍາເນົາ (ການນໍາໃຊ້ຕົວແປສະພາບແວດລ້ອມ $ EDITOR), ແລະຈາກນັ້ນ diff(1) ຖືກເອີ້ນໃຫ້ລົງ
patch ໃນ prepatch directory. ລົ້ມເຫລວກັບຄວາມຜິດພາດຖ້າຫາກວ່າ patch ດັ່ງກ່າວແມ່ນຢູ່ແລ້ວ
ປະຈຸບັນ.

-M
ຍົກໄຟລ໌ທີ່ລະບຸໄວ້, ຫຼັງຈາກນັ້ນເຮັດການທຽບເທົ່າຂອງທາງເລືອກ -m.

-o
ຕັ້ງໄດເລກະທໍລີຜົນຜະລິດທີ່ການແປພາສາ XML-DocBook ຈະຖືກຖິ້ມ. ໂດຍ
ຄ່າເລີ່ມຕົ້ນນີ້ແມ່ນ xmlman ພາຍໃຕ້ໄດເລກະທໍລີປະຈຸບັນໃນຮູບແບບ batch, ຫຼືປະຈຸບັນ
directory ຖ້າບໍ່ດັ່ງນັ້ນ.

-p
ແປການໂຕ້ຖຽງເປັນຊື່ຂອງໄດເລກະທໍລີ patch (ຊື່ເລີ່ມຕົ້ນແມ່ນ prepatch
ພາຍ​ໃຕ້​ລະ​ບົບ​ປະ​ຈຸ​ບັນ​)​. ແຕ່ລະໄຟລ໌ທີ່ມີຊື່ວ່າ foo.N.patch ຖືກຕີຄວາມໝາຍເປັນ patch ເພື່ອ
ຖືກນໍາໃຊ້ກັບຫນ້າຄູ່ມື foo(N) ກ່ອນທີ່ doclifter ຈະແປມັນ.

-P
ເປີດໃຊ້ການສ້າງໂປຣໄຟລ໌ໂດຍໃຊ້ໂມດູນຮັອດຊອດ Python; ນີ້ແມ່ນພຽງແຕ່ເປັນປະໂຫຍດສໍາລັບການປັບ
doclifter ດັ່ງນັ້ນມັນແລ່ນໄວ. ຂໍ້ມູນດິບຖືກຂຽນໃສ່ manlifter.prof, ແລະຍ່ອຍ
ບົດ​ລາຍ​ງານ​ແມ່ນ​ໄດ້​ຕໍ່​ທ້າຍ​ບັນ​ທຶກ​ກ່ຽວ​ກັບ​ຜົນ​ຜະ​ລິດ​ມາດ​ຕະ​ຖານ​. ຄໍາເຕືອນ: ໄຟລ໌ຂໍ້ມູນດິບສາມາດ
ກາຍເປັນອັນໃຫຍ່ຫຼວງ, ແລະການປະມວນຜົນພາຍຫຼັງການຜະລິດບົດລາຍງານສາມາດໃຊ້ເວລາດົນເທົ່າທີ່
ການປຸງແຕ່ງຕົວຈິງ (ຫຼືຍາວກວ່າ!).

-q
ໂດຍປົກກະຕິ, ຜ່ານທາງເລືອກ -q (ງຽບ) ໄປຫາແຕ່ລະການໂທ doclifter. ໃນ​ຮູບ​ແບບ​ການ​ກັ່ນ​ຕອງ​ຄວາມ​ຜິດ​ພາດ​,
ສົ່ງຄືນລາຍຊື່ໄຟລ໌ທີ່ການແປລົ້ມເຫລວ.

-v
ຜ່ານຕົວເລືອກ -v (verbose) ໄປຫາແຕ່ລະການໂທ doclifter. ທາງເລືອກນີ້ສາມາດຖືກຊ້ໍາກັບ
ເພີ່ມ​ລະ​ດັບ verbosity​.

-s
ລະບຸພາກສ່ວນທີ່ຈະສະແກນ. ໃຊ້ນີ້ດ້ວຍການໂຕ້ຖຽງ; ມັນບໍ່ຄວນຈະມີຄວາມຈໍາເປັນໃນເວລາທີ່
ເຮັດການແປງຂອງຕົ້ນໄມ້ທັງຫມົດ.

-S
ລວບລວມສະຖິຕິຄວາມຜິດພາດຈາກ a manlifter logfile ນໍາ​ສະ​ເຫນີ​ຢູ່​ໃນ​ມາດ​ຕະ​ຖານ​. ນີ້
ທາງເລືອກແມ່ນມີຄວາມສົນໃຈຕົ້ນຕໍ doclifter ນັກພັດທະນາ.

-X
ໃນຮູບແບບ batch ບໍ່ລວມເອົາຫນ້າທີ່ລະບຸໄວ້ໃນໄຟລ໌ argument. ຫມາຍຄວາມວ່າຈະຖືກນໍາໃຊ້ສໍາລັບຫນ້າ
ທີ່ຮູ້ຈັກດີ ແລະໃຊ້ເວລາດົນທີ່ສຸດເພື່ອຍົກ, ເພື່ອຕັດລົງ
ເວລາສໍາລັບການທົດສອບແລ່ນ. (ໜ້າ​ເວັບ​ສ່ວນ​ຫຼາຍ​ຍົກ​ຂຶ້ນ​ພາຍ​ໃນ​ບໍ່​ຮອດ​ເຄິ່ງ​ວິ​ນາ​ທີ, ແຕ່​ບາງ​ຄົນ​ສາ​ມາດ​ໃຊ້​ເວ​ລາ
15 ນາ​ທີ​ຫຼື​ດົນ​ກວ່າ​ນັ້ນ​.)

manlifter ປ່ອຍໄຟລ໌ບັນທຶກໄປຫາຜົນຜະລິດມາດຕະຖານ. ໄຟລ໌ເລີ່ມຕົ້ນດ້ວຍເສັ້ນເວລາ ແລະ a
ເສັ້ນເປົ່າ, ແລະສິ້ນສຸດດ້ວຍເສັ້ນໃຫ້ເວລາແລ່ນ ແລະສະຖິຕິທີ່ຫນ້າສົນໃຈຕ່າງໆ.
ລະຫວ່າງເຫຼົ່ານີ້ແມ່ນ stanzas, ແຍກໂດຍເສັ້ນຫວ່າງເປົ່າ, ຫນຶ່ງສໍາລັບແຕ່ລະໄຟລ໌ທີ່ doclifter
ໄດ້ດໍາເນີນການ.

ແຖວທໍາອິດຂອງແຕ່ລະ stanza ເລີ່ມຕົ້ນດ້ວຍ "!", ຕາມດ້ວຍຊື່ເສັ້ນທາງຂອງແຫຼ່ງ
pager ຄູ່ມື, ຕິດຕາມດ້ວຍ "=" ແລະສະຖານະການກັບຄືນຂອງ doclifter ດໍາເນີນການຢູ່ໃນໄຟລ໌ນັ້ນ.
ຕໍ່ໄປນີ້ແມ່ນຊ່ອງແລະ doclifterruntime ຂອງ​ວິ​ນາ​ທີ​.

ເສັ້ນເບື້ອງຕົ້ນນີ້ອາດຈະຖືກຕິດຕາມດ້ວຍຂໍ້ຄວາມຂໍ້ມູນແລະຄວາມຜິດພາດຂອງຜົນໄດ້ຮັບ
ແລ່ນ doclifter.

manlifter ຕ້ອງຊອກຫາສໍາເນົາຂອງ doclifter ໃນທັງໄດເລກະທໍລີປະຈຸບັນຫຼືຫນຶ່ງຂອງ
ໄດເລກະທໍລີຄໍາສັ່ງຢູ່ໃນຂອງທ່ານ PATH ເພື່ອດໍາເນີນການ.

ໃຊ້ manlifter ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net