GROFF(1)

명칭
groff - groff 문서 포맷 시스템의 프론트엔드

서식
groff [-abeghilpstvzCEGNRSUVXZ] [-w name] [-W name] [-m name] [-F dir] [-I dir] [-T dev] [-f fam] [-M dir] [-d cs] [-r cn] [-n num] [-o list] [-P arg] [-L arg] [ files... ]

명령행 옵션과 파라미터의 사이에 공백을 포함하는 것이 가능합니다.

해설
groff (은)는, groff 문서 포맷 시스템의 프론트엔드 프로그램입니다. 통상 groff 하 troff (을)를 실행해, 그 출력을 지정된 디바이스로 취급하기 위한 후 처리 프로그램을 실행합니다. 이용 가능한 디바이스는 이하대로입니다:

ps  PostScript 프린터나 프레뷰아.

dvi TeX 의 dvi 포맷.

X75 75dpi 의 X11 프레뷰아.

X100
    100dpi 의 X11 프레뷰아.

ascii
    타입 라이터를 닮은 특성을 가지는 디바이스.

latin1
    ISO Latin-1 (ISO 8859-1) 캐릭터 집합을 이용한다 타입 라이터를 닮은 특성을 가지는 디바이스.

koi8-r
    러시아어 KOI8-R 캐릭터 집합을 이용하는 타입 라이터를 닮은 특성을 가지는 디바이스.

utf8
    UTF-8 인코딩의 Unicode (ISO 10646) 캐릭터 집합을 이용한다 타입 라이터를 닮은 특성을 가지는 디바이스.

cp1047
    EBCDIC code page IBM cp1047 를 이용한다 타입 라이터를 닮은 특성을 가지는 디바이스 (예를 들면 OS/390 Unix).

lj4 HP LaserJet4 호환 (또는 다른 PCL5 호환) 프린터.

lbp Canon CAPSL 프린터용 (LBP-4 와 LBP-8 시리즈의 레이저 프린터).

html
    HTML 출력을 실시합니다.

지정된 디바이스용의 뒤처리를 실시하는 프로그램은, 디바이스 기술 파일의 postpro 명령에 의해 지정되어 있습니다. 이것은 -X 옵션에 의해 변경할 수 있습니다.

디폴트의 디바이스는 ps 입니다. pic, eqn, grn, grap, tbl, refer, soelim 의 임의의 사전 처리를 실시하게 할 수도 있습니다.

인수를 수반하지 않는 옵션은 - 의 후에 정리해 계속할 수가 있습니다. 파일명의 대신에 이용된다 - (은)는 표준 입력을 의미합니다.

grog 명령을 이용해 문서를 올바르고 포맷하기 위한 groff 명령을 조사할 수가 있습니다.

옵션

-h  헬프 메세지를 표시합니다.

-e  eqn (을)를 사용해 사전 처리를 실시합니다.

-t  tbl (을)를 사용해 사전 처리를 실시합니다.

-g  grn (을)를 사용해 사전 처리를 실시합니다.

-G  grap (을)를 사용해 사전 처리를 실시합니다.

-p  pic (을)를 사용해 사전 처리를 실시합니다.

-s  soelim (을)를 사용해 사전 처리를 실시합니다.

-Idir
    이 옵션은 soelim(1) 에 기술되고 있습니다. 이 옵션은 -s 옵션을 암묵적으로 지정합니다.

-R  refer (을)를 사용해 사전 처리를 실시합니다. refer 에 인수를 건네주는 기구는 준비되어 있지 않습니다. refer 의 대부분의 옵션은, 파일중에 기술할 수가 있는 등가인 명령을 갖추고 있기 때문입니다. 자세하게는 refer(1) 의 메뉴얼을 참조해 주세요.

-v  groff (으)로부터 기동되는 프로그램의 버젼 번호를 표시합니다.

-V  실행하지 않고, groff 그리고 실행되는 처리 내용을 표준 출력에 표시합니다.

-z  troff (으)로부터의 출력을 버립니다. 에러 메세지만이 표시됩니다.

-Z  troff (으)로부터의 출력을 후 처리하지 않습니다. 통상 groff (은)는, 자동적으로 적당한 후 처리 프로그램을 기동합니다.

-Parg
    후 처리 프로그램에 arg (을)를 인수로서 건네줍니다. 다른 인수는 다른 -P 옵션으로 지정할 필요가 있습니다. groff (은)는, arg 의 전에 - (을)를 붙여 명령에 건네주거나 하지 않는 것에 주의해 주세요.

-l  프린터의 스풀러에 출력합니다. 인자 출력에 이용되는 명령은, 디바이스 기술 파일의 print 명령에 의해 지정됩니다 (이것이 존재하지 않는 경우에는, -l (은)는 무효과입니다).

-Larg
    arg (을)를 프린터 스풀러 프로그램에 건네줍니다. 다른 인수는, 다른 -L 옵션으로 지정할 필요가 있습니다. groff (은)는, arg 의 전에 - (을)를 붙여 명령에 건네주거나 하지 않는 것에 주의해 주세요. 디바이스 기술 파일에 print 명령이 없는 경우에는, -L (은)는 무시됩니다.

-Tdev
    디바이스 dev 용으로 출력합니다. 디폴트의 디바이스는 ps 입니다.

-X  통상의 뒤처리 프로그램의 대신에, gxditview (을)를 기동해 preview 합니다. groff 하 gxditview 에 -printCommand 옵션을 건네줍니다. 이 옵션은 groff 에 -l 옵션지정시에 실행된다 Print 액션을 실행시킵니다. -Tps 이외가 지정되어 있는 경우는, 좋은 결과를 얻을 수 없습니다.

