์ด๊ฒ์ Ubuntu Online, Fedora Online, Windows ์จ๋ผ์ธ ์๋ฎฌ๋ ์ดํฐ ๋๋ MAC OS ์จ๋ผ์ธ ์๋ฎฌ๋ ์ดํฐ์ ๊ฐ์ ์ฌ๋ฌ ๋ฌด๋ฃ ์จ๋ผ์ธ ์ํฌ์คํ ์ด์ ์ค ํ๋๋ฅผ ์ฌ์ฉํ์ฌ OnWorks ๋ฌด๋ฃ ํธ์คํ ์ ๊ณต์ ์ฒด์์ ์คํํ ์ ์๋ ๋ช ๋ น ๋งจ๋ฆฌํํฐ์ ๋๋ค.
ํ๋ก๊ทธ๋จ:
์ด๋ฆ
manlifter - doclifter์ฉ ๋๋ ๋ณํ ์คํฌ๋ฆฝํธ ๋ฐ ํ ์คํธ ์ฅ์น
๊ฐ์
๋งจ๋ฆฌํํฐ [-NS ์ ํ๊ถ] [-e] [-f ๋ชฉ๋ก ํ์ผ] [-์๋ ํ์ธ์ mandir] [-์ ] [-์ ] [-์ค ์์๋๋ฅด]
[-NS ํจ์น ๋๋ ํ ๋ฆฌ] [-P] [-q] [-v] [-s ์น์ ์ ์์ด์ผ ํฉ๋๋ค.] [-NS ์ ์ธ] name...
๋งจ๋ฆฌํํฐ [-NS]
๊ธฐ์
๋งจ๋ฆฌํํฐ ์์๋ฅผ ์ง์ ํ๋ ์คํฌ๋ฆฝํธ์ ๋๋ค. ๋ฌธ์๋ฆฌํํฐ(1) ์ ์ฒด ๋งค๋ด์ผ ํ์ด์ง ํธ๋ฆฌ๋ฅผ
XML-Docbook, ์ ํ์ ์ผ๋ก XML์์ HTML๋ ์์ฑํฉ๋๋ค. ๋ ๋ค๋ฅธ ์ฉ๋๋
doclifter๋ฅผ ์ํ ๊ณ ๋ฌธ ํ ์คํธ ๋๊ตฌ; ํ์ค ์ถ๋ ฅ์ ์ค๋ฅ๋ฅผ ๊ธฐ๋กํ๊ณ ํ์ด๋ฐ์ ์์งํฉ๋๋ค.
ํ์ผ ์ธ์ ์์ด ํธ์ถ๋ manlifter๋ ์ ํฉํ ๋ชจ๋ ๋งค๋ด์ผ ํ์ด์ง๋ฅผ ๋ณํํ๋ ค๊ณ ์๋ํฉ๋๋ค.
์์คํ ์ ์ค์น๋ ๊ฒฐ๊ณผ xml ํ์ผ์ ํ์ฌ์ xmlman ์๋์ ๋ฐฐ์นํฉ๋๋ค.
์๋ฐฐ ๊ท์น์. ์ฑ๊ณต์ ์ผ๋ก ๋ฒ์ญ๋ ๊ฐ ํ์ด์ง foo.N์ ์๋์ manN/foo.xml์ ๋ณต์ฌ๋ฉ๋๋ค.
์ด๋ค ์์ค ๋๋ ํ ๋ฆฌ์์ ์๋์ง์ ๊ด๊ณ์์ด ์ถ๋ ฅ ๋๋ ํ ๋ฆฌ.
๋งค๋ด์ผ ํ์ด์ง์ ๋ค์์ ๋ํ๋ด๋ ํ ์คํธ๊ฐ ํฌํจ๋ ๊ฒฝ์ฐ ์ผ๊ด ๋ณํ์ ๋ถ์ ํฉํ ๊ฒ์ผ๋ก ๊ฐ์ฃผ๋ฉ๋๋ค.
Doxygen์ DocBook ๋ง์คํฐ์์ ์์ฑ๋์์ต๋๋ค.
๊ฒ์ฌ๋ ๊ฐ ์์ค ํ์ผ์ ๋ํด ๋์ ํ์ผ์ด ์กด์ฌํ๊ณ
์์ค, ๋ณํ์ ๊ฑด๋๋๋๋ค. ๋ฐ๋ผ์ ์ฆ๋ถ ์คํ ๋งจ๋ฆฌํํฐ ์ต์ํ์ ์ผ์ ํ๋ค
๋์ XML ํธ๋ฆฌ๋ฅผ ์ต์ ์ํ๋ก ์ ์งํ๋ ๋ฐ ํ์ํฉ๋๋ค. ๋ง์ฐฌ๊ฐ์ง๋ก -h ๋ชจ๋์์ ํ์๋ HTML ํ์ผ์
ํ์ํ ๋๋ง ๋ง๋ค์ด์ง๋๋ค.
๋ค์๊ณผ ๊ฐ์ ์คํ ํ์ด์ง .๊ทธ๋์ ๋ฆฌ๋๋ ์ ์ XML์ ํด๋น ์ฌ๋ณผ๋ฆญ ๋งํฌ๋ก ๋ณํ๋ฉ๋๋ค.
ํ์ผ(๋ฐ -h๋ฅผ ์ฌ์ฉํ๋ ๊ฒฝ์ฐ HTML ํ์ผ).
๋งจ๋ฆฌํํฐ ์ค๊ธฐ๋ก ํด์๋๋ ๋จ์ผ ํ์ผ ์ธ์๋ก ํธ์ถ๋ ์๋ ์์ต๋๋ค.
์ ์ฌ์ ์ธ ๋งค๋ด์ผ ํ์ด์ง์ ์ด๋ฆ. ๋งจ๋ฆฌํํฐ ๊ทธ๋ฐ ๋ค์ ์ ํํ ๋ชจ๋ ์๋ ์น์ ์ ๊ฒ์ํฉ๋๋ค.
์ผ์นํ๋ ํ์ด์ง๋ฅผ ์ฐพ์ ๋ณํ์ ์๋ํฉ๋๋ค. ์ด ๊ฒฝ์ฐ ๋งค๋ด์ผ ํ์ด์ง์ ์ฌ๋ณธ๊ณผ
๋ณํ๋ ๋ฒ์ ์ ์ด๋ฆ๊ณผ ํจ๊ป ์ถ๋ ฅ ๋๋ ํ ๋ฆฌ ๋ฐ๋ก ์๋์ ์ญ์ ๋ฉ๋๋ค.
foobar.man ๋ฐ foobar.man.xml. ์ด ๋ชจ๋๋ ์ผ๋ฐ์ ์ผ๋ก ๊ด์ฌ๋ง
์ ๋ฌธ์๋ฆฌํํฐ ํด๋น ํ๋ก๊ทธ๋จ์ ๋๋ฒ๊น ํ๋ ๊ฐ๋ฐ์.
์์ ๋ ๊ฒฝ์ฐ ์ค ํ๋์์, ๋งจ๋ฆฌํํฐ .gz, .bz2 ๋๋
์ด๋ฆ์ .Z ์ ๋ฏธ์ฌ.
์ต์ ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค.
-d
์ต์ ์ผ๋ก ๊ฐ doclifter ํธ์ถ์ ๋ฌธ์์ด ์ธ์๋ฅผ ์ ๋ฌํฉ๋๋ค. ๊ณต๋ฐฑ์ผ๋ก ๊ตฌ๋ถ๋ ๊ฐ ํ ํฐ
๋ฌธ์์ด์์ ํธ์ถ ์ ๋ณ๋์ ์ธ์๊ฐ ๋ฉ๋๋ค.
-e
๋ก๊ทธ ํํฐ ๋ชจ๋์์ ์คํ(์ฃผ๋ก ๊ด์ฌ ๋์ ๋ฌธ์๋ฆฌํํฐ ๊ฐ๋ฐ์). ์ด ๋ชจ๋์์๋
๋งจ๋ฆฌํํฐ ํ์ค ์ ๋ ฅ์์ ํ ์คํธ ๋ก๊ทธ๋ฅผ ์ฝ๊ณ ๋ค์์ ๋ฐ๋ผ ํํฐ๋งํฉ๋๋ค.
-f ๋ฐ -q ์ต์ . ๋ ๋ค ์ ๊ณต๋์ง ์์ผ๋ฉด ์ฑ๊ณต์ ์ธ ์คํ์ ๋ฉ์์ง๋
์ ๊ฑฐ๋๊ณ ์ค๋ฅ๋ง ํ์ค ์ถ๋ ฅ์ผ๋ก ์ ๋ฌ๋ฉ๋๋ค.
-f
์ผ๋ฐ์ ์ผ๋ก ์ธ์ ํ์ผ์ ๊ฐ ์ค์ ์ํด ๋ช ๋ช ๋ ํ์ผ์ ๋ํด doclifter๋ฅผ ์คํํฉ๋๋ค. ์
์ค๋ฅ ํํฐ ๋ชจ๋ ์ธ์๋ ๋์ ํํฐ๋ง ์ผ๋ฐ์ผ๋ก ํด์๋ฉ๋๋ค.
ํํ.
-h
๋ํ ์ถ๋ ฅ ๋๋ ํ ๋ฆฌ์ HTML ๋ฒ์ญ์ ์์ฑํฉ๋๋ค. DocBook ์ธ์ฉ ํ์ ๋งํฌ์
๋๋ ํ ๋ฆฌ์์ ํ์ดํผ๋งํฌ๋ก ๋ณํ๋๊ณ ์ปจํ ์ธ ๋ชฉ๋ก์ด ์์ฑ๋ฉ๋๋ค.
index.html.
-I
๋งค๋ด์ผ ํ์ด์ง ํธ๋ฆฌ์ ๋ฃจํธ๋ฅผ ์ง์ ํ์ญ์์ค. ๊ธฐ๋ณธ์ ์ผ๋ก ์ด๊ฒ์ /usr/share/man์ ๋๋ค.
-m
๊ฐ์ ธ์จ ๋ง์ง๋ง ํ์ด์ง๋ฅผ ์์ ํ๋ ํจ์น๋ฅผ ๋ง๋์ญ์์ค. ๋ณต์ฌ๋๊ณ ํธ์ง๊ธฐ๊ฐ ํธ์ถ๋ฉ๋๋ค.
๋ณต์ฌ(ํ๊ฒฝ ๋ณ์ ์ฌ์ฉ $ ํธ์ง์), ๊ทธ๋ฆฌ๊ณ diff(1) ๋๋กญ์ ํธ์ถ
prepatch ๋๋ ํ ๋ฆฌ์ ์๋ ํจ์น. ์ด๋ฌํ ํจ์น๊ฐ ์ด๋ฏธ ์๋ ๊ฒฝ์ฐ ์ค๋ฅ์ ํจ๊ป ์คํจํฉ๋๋ค.
์ ๋ฌผ.
-M
์ง์ ๋ ํ์ผ์ ๋ค์ด ์ฌ๋ฆฐ ๋ค์ -m ์ต์ ๊ณผ ๋์ผํ ์์ ์ ์ํํฉ๋๋ค.
-o
XML-DocBook ๋ฒ์ญ์ด ๋๋กญ๋ ์ถ๋ ฅ ๋๋ ํ ๋ฆฌ๋ฅผ ์ค์ ํฉ๋๋ค. ์ ์ํด
๊ธฐ๋ณธ๊ฐ์ ๋ฐฐ์น ๋ชจ๋์ ํ์ฌ ๋๋ ํ ๋ฆฌ ์๋์ ์๋ xmlman์ด๊ฑฐ๋ ํ์ฌ
๊ทธ๋ ์ง ์์ผ๋ฉด ๋๋ ํ ๋ฆฌ.
-p
์ธ์๋ฅผ ํจ์น ๋๋ ํ ๋ฆฌ์ ์ด๋ฆ์ผ๋ก ํด์ํฉ๋๋ค(๊ธฐ๋ณธ ์ด๋ฆ์ prepatch์ ๋๋ค.
ํ์ฌ ๋๋ ํ ๋ฆฌ ์๋). foo.N.patch๋ผ๋ ์ด๋ฆ์ ๊ฐ ํ์ผ์ ํจ์น๋ก ํด์๋ฉ๋๋ค.
doclifter๊ฐ ๋ฒ์ญํ๊ธฐ ์ ์ ๋งค๋ด์ผ ํ์ด์ง foo(N)์ ์ ์ฉํ์ญ์์ค.
-P
Python ํซ์ท ๋ชจ๋์ ์ฌ์ฉํ์ฌ ํ๋กํ์ผ๋ง์ ํ์ฑํํฉ๋๋ค. ์ด๊ฒ์ ํ๋์๋ง ์ ์ฉํฉ๋๋ค.
doclifter๋ฅผ ์ฌ์ฉํ๋ฉด ๋ ๋น ๋ฅด๊ฒ ์คํ๋ฉ๋๋ค. ์์ ๋ฐ์ดํฐ๋ manlifter.prof์ ๊ธฐ๋ก๋๊ณ ์์ฝ๋ฉ๋๋ค.
๋ณด๊ณ ์๋ ํ์ค ์ถ๋ ฅ์ ๋ก๊ทธ์จ์ ์ถ๊ฐ๋ฉ๋๋ค. ๊ฒฝ๊ณ : ์์ ๋ฐ์ดํฐ ํ์ผ์
๋ณด๊ณ ์ ์์ฑ์ ์ํ ํ์ฒ๋ฆฌ๋
์ค์ ์ฒ๋ฆฌ(๋๋ ๊ทธ ์ด์!).
-q
์ผ๋ฐ์ ์ผ๋ก ๊ฐ doclifter ํธ์ถ์ -q(์กฐ์ฉํ) ์ต์ ์ ์ ๋ฌํฉ๋๋ค. ์ค๋ฅ ํํฐ ๋ชจ๋์์,
๋ฒ์ญ์ด ์คํจํ ํ์ผ ๋ชฉ๋ก์ ๋ฐํํฉ๋๋ค.
-v
๊ฐ doclifter ํธ์ถ์ -v(verbose) ์ต์ ์ ์ ๋ฌํฉ๋๋ค. ์ด ์ต์ ์ ๋ค์๊ณผ ๊ฐ์ด ๋ฐ๋ณต๋ ์ ์์ต๋๋ค.
์์ธ ์์ค์ ๋์ ๋๋ค.
-s
์ค์บํ ์น์ ์ ์ง์ ํฉ๋๋ค. ์ด๊ฒ์ ์ธ์์ ํจ๊ป ์ฌ์ฉํ์ญ์์ค. ๊ทธ๋ด ๋ ํ์ํ์ง ์์์ผ ํฉ๋๋ค.
์ ์ฒด ํธ๋ฆฌ์ ๋ณํ์ ์ํํฉ๋๋ค.
-S
๋ค์์์ ์ค๋ฅ ํต๊ณ๋ฅผ ์ปดํ์ผํฉ๋๋ค. ๋งจ๋ฆฌํํฐ ํ์ค ์ ๋ ฅ์ ํ์๋๋ ๋ก๊ทธ ํ์ผ. ์ด๊ฒ
์ต์ ์ ์ฃผ๋ก ๋ฌธ์๋ฆฌํํฐ ๊ฐ๋ฐ์.
-X
๋ฐฐ์น ๋ชจ๋์์๋ ์ธ์ ํ์ผ์ ๋์ด๋ ํ์ด์ง๋ฅผ ์ ์ธํฉ๋๋ค. ํ์ด์ง์ ์ฌ์ฉ๋จ
์ข์ ๊ฒ์ผ๋ก ์๋ ค์ ธ ์๊ณ ๋ค์ด ์ฌ๋ฆฌ๋ ๋ฐ ๋งค์ฐ ์ค๋ ์๊ฐ์ด ๊ฑธ๋ฆฝ๋๋ค.
ํ ์คํธ ์คํ ์๊ฐ. (๋๋ถ๋ถ์ ํ์ด์ง๋ XNUMX์ด ์ด๋ด์ ๋ค์ด์ฌ๋ ค์ง์ง๋ง ๋ช ํ์ด์ง๋
15๋ถ ์ด์)
๋งจ๋ฆฌํํฐ ๋ก๊ทธ ํ์ผ์ ํ์ค ์ถ๋ ฅ์ผ๋ก ๋ด๋ณด๋ ๋๋ค. ํ์ผ์ ํ์์คํฌํ ๋ผ์ธ์ผ๋ก ์์ํ๊ณ
๋น ์ค, ์คํ ์๊ฐ ๋ฐ ๋ค์ํ ํฅ๋ฏธ๋ก์ด ํต๊ณ๋ฅผ ์ ๊ณตํ๋ ์ค๋ก ๋๋ฉ๋๋ค.
์ด๋ค ์ฌ์ด์๋ ๊ฐ ํ์ผ์ ๋ํด ํ๋์ฉ ๋น ์ค๋ก ๊ตฌ๋ถ๋ ์คํ ์๊ฐ ์์ต๋๋ค. ๋ฌธ์๋ฆฌํํฐ
์คํ๋์๋ค.
๊ฐ ์คํ ์์ ์ฒซ ๋ฒ์งธ ์ค์ "!"๋ก ์์ํ๊ณ ๊ทธ ๋ค์ ์์ค์ ๊ฒฝ๋ก๋ช ์ด ์ต๋๋ค.
์๋ ํธ์ถ๊ธฐ, "=" ๋ฐ ํด๋น ํ์ผ์์ ์คํ๋๋ doclifter์ ๋ฐํ ์ํ.
๊ทธ ๋ค์์ ๊ณต๊ฐ์ด๊ณ ๋ฌธ์๋ฆฌํํฐ์ ๋ฐํ์(์ด)์ ๋๋ค.
์ด ์ฒซ ์ค ๋ค์๋ ์ ๋ณด ๋ฉ์์ง์ ์ค๋ฅ ์ถ๋ ฅ์ด ์ฌ ์ ์์ต๋๋ค.
๋ฅํฐ ๋ฆฌํํฐ ์คํ.
๋งจ๋ฆฌํํฐ ์ ์ฌ๋ณธ์ ์ฐพ์์ผ ํฉ๋๋ค. ๋ฌธ์๋ฆฌํํฐ ํ์ฌ ๋๋ ํ ๋ฆฌ ๋๋ ๋ค์ ์ค ํ๋์์
๋ช ๋ น ๋๋ ํ ๋ฆฌ PATH ์คํํ๊ธฐ ์ํด.
onworks.net ์๋น์ค๋ฅผ ์ฌ์ฉํ์ฌ manlifter ์จ๋ผ์ธ ์ฌ์ฉ