-N  eqn 의 단락 캐릭터간에 개행이 들어가는 것을 금지합니다. eqn 의 -N 옵션과 같습니다.

-S  보다 안전한 모드. -S 옵션을 pic 에 건네주어, 다음의 troff 리퀘스트를 무효화합니다: .open, .opena, .pso, .sy, .pi 보안상의 이유로부터 안전한 모드는 디폴트로 유효합니다.

-U  안전하지 않은 모드. 낡은 안전하지 않은 동작에 되돌립니다.

-a
-b
-i
-C
-E
-wname
-Wname
-mname
-olist
-dcs
-rcn
-Fdir
-Mdir
-ffam
-nnum
    이러한 옵션의 자세한 것은, troff(1) 에 기술되어 있습니다.

환경 변수

GROFF_COMMAND_PREFIX
    만약 이 변수가 X (으)로 설정되어 있으면(자), groff 하 troff 의 것인지 비교적 Xtroff (을)를 기동합니다. 이것은, tbl, pic, eqn, grn, refer, soelim 에도와 같이 영향을 줍니다. grap, gropos, grodvi, grotty, grolj4, grohtml, gxditview 에는 영향을 주지 않습니다.

GROFF_TMAC_PATH
    디폴트 디렉토리에 가세해, 매크로 파일을 검색해야 할 디렉토리의 리스트 (리스트의 단락은 코론입니다). 한층 더 자세한 것은 troff(1) (을)를 참조해 주세요.

GROFF_TYPESETTER
    디폴트의 디바이스

GROFF_FONT_PATH
    디폴트 디렉토리에 가세해, devname (이)라는 이름의 디렉토리를 검색해야 할 디렉토리의 리스트 (리스트의 단락은 코론입니다). 한층 더 자세한 것은 troff(1) (을)를 참조해 주세요.

GROFF_BIN_PATH
    이 검색 패스는, groff 하지만 기동하는 명령을 위해서(때문에), PATH 의 전에 사용됩니다. 설정하지 않으면 PATH 의 전에 `/usr/bin'가 추가됩니다.

GROFF_TMPDIR
    일시적인 파일이 작성되는 디렉토리. 만약, GRROFF_TMPDIR 하지만 설정함 라고 있지 않고, TMPDIR 하지만 설정되어 있다면, TMPDIR 그리고 나타나는 디렉토리 에 일시파일이 생성됩니다. 아주 없으면, 일시파일은 /tmp 에 만들어집니다. grops(1) (와)과 refer(1) 하지만 일시파일을 작성할 가능성이 있습니다.

관련 파일
/usr/share/groff_font/devname/DESC 디바이스 name 의 디바이스 기술 파일

/usr/share/groff_font/devname/F
    디바이스 name (을)를 위한 폰트 F (을)를 기술한 폰트 파일

EBCDIC 호스트에 대해서는, 출력 디바이스 ascii, latin1, utf8 (은)는 사용 불가입니다. 같이 cp1047 (은)는 ASCII 베이스의 operating system상에서는 사용 불가입니다.

사용예
메뉴얼 페이지 foo. 1 (을)를 표준 출력에 대해, latin-1 출력 디바이스를 사용해 인쇄해, less (을)를 페이쟈에 사용하려면 , 다음의 명령을 사용합니다:

    groff -mandoc -Tlatin1 foo. 1 | less

또, 다음과 같이도 사용할 수 있습니다:

    groff -m mandoc -Tlatin1 foo. 1 | less

저자
James Clark <jjc@jclark.com>

버그
버그 리포트는, bug-groff@gnu.org 까지 부탁합니다. 리포트 시에는 버그를 재현할 수 있는 완전한 예제를 첨부해, 당신 이익 용 하고 있는 groff 의 버젼을 더해 주세요.

COPYRIGHT
Copyright © 1989-2000 Free Software Foundation, Inc.

groff 는 프리 소프트웨어입니다. Free Software Foundation 로부터 출판되고 있는 the GNU General Public License 의 ver 2.0 과소 이후에 근거하는 한 재배포하거나 변경하는 것이 가능합니다.

groff 는 쓰기 쉬운 툴로서 배포되는 것을 바람직하고 있습니다만, 어떠한 프로텍션도 없습니다. 그것이 상업적이어도 어느 특정의 눈 목표에 대하는 것만으로 있어도 프로텍션은 없습니다. 자세하게는 GNU 의 General Public License 를 참조해 주세요.

당신 (은)는 groff 의 카피를 GNU General Public License 와 함께 수 취하고 있을 것입니다. 그 COPYING 를 참조해 주세요. 그래 있고 경우에는, Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA 까지 연락 주세요.

입수성
최신의 groff 는 대부분 ftp.gnu.org 의 gnu/groff 디렉토리에 놓여져 있어 anonymous ftp 로 입수할 수 있습니다.

groff 만이, Ted Faber <faber@lunabase.org> 가 기술한 자유롭게 입수 가능한 grap 실장을 서포트합니다. 실물은, 다음의 곳에 있습니다:

    http://www.lunabase.org/~faber/Vault/software/grap/

관련 항목
grog(1), troff(1), tbl(1), pic(1), eqn(1), grn(1), grap(1), soelim(1), refer(1), grops(1), grodvi(1), grotty(1), grolj4(1), grolbp(1), grohtml(1), gxditview(1), groff_font(5), groff_out(5), groff_man(7), groff_ms(7), groff_me(7), groff_char(7)