Groffer - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

Groffer - hiển thị các tập tin và trang người đàn ông trên X và tty

SYNOPSIS

người nói tục [--] [thông số tập tin ....]

người nói tục [chế độ-tùy chọn ....] [tùy chọn lộn xộn ....] [man-option ....] [tùy chọn X ....]
[--] [thông số tập tin ....]

người nói tục -h | --Cứu giúp

người nói tục -v | --phiên bản

MÔ TẢ

người nói tục chương trình là cách dễ nhất để sử dụng sự lộn xộn(1). Nó có thể hiển thị tùy ý
tài liệu được viết trong sự lộn xộn ngôn ngữ, xem sự lộn xộn(7), hoặc khác sự đùa giỡn ngôn ngữ, xem
sự đùa giỡn(7), tương thích với bản gốc troff ngôn ngữ. Nó tìm và chạy tất cả
cần thiết sự lộn xộn bộ tiền xử lý, chẳng hạn như hóa học.

người nói tục chương trình cũng bao gồm nhiều tính năng để tìm và hiển thị Unix
trang hướng dẫn sử dụng (người đàn ông trang), để nó có thể được sử dụng thay thế cho một người đàn ông(1) chương trình.
Hơn nữa, các tệp nén có thể được xử lý bằng gzip(1) hoặc bzip2(1) được giải nén trên-
con ruồi.

Cách sử dụng thông thường khá đơn giản bằng cách cung cấp tên tệp hoặc tên của người đàn ông trang không có
các tùy chọn khác. Nhưng việc xử lý tùy chọn có nhiều khả năng tạo ra
hành vi cư xử. Điều này có thể được thực hiện trong các tệp cấu hình, với môi trường shell
biến $ GROFFER_OPThoặc trên dòng lệnh.

Đầu ra có thể được tạo và xem theo nhiều cách khác nhau có sẵn cho sự lộn xộn.
Điều này bao gồm sự lộn xộn trình xem X Window gốc gxditview(1), mỗi Bản viết lại, pdf, hoặc là dvi
chương trình hiển thị, một trình duyệt web bằng cách tạo html in www chế độ, hoặc một số văn bản chế độ in
thiết bị đầu cuối văn bản.

Hầu hết các tùy chọn phải được đặt tên khi chạy sự lộn xộn trực tiếp được xác định
tự động cho người nói tục, do việc sử dụng nội bộ của Grog(1) chương trình. Nhưng tất cả
các bộ phận cũng có thể được điều khiển thủ công bằng các đối số.

Một số tên tệp có thể được chỉ định trên các đối số dòng lệnh. Chúng được biến đổi
vào một tài liệu duy nhất theo cách thông thường sự lộn xộn.

Xử lý tùy chọn được thực hiện theo kiểu GNU. Các tùy chọn và tên tệp có thể được trộn một cách tự do. Các
tùy chọn '--'đóng xử lý tùy chọn, tất cả các đối số sau đây được coi là tên tệp.
Các tùy chọn dài có thể được viết tắt theo một số cách.

TÙY CHỌN TỔNG QUAN

phá vỡ lựa chọn

[-h | --Cứu giúp] [-v | --phiên bản]

người nói tục chế độ lựa chọn

[--tự động] [--vỡ nợ] [- chế độ mặc định mode1, mode2,….] [--dvi] [--groff]
[--html] [--latin1] [--chế độ chế độ hiển thị] [--pdf] [--pdf2] [--ps] [--nguồn]
[--bản văn] [--đến thiết bị xuất chuẩn] [--tty] [--utf8] [--người xem ăn xin] [--www] [--NS | --NS]

lựa chọn liên quan đến sự lộn xộn

[-T | --thiết bị thiết bị] [-Z | - đầu ra ngay lập tức | --ditroff]

Tất cả xa hơn sự lộn xộn các lựa chọn ngắn được chấp nhận.

lựa chọn cho người đàn ông trang

[--đề nghị] [--apropos-dữ liệu] [--apropos-phát triển] [--apropos-progs] [--Đàn ông]
[--không có đàn ông] [--không đặc biệt] [--là gì]

Dài lựa chọn Lấy kết thúc từ GNU người đàn ông

[--tất cả các] [--ascii] [--ditroff] [--gia hạn hậu tố] [--ngôn ngữ Ngôn ngữ]
[--local-tệp] [--vị trí | --ở đâu] [--manpath dir1: dir2:….] [- không có vị trí]
[--máy nhắn tin chương trình] [- phần sec1: sec2:….] [--hệ thống sys1, sys2,….]
[--troff-thiết bị thiết bị]

Các tùy chọn dài hơn của GNU người đàn ông cũng được chấp nhận.

X Cửa sổ Toolkit lựa chọn

[--bd | --màu viền pixels] [--bg | --lai lịch màu sắc]
[--bw | --chiều rộng biên giới pixels] [--trưng bày màn hình X] [--fg | --vấn đề xung quanh màu sắc]
[--fn | --ft | --nét chữ tên_phông chữ] [--hình học kích thước_pos] [--nghị quyết giá trị] [--rv]
[--chức vụ chuỗi] [--xrm tài nguyên X]

lựa chọn cho phát triển

[--gỡ lỗi] [--debug-tên tệp] [--debug-grog] [--debug-giữ] [--debug-params]
[--debug-tmpdir] [--không làm gì cả] [--in văn bản] [-V]

thông số tập tin đối số

thông số tập tin tham số là tất cả các đối số không phải là một tùy chọn cũng không phải là một tùy chọn
tranh luận. Chúng thường có nghĩa là tên tệp hoặc người đàn ông trang lược đồ tìm kiếm.

Sau đây, thuật ngữ phần_phần mở rộng Được sử dụng. Nó có nghĩa là một từ mà
bao gồm một người đàn ông phần được theo sau bởi một mở rộng. Tên của
a người đàn ông phần là một ký tự duy nhất từ [1–9 phút], Các mở rộng là một số từ. Các
mở rộng hầu hết là thiếu.

Không thông số tập tin tham số có nghĩa là đầu vào tiêu chuẩn.

- là viết tắt của đầu vào tiêu chuẩn (có thể xảy ra nhiều lần).

tên tập tin tên đường dẫn của một tệp hiện có.

Đàn ông:tên(phần_phần mở rộng)
Đàn ông:tên.phần_phần mở rộng
tên(phần_phần mở rộng)
tên.phần_phần mở rộng
phần_phần mở rộng tên
tìm kiếm trang người đàn ông tên trong phần có phần mở rộng tùy chọn
phần_phần mở rộng.

Đàn ông:tên trang người đàn ông thấp nhất người đàn ông phần có tên.

tên if tên không phải là một tìm kiếm tệp hiện có cho trang người đàn ông tên trong
phần người đàn ông thấp nhất.

TÙY CHỌN CHI TIẾT

người nói tục chương trình thường có thể được chạy với rất ít tùy chọn. Nhưng vì những mục đích đặc biệt,
nó hỗ trợ nhiều tùy chọn. Chúng có thể được phân loại thành 5 lớp tùy chọn.

Tất cả các tùy chọn ngắn của người nói tục tương thích với các tùy chọn ngắn của sự lộn xộn(1). Xuyên suốt
tùy chọn của người nói tục tương thích với các tùy chọn dài của người đàn ông(1).

Các đối số cho tên tùy chọn dài có thể được viết tắt theo một số cách. Đầu tiên, đối số
được kiểm tra xem liệu nó có thể được kéo dài như hiện tại hay không. Hơn nữa, mỗi dấu trừ - is
được coi như một điểm khởi đầu cho một cách viết tắt mới. Điều này dẫn đến một tập hợp nhiều
chữ viết tắt của một đối số. Ví dụ, --de-nf có thể được sử dụng như một chữ viết tắt
cho --debug-không-func, Nhưng --cái hang hoạt động tốt. Nếu chữ viết tắt của đối số dẫn đến
đến một số tùy chọn kết quả, một lỗi được đưa ra.

Những chữ viết tắt này chỉ được phép trong biến môi trường $ GROFFER_OPT, nhưng không phải trong
các tệp cấu hình. Trong cấu hình, tất cả các tùy chọn dài phải chính xác.

người nói tục phá vỡ Các lựa chọn
Ngay sau khi một trong các tùy chọn này được tìm thấy trên dòng lệnh, nó sẽ được thực thi, được in ra
đầu ra tiêu chuẩn và chạy người nói tục được chấm dứt sau đó. Tất cả các đối số khác
bị bỏ qua.

-h | --Cứu giúp
In thông tin trợ giúp với giải thích ngắn gọn về các tùy chọn cho đầu ra tiêu chuẩn.

-v | --phiên bản
In thông tin phiên bản ra đầu ra tiêu chuẩn.

người nói tục Chế độ Các lựa chọn
Chế độ hiển thị và các chương trình người xem được xác định bởi các tùy chọn này. Nếu không có
các tùy chọn chế độ và trình xem này được chỉ định người nói tục cố gắng tìm một chế độ hiển thị phù hợp
tự động. Các chế độ mặc định là chế độ pdf, chế độ ps, chế độ html, chế độ xvà chế độ dvi
trong X Window với những người xem khác nhau và chế độ tty với thiết bị utf8 Dưới ít trên một thiết bị đầu cuối;
các chế độ khác được kiểm tra nếu các chương trình cho chế độ mặc định chính không tồn tại.

Trong X Window, nhiều chương trình tạo cửa sổ riêng khi được gọi. người nói tục có thể chạy những
người xem như một chương trình độc lập trong nền. Vì điều này không hoạt động ở chế độ văn bản
trên thiết bị đầu cuối (tty) phải có cách để biết người xem nào là đồ họa X Window
các chương trình. Các người nói tục script có một tập hợp nhỏ thông tin về một số tên người xem. Nếu một
đối số người xem của dòng lệnh chọn một phần tử được giữ dưới dạng chương trình Cửa sổ X trong
danh sách này nó được coi như một trình xem có thể chạy ở chế độ nền. Tất cả những thứ khác, không xác định
cuộc gọi của người xem không chạy trong nền.

Đối với mỗi chế độ, bạn có thể tự do chọn bất kỳ người xem nào bạn muốn. Đó không cần phải là một số
trình xem đồ họa phù hợp với chế độ này. Có một cơ hội để xem nguồn đầu ra; vì
ví dụ, sự kết hợp của các tùy chọn --mode = ps và --viewer = ít hơn hiển thị nội dung của
các Bản thảo đầu ra, mã nguồn, với máy nhắn tin ít.

--tự động Tương đương với --mode = auto.

--vỡ nợ
Đặt lại tất cả cấu hình từ các tùy chọn dòng lệnh đã xử lý trước đó thành
giá trị mặc định. Điều này rất hữu ích để xóa tất cả các tùy chọn cũ của
cấu hình, trong $ GROFFER_OPTvà khởi động lại quá trình xử lý tùy chọn chỉ sử dụng phần còn lại
của dòng lệnh.

- chế độ mặc định mode1, mode2,….
Đặt trình tự các chế độ cho tự động chế độ vào danh sách được phân tách bằng dấu phẩy được đưa ra trong
tranh luận. Xem --chế độ để biết chi tiết về các chế độ. Hiển thị theo cách mặc định;
thực ra, điều này có nghĩa là thử các chế độ x, psvà tty trong trình tự này.

--dvi Tương đương với --mode = dvi.
--người xem ăn xin
Chọn một chương trình người xem cho dvi chế độ. Đây có thể là tên tệp hoặc chương trình
tìm kiếm trong $ PATH. Cửa sổ X đã biết dvi người xem bao gồm xdvi(1) dvilx(1). Trong
mỗi trường hợp, các đối số có thể được cung cấp thêm.

--groff
Tương đương với --mode = Groff.

--html Tương đương với --mode = html.
--người xem
Chọn một chương trình trình duyệt web để xem trong html chế độ. Nó có thể là tên đường dẫn của
một tệp thực thi hoặc một chương trình trong $ PATH. Trong mỗi trường hợp, các đối số có thể được cung cấp
Ngoài ra.

--chế độ giá trị
Đặt chế độ hiển thị. Các giá trị chế độ sau được công nhận:

tự động Chọn chế độ hiển thị tự động xác định. Trình tự của
các chế độ đã thử có thể được đặt bằng - chế độ mặc định Lựa chọn. Hữu ích cho
khôi phục lại mặc định chế độ khi một chế độ khác đã được chỉ định trước đó.

dvi Hiển thị đầu vào được định dạng trong một dvi chương trình người xem. Theo mặc định, định dạng
đầu vào được hiển thị với xdvi(1) chương trình.

sự lộn xộn Sau khi xác định tệp, chuyển người nói tục để xử lý đầu vào như
sự lộn xộn(1) sẽ làm. Điều này vô hiệu hóa người nói tục các tính năng xem.

html Dịch đầu vào sang định dạng html và hiển thị kết quả trong trình duyệt web
chương trình. Theo mặc định, sự tồn tại của một chuỗi các trình duyệt web tiêu chuẩn
được thử nghiệm, bắt đầu với konquerer(1) Mozilla(1). Trình xem html văn bản
is Linh miêu(1).

pdf Chuyển đổi sự đùa giỡn đầu vào các tập tin thành một PDF hồ sơ bằng cách sử dụng sự lộn xộn (1) thiết bị
-tpdf. Đây là mặc định PDF máy phát điện. Tạo ra PDF hồ sơ is
hiển thị với các chương trình người xem phù hợp, chẳng hạn như đồng ý(1).

PDF2. Đây là truyền thống pdf chế độ. Đôi khi chế độ này tạo ra chính xác hơn
đầu ra hơn mặc định PDF chế độ. Theo mặc định, đầu vào được định dạng bởi
sự lộn xộn sử dụng thiết bị Postscript, sau đó nó được chuyển đổi thành tệp PDF
định dạng bằng cách sử dụng gs(1), hoặc ps2pdf(1). Nếu không thể, Bản thảo
chế độ (ps) được sử dụng thay thế. Cuối cùng, nó được hiển thị bằng cách sử dụng trình xem khác nhau
chương trình.

ps Hiển thị đầu vào được định dạng trong chương trình xem Postscript. Theo mặc định,
đầu vào được định dạng được hiển thị trong một trong nhiều chương trình xem.

văn bản Định dạng trong một sự lộn xộn văn bản chế độ và ghi kết quả vào đầu ra tiêu chuẩn mà không có
một máy nhắn tin hoặc chương trình người xem. Thiết bị văn bản, latin1 theo mặc định, có thể là
được chọn với tùy chọn -T.

tty Định dạng trong một sự lộn xộn văn bản chế độ và ghi kết quả vào đầu ra tiêu chuẩn bằng cách sử dụng
chương trình nhắn tin văn bản, ngay cả khi ở trong X Window.

www Tương đương với --mode = html.

x Hiển thị đầu vào được định dạng trong bản gốc sự đùa giỡn người xem. Theo mặc định,
đầu vào được định dạng được hiển thị với gxditview(1) chương trình đang được phân phối
Cùng với sự lộn xộn. Nhưng công cụ cửa sổ X tiêu chuẩn xditview(1) cũng có thể là
được chọn với tùy chọn --người xem. Độ phân giải mặc định là 75dpi, Nhưng
100dpi cũng có thể. Mặc định sự lộn xộn thiết bị để giải quyết
75dpi is X75-12, Cho 100dpi nó là X100. Tương ứng sự lộn xộn
trung gian đầu ra cho thiết bị thực tế được tạo ra và kết quả là
hiển thị. Để giải quyết 100dpi, chiều rộng mặc định của hình dạng của
chương trình hiển thị được chọn để 850dpi.

X Tương đương với --mode = x.

Các chế độ sau không sử dụng người nói tục các tính năng xem. Họ chỉ
thú vị cho các ứng dụng nâng cao.

sự lộn xộn Tạo đầu ra thiết bị đơn giản sự lộn xộn mà không cần sử dụng chế độ xem đặc biệt
tính năng của người nói tục. Nếu không có thiết bị nào được chỉ định theo tùy chọn -T các sự lộn xộn
mặc định ps được giả định.

nguồn Xuất mã nguồn roff của các tệp đầu vào mà không cần xử lý thêm.

--pdf Tương đương với --mode = pdf.
--pdf2 Tương đương với --mode = pdf2.
--người xem ăn xin
Chọn một chương trình người xem cho pdf chế độ. Đây có thể là tên tệp hoặc chương trình
tìm kiếm trong $ PATH; đối số có thể được cung cấp thêm.

--ps Tương đương với --mode = ps.
--người xem ăn xin
Chọn một chương trình người xem cho ps chế độ. Đây có thể là tên tệp hoặc chương trình
tìm kiếm trong $ PATH. Những người xem Postscript phổ biến bao gồm đồng ý(1) thuyết minh(1) gv(1)
chế độ xem ma(1), và gs(1), Trong mỗi trường hợp, các đối số có thể được cung cấp thêm.

--nguồn
Tương đương với --mode = nguồn.

--bản văn Tương đương với --mode = text.

--đến thiết bị xuất chuẩn
Tệp cho chế độ đã chọn được tạo và nội dung của nó được in theo tiêu chuẩn
đầu ra. Nó sẽ không được hiển thị ở chế độ đồ họa.

--tty Tương đương với --mode = tty.
--người xem ăn xin
Chọn một máy nhắn tin văn bản cho chế độ tty. Máy nhắn tin tiêu chuẩn là ít(1). Tùy chọn này là
tương đương với người đàn ông tùy chọn --pager =ăn xin. Đối số tùy chọn có thể là tên tệp hoặc
chương trình được tìm kiếm trong $ PATH; đối số có thể được cung cấp thêm.

--www Tương đương với --mode = html.
--người xem
ăn xin.

--NS | --NS
Tương đương với --mode = x.
--người xem ăn xin
Chọn một chương trình người xem cho x chế độ. Các chương trình phù hợp với người xem là gxditview(1)
đó là mặc định và xditview(1). Đối số có thể là bất kỳ tệp thực thi nào hoặc
chương trình trong $ PATH; đối số có thể được cung cấp thêm.

-- Báo hiệu kết thúc quá trình xử lý quyền chọn; tất cả các đối số còn lại được hiểu là
thông số tập tin thông số.

Bên cạnh những, người nói tục chấp nhận tất cả các tùy chọn ngắn hợp lệ cho sự lộn xộn(1) chương trình.
Tất cả khôngngười nói tục các tùy chọn được gửi không sửa đổi qua Grog đến sự lộn xộn. Vì vậy, bộ xử lý hậu kỳ, macro
gói, khả năng tương thích với cổ điển troffvà nhiều hơn nữa có thể được chỉ định theo cách thủ công.

Các lựa chọn liên quan đến sự lộn xộn
Tất cả các tùy chọn ngắn của người nói tục tương thích với các tùy chọn ngắn của sự lộn xộn(1). Các
sau đây của sự lộn xộn các tùy chọn có một ý nghĩa đặc biệt bổ sung bên trong người nói tục or
có ý nghĩa đối với việc sử dụng bình thường.

Do hành vi đầu ra đặc biệt của sự lộn xộn tùy chọn -Z người nói tục được thiết kế để
được chuyển thành sự lộn xộn chế độ; Các người nói tục các tính năng xem bị vô hiệu hóa ở đó. Cai khac
sự lộn xộn tùy chọn không chuyển đổi chế độ, nhưng cho phép tùy chỉnh quá trình định dạng.

--một Điều này tạo ra giá trị xấp xỉ ascii của đầu ra trong văn bản chế độ. Đó có thể là
quan trọng khi máy nhắn tin văn bản gặp sự cố với các chuỗi điều khiển trong tty chế độ.

--NS hồ sơ
Thêm hồ sơ như là một sự lộn xộn tệp macro. Điều này hữu ích trong trường hợp không thể nhận dạng được
tự động.

--P opt_or_arg
Gửi đối số opt_or_arg như một tùy chọn hoặc đối số tùy chọn cho thực tế sự lộn xộn
một loại ngôn ngữ lập trình.

--NS tên phát minh | --thiết bị tên phát minh
Tùy chọn này xác định sự lộn xộnthiết bị đầu ra của. Các thiết bị quan trọng nhất là
thiết bị đầu ra văn bản để tham chiếu đến các bộ ký tự khác nhau, chẳng hạn như ascii,
utf8, latin1, utf8, và những người khác. Mỗi đối số này sẽ chuyển người nói tục thành một
văn bản chế độ sử dụng thiết bị này, để chế độ tty nếu chế độ thực tế không phải là văn bản chế độ.
Sau đây tên phát minh các đối số được ánh xạ tới người nói tục
--mode =tên phát minh tùy chọn: dvi, htmlvà ps. Tất cả X* các đối số được ánh xạ tới chế độ x.
Lẫn nhau tên phát minh đối số chuyển sang chế độ sự lộn xộn sử dụng thiết bị này.

--NS tương đương với sự lộn xộn -X. Nó hiển thị sự lộn xộn trung gian đầu ra với
gxditview. Vì chất lượng tương đối tệ, tùy chọn này không được dùng nữa; sử dụng --NS
thay vì x chế độ sử dụng một X* thiết bị để hiển thị tốt hơn.

-Z | - đầu ra ngay lập tức | --ditroff
Chuyển thành sự lộn xộn chế độ và định dạng đầu vào với sự lộn xộn trung gian đầu ra
mà không cần xử lý hậu kỳ; Thấy chưa thô lỗ(5). Điều này tương đương với tùy chọn --ditroff
of người đàn ông, cũng có thể được sử dụng.

Tất cả khác sự lộn xộn các tùy chọn được hỗ trợ bởi người nói tục, nhưng chúng chỉ minh bạch
chuyển giao cho sự lộn xộn mà không có bất kỳ sự can thiệp nào. Các tùy chọn không rõ ràng
xử lý bởi người nói tục được chuyển đến sự lộn xộn. Do đó, các tùy chọn minh bạch này
không được ghi lại ở đây, nhưng trong sự lộn xộn(1). Do tính tự động trong người nói tục, không ai trong số này
sự lộn xộn cần có các tùy chọn, ngoại trừ cách sử dụng nâng cao.

Các lựa chọn cho người đàn ông trang
--đề nghị
Bắt đầu thích hợp(1) lệnh hoặc cơ sở của người đàn ông(1) để tìm kiếm thông số tập tin
đối số trong tất cả người đàn ông trang mô tả. Mỗi thông số tập tin lập luận được thực hiện cho
tìm kiếm như nó vốn có; phần các bộ phận cụ thể không được xử lý, như vậy 7 sự lộn xộn tìm kiếm
cho hai đối số 7 và sự lộn xộn, với một kết quả lớn; cho thông số tập tin vụng về.7
sẽ không có gì được tìm thấy. Các Ngôn ngữ ngôn ngữ chỉ được xử lý khi được gọi
các chương trình hỗ trợ điều này; GNU thích hợp và người đàn ông -k đừng. Màn hình hiển thị khác nhau
từ thích hợp lập trình theo các khái niệm sau:

* Cấu tạo một sự lộn xộn khung tương tự như một người đàn ông trang đến đầu ra của thích hợp,

* mỗi thông số tập tin đối số được tự tìm kiếm.

* Hạn chế bởi - phần cũng được xử lý,

* các ký tự đại diện được cho phép và xử lý mà không có tùy chọn nào khác.

--apropos-dữ liệu
Chỉ hiển thị thích hợp mô tả cho các tài liệu dữ liệu, đây là người đàn ông(7)
phần 4, 5và 7. Thẳng thắn phần khai báo bị bỏ qua, ký tự đại diện
được chấp nhận.

--apropos-phát triển
Chỉ hiển thị thích hợp mô tả cho các tài liệu phát triển, đây là người đàn ông(7)
phần 2, 3và 9. Thẳng thắn phần khai báo bị bỏ qua, ký tự đại diện
được chấp nhận.

--apropos-progs
Chỉ hiển thị thích hợp mô tả cho các tài liệu về chương trình, đây là người đàn ông(7)
phần 1, 6và 8. Thẳng thắn phần khai báo bị bỏ qua, ký tự đại diện
được chấp nhận.

--là gì
Cho mỗi thông số tập tin đối số tìm kiếm tất cả người đàn ông trang và hiển thị mô tả của họ - hoặc
nói rằng nó không phải là một người đàn ông trang. Điều này được viết từ một lần nữa, vì vậy nó khác với người đàn ông's
những gì là đầu ra bằng các khái niệm sau

* mỗi tên tệp đã truy xuất được thêm vào,

* các tệp cục bộ cũng được xử lý,

* các Ngôn ngữ và hệ thống ngôn ngữ được hỗ trợ,

* màn hình được đóng khung bởi một sự lộn xộn định dạng đầu ra tương tự như một người đàn ông trang,

* các ký tự đại diện được cho phép mà không có tùy chọn nào khác.

Các tùy chọn sau đã được thêm vào người nói tục để chọn xem các đối số tên tệp
được hiểu là tên cho các tệp cục bộ hoặc như một mẫu tìm kiếm cho người đàn ông trang. Các
mặc định là tìm kiếm các tệp cục bộ.

--Đàn ông Kiểm tra các đối số dòng lệnh không phải tùy chọn (filespec) đầu tiên là người đàn ông trang,
thì liệu chúng có đại diện cho một tệp hiện có hay không. Theo mặc định, một thông số tập tin Là đầu tiên
đã kiểm tra xem nó có phải là một tệp hiện có hay không.

--không có đàn ông | --local-tệp
Không kiểm tra người đàn ông trang. --local-tệp là tương ứng người đàn ông tùy chọn.

--không đặc biệt
Tắt các cuộc gọi trước đây của --tất cả các, --apropos *và --là gì.

dài lựa chọn Lấy kết thúc từ GNU người đàn ông
Các tùy chọn dài của người nói tục đã được đồng bộ hóa với các tùy chọn dài của GNU người đàn ông. Xuyên suốt
tùy chọn của GNU người đàn ông được công nhận, nhưng không phải tất cả các tùy chọn này đều quan trọng đối với người nói tục,
vì vậy hầu hết chúng đều bị bỏ qua. Những cái này bị bỏ qua người đàn ông lựa chọn là --người mèo, --troffvà
- cập nhật.

Sau đây, người đàn ông các tùy chọn có ý nghĩa đặc biệt đối với người nói tục được ghi lại.

Nếu hệ thống của bạn có GNU người đàn ông đã cài đặt toàn bộ các tùy chọn dài và ngắn của GNU người đàn ông
chương trình có thể được chuyển qua biến môi trường $ MANOPT; xem người đàn ông(1).

--tất cả các Đang tìm kiếm người đàn ông trang, truy xuất tất cả các tài liệu phù hợp thay vì chỉ một tài liệu.

-7 | --ascii
In văn bản chế độ, hiển thị bản dịch ASCII của các ký tự đặc biệt để quan trọng
môi trường. Điều này tương đương với sự lộn xộn -mtty_char; xem groff_tmac(5).

--ditroff
　 sự lộn xộn trung gian đầu ra. Điều này tương đương với người nói tục -Z.

--gia hạn hậu tố
hạn chế người đàn ông trang tìm kiếm các tên tệp có hậu tố được thêm vào phần của họ
yếu tố. Ví dụ, trong tên tệp /usr/share/man/man3/terminfo.3ncurses.gz
các người đàn ông trang phần mở rộng là lời nguyền.

--ngôn ngữ Ngôn ngữ
Đặt ngôn ngữ cho người đàn ông trang. Điều này có tác dụng tương tự, nhưng ghi đè $ LANG.

--vị trí
In vị trí của các tệp đã truy xuất thành lỗi chuẩn.

- không có vị trí
Không hiển thị vị trí của các tệp đã truy xuất; điều này đặt lại một cuộc gọi trước đây tới
--vị trí. Điều này đã được thêm vào bởi người nói tục.

--manpath 'dir1: dir2: ....'
Sử dụng đường dẫn tìm kiếm được chỉ định để truy xuất người đàn ông trang thay vì chương trình
các giá trị mặc định. Nếu đối số được đặt thành chuỗi trống "" thì tìm kiếm người đàn ông trang is
tàn tật.

--máy nhắn tin
Đặt chương trình máy nhắn tin trong tty chế độ; mặc định là ít. Điều này có thể được thiết lập với --người xem.

- phần sec1: sec2:….
Hạn chế tìm kiếm người đàn ông trang cho cái đã cho phần, một danh sách được phân tách bằng dấu hai chấm.

--hệ thống sys1, sys2,….
Tìm kiếm người đàn ông trang cho các hệ điều hành nhất định; cuộc tranh cãi hệ thống là một
danh sách được phân tách bằng dấu phẩy.

--ở đâu
Tương đương với --vị trí.

X Cửa sổ Toolkit Các lựa chọn
Các tùy chọn dài sau đây được điều chỉnh từ các tùy chọn Bộ công cụ X Window tương ứng.
người nói tục sẽ chuyển chúng đến chương trình người xem thực tế nếu đó là chương trình X Window.
Nếu không, các tùy chọn này sẽ bị bỏ qua.

Thật không may, các tùy chọn này sử dụng kiểu cũ của một điểm trừ duy nhất cho các tùy chọn dài. Vì
người nói tục đã được thay đổi thành tiêu chuẩn bằng cách sử dụng dấu trừ kép cho các tùy chọn dài, cho
thí dụ, người nói tục sử dụng tùy chọn --nét chữ cho tùy chọn Cửa sổ X -nét chữ.

Xem X(7) và tài liệu về các tùy chọn Bộ công cụ X Window để biết thêm chi tiết về những
các tùy chọn và lập luận của chúng.

--lai lịch màu sắc
Đặt màu nền của cửa sổ trình xem.

--bd pixels
Điều này tương đương với --màu viền.

--bg màu sắc
Điều này tương đương với --lai lịch.

--bw pixels
Điều này tương đương với --chiều rộng biên giới.

--màu viền pixels
Chỉ định màu của đường viền xung quanh cửa sổ trình xem.

--chiều rộng biên giới pixels
Chỉ định chiều rộng tính bằng pixel của đường viền bao quanh cửa sổ trình xem.

--trưng bày màn hình X
Đặt màn hình Cửa sổ X nơi chương trình xem sẽ được bắt đầu, xem phần
Tài liệu về X Window cho cú pháp của đối số.

--vấn đề xung quanh màu sắc
Đặt màu nền trước của cửa sổ trình xem.

--fg màu sắc
Điều này tương đương với --vấn đề xung quanh.

--fn tên_phông chữ
Điều này tương đương với --nét chữ.

--nét chữ tên_phông chữ
Đặt phông chữ được sử dụng bởi cửa sổ trình xem. Đối số là tên phông chữ X Window.

--ft tên_phông chữ
Điều này tương đương với --nét chữ.

--hình học kích thước_pos
Đặt hình dạng của cửa sổ hiển thị, điều đó có nghĩa là kích thước và thời điểm bắt đầu của nó
Chức vụ. Nhìn thấy X(7) cho cú pháp của đối số.

--nghị quyết giá trị
Đặt độ phân giải X Window tính bằng dpi (số chấm trên inch) trong một số chương trình trình xem. Duy nhất
giá trị dpi được hỗ trợ là 75 và 100. Trên thực tế, độ phân giải mặc định cho người nói tục
được thiết lập để 75dpi. Độ phân giải cũng đặt thiết bị mặc định trong chế độ x.

--rv Đảo ngược màu nền trước và màu nền của cửa sổ trình xem.

--chức vụ 'một vài chữ'
Đặt tiêu đề cho cửa sổ trình xem.

--xrm 'nguồn'
Đặt tài nguyên Cửa sổ X.

Các lựa chọn cho Phát triển
--gỡ lỗi
Bật tất cả các tùy chọn gỡ lỗi --gỡ lỗi-kiểu. Các tệp tạm thời được giữ và không
đã xóa, Grog đầu ra được in, tên của thư mục tạm thời là
được in, tên tệp hiển thị được in và các thông số được in.

--debug-tên tệp
In tên của các tệp và người đàn ông trang được hiển thị bởi người nói tục.

--debug-grog
In đầu ra của tất cả Grog lệnh.

--debug-giữ
Kích hoạt hai thông tin gỡ lỗi. In tên của thư mục tạm thời và
giữ các tệp tạm thời, không xóa chúng trong quá trình chạy người nói tục.

--debug-params
In các thông số, như thu được từ các tệp cấu hình, từ GROFFER_OPT,
và các đối số dòng lệnh.

--debug-tmpdir
In tên của thư mục tạm thời.

--không làm gì cả
Điều này giống như --phiên bản, nhưng không có đầu ra; không có người xem nào được bắt đầu. Điều này làm cho
chỉ có ý nghĩa trong sự phát triển.

--print =văn bản
Chỉ cần in đối số thành lỗi tiêu chuẩn. Điều này tốt cho việc kiểm tra thông số.

-V Đây là một tùy chọn nâng cao chỉ để gỡ lỗi. Thay vì hiển thị định dạng
đầu vào, rất nhiều người nói tục thông tin cụ thể được in ra đầu ra tiêu chuẩn:

* tên tệp đầu ra trong thư mục tạm thời,

* chế độ hiển thị của thực tế người nói tục chạy,

* chương trình hiển thị để xem kết quả đầu ra với các đối số của nó,

* các tham số hoạt động từ các tệp cấu hình, các đối số trong $ GROFFER_OPTvà
các đối số của dòng lệnh,

* đường ống sẽ được điều hành bởi sự lộn xộn chương trình, nhưng không thực hiện nó.

Các tùy chọn gỡ lỗi hữu ích khác là sự lộn xộn tùy chọn -Z và --mode = Groff.

Thông số tập tin Lập luận
A thông số tập tin tham số là một đối số không phải là một tùy chọn hoặc đối số tùy chọn. Trong người nói tục,
thông số tập tin tham số là tên tệp hoặc mẫu để tìm kiếm người đàn ông trang. Những đầu vào này
các nguồn được thu thập và soạn thành một tệp đầu ra duy nhất, chẳng hạn như sự lộn xộn không.

Hành vi POSIX kỳ lạ coi tất cả các đối số đằng sau đối số không phải tùy chọn đầu tiên là
thông số tập tin các đối số bị bỏ qua. Hành vi GNU để nhận ra các tùy chọn ngay cả khi kết hợp với
thông số tập tin đối số được sử dụng xuyên suốt. Nhưng, như thường lệ, đối số trừ kép -- kết thúc
tùy chọn xử lý và diễn giải tất cả các đối số sau đây là thông số tập tin tranh luận; nên
Hành vi POSIX có thể dễ dàng được chấp nhận.

Các tùy chọn --apropos * có cách xử lý đặc biệt thông số tập tin tranh luận. Mỗi đối số là
được coi là một lược đồ tìm kiếm của riêng nó. Ngoài ra, một regexp (biểu thức chính quy) có thể được sử dụng trong
tệp tin. Ví dụ, người nói tục --đề nghị '^ gro.f $' tìm kiếm sự lộn xộn trong người đàn ông trang
tên, trong khi người nói tục --đề nghị sự lộn xộn tìm kiếm sự lộn xộn ở đâu đó trong tên hoặc mô tả của
các người đàn ông trang.

Tất cả các phần khác của người nói tục, chẳng hạn như màn hình bình thường hoặc đầu ra với --là gì có một
chương trình khác nhau cho filespec. Không có biểu thức chính quy nào được sử dụng cho các đối số. Các
thông số tập tin các đối số được xử lý bởi lược đồ sau.

Cần phải biết rằng trên mỗi hệ thống, người đàn ông trang được sắp xếp theo
nội dung thành nhiều phần. Các cổ điển người đàn ông phần có tên một ký tự,
hoặc là một chữ số từ 1 đến 9 hoặc một trong các nhân vật n or o.

Tùy chọn này có thể được theo sau bởi một chuỗi, cái gọi là mở rộng. Các mở rộng
cho phép lưu trữ một số người đàn ông trang với cùng một tên trong cùng một phần. Nhưng
mở rộng chỉ hiếm khi được sử dụng, thường là nó bị bỏ qua. Sau đó mở rộng được tìm kiếm
tự động bằng bảng chữ cái.

Trong phần sau, chúng tôi sử dụng tên phần_phần mở rộng cho một từ bao gồm một
tính cách phần tên hoặc một phần ký tự được theo sau bởi một mở rộng. Mỗi
thông số tập tin tham số có thể có một trong các dạng sau theo thứ tự giảm dần.

* Không có thông số tập tin tham số có nghĩa là người nói tục chờ đầu vào chuẩn. Tùy chọn trừ -
luôn luôn là viết tắt của đầu vào tiêu chuẩn; nó có thể xảy ra nhiều lần. Nếu bạn muốn tra cứu một
người đàn ông trang gọi là - sử dụng lý lẽ Đàn ông:-.

* Tiếp theo a thông số tập tin được kiểm tra xem đó có phải là tên đường dẫn của tệp hiện có hay không. Nếu không thì nó
được giả định là một mẫu tìm kiếm cho một người đàn ông trang.

* Đàn ông:tên(phần_phần mở rộng), Đàn ông:tên.phần_phần mở rộng, tên(phần_phần mở rộng), or
tên.phần_phần mở rộng tìm kiếm trang người đàn ông tên trong phần người đàn ông và có thể là phần mở rộng của
phần_phần mở rộng.

* Bây giờ Đàn ông:tên tìm kiếm một người đàn ông trang ở mức thấp nhất người đàn ông phần có một tài liệu
gọi là tên.

* phần_phần mở rộng tên là một mô hình của 2 đối số bắt nguồn từ một
phân tích cú pháp đối số của người đàn ông chương trình. Một lần nữa, điều này tìm kiếm trang người đàn ông tên với
phần_phần mở rộng, sự kết hợp của một phần ký tự tùy chọn theo sau bởi một
mở rộng.

* Chúng tôi chỉ còn lại đối số tên mà không phải là một tệp hiện có. Vì vậy, điều này tìm kiếm
các người đàn ông trang gọi là tên ở mức thấp nhất người đàn ông phần có một tài liệu cho tên này.

Một số đối số tên tệp có thể được cung cấp. Chúng được trộn bởi sự lộn xộn thành một
tài liệu. Lưu ý rằng tập hợp các đối số tùy chọn phải phù hợp với tất cả các đối số tệp này.
Vì vậy, ít nhất chúng phải có cùng một phong cách sự lộn xộn ngôn ngữ.

OUTPUT CHẾ ĐỘ

Theo mặc định, người nói tục chương trình thu thập tất cả dữ liệu đầu vào vào một tệp duy nhất, định dạng nó với
sự lộn xộn chương trình cho một thiết bị nhất định, và sau đó chọn một chương trình người xem phù hợp. Các
quá trình thiết bị và người xem trong người nói tục được gọi là chế độ. Chế độ và người xem của một cuộc chạy
người nói tục chương trình được chọn tự động, nhưng người dùng cũng có thể chọn nó với các tùy chọn.
Các chế độ được chọn theo tùy chọn đối số của --mode =chế độ bất kỳ. Ngoài ra, mỗi
đối số này có thể được chỉ định như một tùy chọn của riêng nó, chẳng hạn như chế độ bất kỳ. Hầu hết các
chế độ có một chương trình người xem, có thể được chọn theo tùy chọn --người xem.

Một số chế độ khác nhau được cung cấp, các chế độ đồ họa cho X Window, văn bản chế độ, và một số
trực tiếp sự lộn xộn chế độ để gỡ lỗi và phát triển.

Theo mặc định, người nói tục lần đầu tiên thử xem x chế độ là có thể, sau đó ps chế độ, và cuối cùng
tty chế độ. Trình tự thử nghiệm chế độ này cho tự động chế độ có thể được thay đổi bằng cách chỉ định một dấu phẩy
danh sách các chế độ riêng biệt với tùy chọn - chế độ mặc định.

Việc tìm kiếm người đàn ông trang và giải nén đầu vào đang hoạt động ở mọi chế độ.

Đồ họa Giao diện Chế độ
Các chế độ hiển thị đồ họa hầu hết hoạt động trong môi trường X Window (hoặc tương tự
triển khai trong các môi trường cửa sổ khác). Biến môi trường $ HIỂN THỊ
và tùy chọn --trưng bày được sử dụng để chỉ định màn hình X Window sẽ được sử dụng. Nếu điều này
biến môi trường trống người nói tục giả định rằng không có Cửa sổ X nào đang chạy và thay đổi thành
văn bản chế độ. Bạn có thể thay đổi hành vi tự động này bằng tùy chọn - chế độ mặc định.

Người xem được biết đến với các chế độ hiển thị đồ họa và các chương trình xem X Window tiêu chuẩn của họ
đang

* trong trình xem PDF (pdf chế độ)

* trong trình duyệt web (html or www chế độ)

* trong trình xem Postscript (ps chế độ)

* Cửa sổ X sự đùa giỡn người xem chẳng hạn như gxditview(1) hoặc xditview(1 trong x chế độ)

* trong một chương trình xem dvi (dvi chế độ)

pdf chế độ có một lợi thế lớn - đó là chế độ hiển thị đồ họa duy nhất cho phép
tìm kiếm văn bản trong trình xem; đây có thể là một tính năng thực sự quan trọng. Không may,
phải mất một thời gian để chuyển đổi đầu vào thành định dạng PDF, vì vậy nó không được chọn làm
chế độ chính.

Các trình xem đồ họa này có thể được tùy chỉnh bằng các tùy chọn của Bộ công cụ X Window. Nhưng
người nói tục các tùy chọn sử dụng dấu trừ kép ở đầu thay vì dấu trừ đơn được sử dụng bởi
Bộ công cụ X Window.

bản văn chế độ
Có hai chế độ để xuất văn bản, chế độ văn bản cho đầu ra đơn giản mà không có máy nhắn tin và
chế độ tty để xuất văn bản trên một đầu cuối văn bản bằng một số chương trình máy nhắn tin.

Nếu biến $ HIỂN THỊ không được đặt hoặc trống, người nói tục giả định rằng nó nên sử dụng tty chế độ.

Trong thực tế triển khai, sự lộn xộn thiết bị đầu ra latin1 được chọn cho văn bản chế độ.
Điều này có thể được thay đổi bằng cách chỉ định tùy chọn -T or --thiết bị.

Máy nhắn tin được sử dụng có thể được chỉ định bằng một trong các tùy chọn --máy nhắn tin và --người xem, hoặc bằng cách
biến môi trường $ PAGER. Nếu tất cả những điều này không được sử dụng, ít(1) chương trình với
tùy chọn -r để hiển thị chính xác các chuỗi điều khiển được sử dụng làm máy nhắn tin mặc định.

Reduct ® Chế độ cho Gỡ lỗi và Phát triển
Các chế độ này sử dụng người nói tục xác định và giải nén tập tin. Điều này được kết hợp thành một
một tệp đầu vào được đưa trực tiếp vào sự lộn xộn với chiến lược khác nhau mà không có
người nói tục phương tiện xem. Các chế độ này được coi là nâng cao, chúng hữu ích cho
gỡ lỗi và mục đích phát triển.

nguồn chế độ với tùy chọn --nguồn chỉ hiển thị đầu vào đã giải nén.

Tùy chọn --đến thiết bị xuất chuẩn không hiển thị ở chế độ đồ họa. Nó chỉ tạo tệp cho
chế độ đã chọn và sau đó in nội dung của nó ra đầu ra tiêu chuẩn.

sự lộn xộn chế độ chuyển đầu vào cho sự lộn xộn chỉ sử dụng một số tùy chọn phù hợp được cung cấp cho
người nói tục. Điều này cho phép người dùng lưu đầu ra đã tạo thành một tệp hoặc chuyển nó vào
chương trình khác.

In sự lộn xộn chế độ, tùy chọn -Z vô hiệu hóa quá trình xử lý sau, do đó tạo ra sự lộn xộn
trung gian đầu ra. Trong chế độ này, đầu vào được định dạng, nhưng không được xử lý sau; Thấy chưa
thô lỗ(5) để biết chi tiết.

Tất cả sự lộn xộn các tùy chọn ngắn được hỗ trợ bởi người nói tục.

MAN TRANG ĐANG TÌM KIẾM

Hành vi mặc định của người nói tục trước tiên là kiểm tra xem một tham số tệp có đại diện cho một
tệp cục bộ; nếu nó không phải là một tên tệp hiện có, nó được coi là đại diện cho tên của một
người đàn ông trang. Các tùy chọn sau có thể được sử dụng để xác định xem các đối số có nên
được xử lý dưới dạng tên tệp hoặc người đàn ông trang lập luận.

--Đàn ông buộc phải diễn giải tất cả các tham số tệp là filespec để tìm kiếm người đàn ông trang.

--không có đàn ông
--local-tệp
vô hiệu hóa người đàn ông đang tìm kiếm; vì vậy chỉ các tệp cục bộ được hiển thị.

Nếu không phải là tệp cục bộ hoặc người đàn ông trang đã được truy xuất cho một số thông số tệp, một cảnh báo là
được phát hành trên lỗi tiêu chuẩn, nhưng quá trình xử lý vẫn được tiếp tục.

Tìm kiếm Thuật toán
Bây giờ chúng ta hãy giả định rằng một người đàn ông trang nên được tìm kiếm. Các người nói tục chương trình cung cấp một
cơ sở tìm kiếm cho người đàn ông trang. Tất cả các tùy chọn dài, tất cả các biến môi trường và hầu hết các
chức năng của GNU người đàn ông(1) chương trình đã được thực hiện. Thuật toán tìm kiếm sẽ
xác định tệp nào được hiển thị cho một người đàn ông trang. Quá trình này có thể được sửa đổi bởi
các tùy chọn và các biến môi trường.

Các chỉ người đàn ông hành động bị bỏ qua trong người nói tục được định dạng sẵn người đàn ông trang, Còn gọi là
làm sao trang. Với hiệu suất tuyệt vời của các máy tính thực tế, định dạng sẵn
người đàn ông trang không còn cần thiết nữa. Ngoài ra, người nói tục là một sự đùa giỡn chương trình; nó muốn
đọc sự đùa giỡn các tập tin nguồn và tự định dạng chúng.

Thuật toán truy xuất tệp cho một người đàn ông trang trước tiên cần một tập hợp các thư mục.
Tập hợp này bắt đầu với cái gọi là người đàn ông con đường được sửa đổi sau này bằng cách thêm tên của
hoạt động hệ thống và Ngôn ngữ. Tập hợp phát sinh này được sử dụng để thêm phần
thư mục chứa người đàn ông trang các tập tin.

người đàn ông con đường là danh sách các thư mục được phân tách bằng dấu hai chấm. Nó được tạo ra bởi
các phương pháp sau.

* Biến môi trường $ MANPATH có thể thiết lập.

* Nó có thể được đọc từ các đối số của biến môi trường $ MANOPT.

* Các người đàn ông con đường có thể được chỉ định thủ công bằng cách sử dụng tùy chọn --manpath. Một đối số trống
vô hiệu hóa người đàn ông trang đang tìm kiếm.

* Khi không người đàn ông con đường đã được thiết lập con đường đàn ông(1) chương trình được cố gắng xác định một.

* Nếu điều này không hoạt động, một đường dẫn mặc định hợp lý từ $ PATH được xác định.

Bây giờ chúng ta có một bộ thư mục bắt đầu. Cách đầu tiên để thay đổi tập hợp này là bằng cách thêm
tên của hoạt động hệ thống. Điều này giả định rằng người đàn ông trang trong nhiều hoạt động hệ thống đang
Cài đặt. Điêu nay không phải luc nao cung đung. Tên của như vậy hoạt động hệ thống có thể được cung cấp
bằng 3 phương pháp.

* Biến môi trường HỆ THỐNG $ có mức độ ưu tiên thấp nhất.

* Điều này có thể được ghi đè bởi một tùy chọn trong $ MANOPT.

* Điều này lại bị ghi đè bởi tùy chọn dòng lệnh --hệ thống.

Một số tên của hoạt động hệ thống có thể được đưa ra bằng cách nối tên của chúng, phân tách bằng dấu
dấu phẩy.

người đàn ông con đường được thay đổi bằng cách thêm từng hệ thống đặt tên dưới dạng thư mục con ở cuối mỗi
thư mục của tập hợp. Không có thư mục của người đàn ông con đường bộ được giữ. Nhưng nếu không hệ thống tên là
chỉ định người đàn ông con đường được giữ nguyên.

Sau đó, tập hợp thư mục thực tế có thể được thay đổi bằng cách Ngôn ngữ thông tin. Cái này
giả định rằng có tồn tại người đàn ông trang bằng các ngôn ngữ khác nhau. Sự truy nã Ngôn ngữ có thể
được chọn bởi một số phương pháp.

* Biến môi trường $ LANG.

* Điều này được ghi đè bởi $ LC_MESSAGES.

* Điều này được ghi đè bởi $ LC_ALL.

* Điều này có thể được ghi đè bằng cách cung cấp một tùy chọn trong $ MANOPT.

* Tất cả các biến môi trường này đều bị tùy chọn dòng lệnh ghi đè --ngôn ngữ.

mặc định Ngôn ngữ có thể được chỉ định bằng cách chỉ định một trong các tham số ngôn ngữ giả
C hoặc POSIX. Điều này giống như xóa một Ngôn ngữ thông tin. Các người đàn ông trang
trong mặc định Ngôn ngữ thường bằng tiếng Anh.

Tất nhiên, Ngôn ngữ tên được xác định bởi người đàn ông. Trong GNU người đàn ông, nó được chỉ định trong
Định dạng dựa trên POSIX 1003.1:

[_[.[,]]],

nhưng mã gồm hai chữ cái trong là đủ cho hầu hết các mục đích. Nếu cho một
phức tạp Ngôn ngữ công thức không người đàn ông trang Đã tìm thấy người nói tục tìm kiếm phần đất nước
bao gồm cả hai ký tự đầu tiên này.

Bộ thư mục thực tế được sao chép ba lần. Các Ngôn ngữ tên được thêm vào dưới dạng thư mục con
đến từng thư mục trong bản sao đầu tiên của tập thư mục thực tế (điều này chỉ được thực hiện khi
thông tin ngôn ngữ được đưa ra). Sau đó, viết tắt 2 chữ cái của Ngôn ngữ tên là
được nối dưới dạng thư mục con vào bản sao thứ hai của tập thư mục (điều này chỉ được thực hiện khi
tên ngôn ngữ đã cho có nhiều hơn 2 chữ cái). Bản sao thứ ba của bộ thư mục là
giữ nguyên (nếu không Ngôn ngữ thông tin được đưa ra đây là bộ thư mục được lưu giữ).
Tối đa 3 bản sao này được thêm vào để thiết lập thư mục mới.

Bây giờ chúng ta có một bộ thư mục hoàn chỉnh để làm việc. Trong mỗi thư mục này,
người đàn ông các tập tin được phân tách trong phần. Tên của một phần được đại diện bởi một
ký tự, một chữ số giữa 1 và 9, hoặc nhân vật o or n, theo thứ tự này.

Đối với mỗi loại có sẵn phần, một thư mục con người đàn ông tồn tại chứa tất cả người đàn ông các tập tin
cho điều này phần, Nơi là một ký tự duy nhất như đã mô tả trước đây. Mỗi người đàn ông
nộp trong một phần thư mục có dạng
người đàn ông/.[ ] [.], Nơi và
là tùy chọn. là tên của người đàn ông trang điều đó cũng được chỉ định là
đối số filespec trên dòng lệnh.

mở rộng là một bổ sung cho phần. Postfix này hoạt động giống như một tiểu mục. Một
mở rộng chỉ xảy ra trong tên tệp, không xuất hiện trong tên của phần thư mục con. Nó có thể
được chỉ định trên dòng lệnh.

Mặt khác, nén chỉ là thông tin về cách tệp được nén.
Điều này không quan trọng đối với người dùng, vì vậy nó không thể được chỉ định trên dòng lệnh.

Có 4 phương pháp để chỉ định một phần trên dòng lệnh:

* Biến môi trường $ MANSECT

* Tùy chọn dòng lệnh - phần

* Phụ lục cho tên đối số trong biểu mẫu .

* Biện luận trước khi tên đối số trong biểu mẫu

Cũng có thể chỉ định một số phần bằng cách nối các ký tự đơn lẻ
ngăn cách nhau bằng dấu hai chấm. Người ta có thể tưởng tượng rằng điều này có nghĩa là hạn chế người đàn ông trang tìm kiếm
chỉ một số phần. Bội số phần chỉ có thể cho $ MANSECT và - phần.

Nếu không phần được chỉ định tất cả phần được tìm kiếm lần lượt trong các
đặt hàng, bắt đầu với phần 1, cho đến khi một tệp phù hợp được tìm thấy.

Có 4 phương pháp để chỉ định một mở rộng trên dòng lệnh. Nhưng nó không cần thiết
để cung cấp toàn bộ tên phần mở rộng, một số từ viết tắt là đủ tốt trong hầu hết các trường hợp.

* Biến môi trường PHẦN MỞ RỘNG $

* Tùy chọn dòng lệnh --gia hạn

* Phụ lục cho . đối số trong biểu mẫu .

* Biện luận trước khi tên đối số trong biểu mẫu

Để biết thêm chi tiết về người đàn ông trang tìm kiếm, xem người đàn ông(1).

Các ví dụ of người đàn ông các tập tin
/usr/share/man/man1/groff.1
Đây là một tệp không nén cho người đàn ông trang chui vào phần 1. Nó có thể được gọi là
by
NS# Groffer groff
Không phần được chỉ định ở đây, vì vậy tất cả phần nên được tìm kiếm, nhưng như phần 1
được tìm kiếm trước tiên tập tin này sẽ được tìm thấy đầu tiên. Tên tệp bao gồm
các thành phần sau. / usr / share / man / phải là một phần của người đàn ông con đường; Các
thư mục con man1 / và một phần .1 đại diện cho phần; sự lộn xộn là tên của
người đàn ông trang.

/usr/local/share/man/man7/groff.7.gz
Tên tệp bao gồm các thành phần sau. / usr / local / share / man phải
là một phần của người đàn ông con đường; thư mục con man7 / và một phần .7 đại diện cho
phần; sự lộn xộn là tên của người đàn ông trang; phần cuối cùng .gz viết tắt của một
nén với gzip(1). Như phần không phải là cái đầu tiên nó phải được chỉ định
cũng. Điều này có thể được thực hiện bằng một trong các lệnh sau.
NS# Groffer groff.7
NS# Groffer 7 Groff
NS# Groffer --section = 7 groff

/usr/local/man/man1/ctags.1emacs21.bz2
Đây / usr / local / man phải ở trong người đàn ông con đường; thư mục con man1 / và tên tệp
một phần .1 Là viết tắt của phần 1; tên của người đàn ông trang is ctag; phần có một
mở rộng emacs21; và tệp được nén dưới dạng . Bz2 với bzip2(1). Tệp có thể
được xem bằng một trong các lệnh sau
NS# Groffer ctags.1e
NS# Groffer 1e ctags
NS# Groffer --extension = e --section = 1 ctags
nơi e làm việc là viết tắt của phần mở rộng emacs21.

/usr/man/linux/de/man7/man.7.Z
Cac thu mục / usr / man bây giờ là một phần của người đàn ông con đường; sau đó có một thư mục con
cho một hoạt động hệ thống tên linux /; tiếp theo là một thư mục con de / cho người Đức
Ngôn ngữ; Các phần tên Man7 và .7 được biết đến cho đến nay; người đàn ông là tên của
người đàn ông trang; Và .Z biểu thị quá trình nén có thể được xử lý bằng gzip(1). Chúng tôi muốn
bây giờ chỉ ra cách cung cấp một số giá trị cho một số tùy chọn. Điều đó có thể cho
phần và hoạt động hệ thống những cái tên. Vì vậy, chúng tôi sử dụng như phần 5 và 7 và như hệ thống
tên linux và aix. Lệnh sau đó là

NS# groffer --locale = de --section = 5: 7 --systems = linux, aix man
NS# LANG = de MANSECT = 5: 7 SYSTEM = linux, aix groffer man

GIẢM BỚT SỨC ÉP

Chương trình có một cơ sở giải nén. Nếu đầu vào tiêu chuẩn hoặc một tệp đã được truy xuất
từ các tham số dòng lệnh được nén với định dạng được hỗ trợ bởi
gzip(1) hoặc bzip2(1) nó được giải nén khi đang di chuyển. Điều này bao gồm GNU .gz, . Bz2và
truyền thống .Z nén. Chương trình hiển thị sự kết hợp của tất cả
giải nén đầu vào theo trình tự đã được chỉ định trên dòng lệnh.

MÔI TRƯỜNG

người nói tục chương trình hỗ trợ nhiều biến hệ thống, hầu hết trong số chúng do các biến khác
các chương trình. Tất cả các biến môi trường của sự lộn xộn(1) và GNU người đàn ông(1) và một số hệ thống tiêu chuẩn
các biến được tôn vinh.

Native người nói tục Biến
$ GROFFER_OPT
Lưu trữ các tùy chọn cho một loạt người nói tục. Các tùy chọn được chỉ định trong biến này là
bị ghi đè bởi các tùy chọn được đưa ra trên dòng lệnh. Nội dung của biến này
được chạy qua nội trang shell `eval '; vì vậy các đối số có chứa khoảng trắng hoặc
các ký tự shell đặc biệt nên được trích dẫn. Đừng quên xuất biến này,
nếu không nó không tồn tại trong quá trình chạy người nói tục.

WELFARE Biến
Các biến sau đây có ý nghĩa đặc biệt đối với người nói tục.

$ HIỂN THỊ
Nếu biến này được đặt, điều này chỉ ra rằng hệ thống X Window đang chạy.
Việc kiểm tra biến này quyết định xem đầu ra đồ họa hay văn bản được tạo ra hay không.
Người dùng không nên bất cẩn thay đổi biến này, nhưng nó có thể được sử dụng để
bắt đầu đồ họa người nói tục trên thiết bị đầu cuối X Window từ xa. Ví dụ, tùy thuộc
trên hệ thống của bạn, người nói tục có thể được khởi động trên màn hình thứ hai bằng lệnh

NS# DISPLAY =: 0.1 điều kỳ lạ. Tuy nhiên &

$ LC_ALL
$ LC_MESSAGES
$ LANG Nếu một trong các biến này được đặt (theo trình tự trên), thì nội dung của nó là
được hiểu là miền địa phương, ngôn ngữ được sử dụng, đặc biệt là khi truy xuất
người đàn ông trang. Tên ngôn ngữ thường có dạng
Ngôn ngữ[_lãnh thổ[.bộ mã[@thay đổi]]], ở đâu Ngôn ngữ là một ngôn ngữ ISO 639
mã, lãnh thổ là mã quốc gia ISO 3166 và bộ mã là một bộ ký tự hoặc
mã nhận dạng mã hóa như ISO-8859-1 hoặc UTF-8; Thấy chưa định vị(3). Các giá trị ngôn ngữ
C và POSIX là viết tắt của mặc định, tức là người đàn ông trang thư mục không có ngôn ngữ
tiếp đầu ngữ. Đây là hành vi tương tự như khi cả 3 biến không được đặt.

$ PAGER Biến này có thể được sử dụng để đặt máy nhắn tin cho đầu ra tty. Ví dụ, để
vô hiệu hóa hoàn toàn việc sử dụng máy nhắn tin, đặt biến này thành làm sao(1) chương trình

NS# PAGER = mèo chửi bới bất cứ thứ gì

$ PATH Tất cả các chương trình trong người nói tục script được gọi mà không có đường dẫn cố định. Vì vậy, điều này
biến môi trường xác định tập hợp các chương trình được sử dụng trong quá trình chạy người nói tục.

tiếng kêu Biến
người nói tục lập trình cuộc gọi nội bộ sự lộn xộn, vì vậy tất cả các biến môi trường được ghi lại trong
sự lộn xộn(1) được sử dụng nội bộ trong người nói tục cũng. Biến sau có trực tiếp
ý nghĩa cho người nói tục chương trình.

$ GROFF_TMPDIR
Nếu giá trị của biến này là một thư mục hiện có, có thể ghi, người nói tục sử dụng nó
để lưu trữ các tệp tạm thời của nó, giống như sự lộn xộn làm. Xem sự lộn xộn(1) trang người đàn ông cho
chi tiết hơn về vị trí của các tệp tạm thời.

Đàn ông Biến
Các phần chức năng của người đàn ông chương trình được thực hiện trong người nói tục; hỗ trợ cho tất cả
các biến môi trường được ghi lại trong người đàn ông(1) đã được thêm vào người nói tục, nhưng ý nghĩa là
sửa đổi một chút do cách tiếp cận khác nhau trong người nói tục; nhưng giao diện người dùng là
tương tự. Các người đàn ông các biến môi trường có thể bị ghi đè bởi các tùy chọn được cung cấp với $ MANOPT,
lần lượt bị ghi đè bởi dòng lệnh.

PHẦN MỞ RỘNG $
Hạn chế tìm kiếm người đàn ông trang cho các tệp có phần mở rộng này. Đây là
bị ghi đè bởi tùy chọn --gia hạn; xem ở đó để biết chi tiết.

$ MANOPT
Biến này chứa các tùy chọn dưới dạng giá trị đặt trước cho người đàn ông(1). Vì không phải tất cả những thứ này đều
có liên quan tới người nói tục chỉ những phần thiết yếu của giá trị của nó được chiết xuất. Các
các tùy chọn được chỉ định trong biến này sẽ ghi đè các giá trị của môi trường khác
các biến cụ thể cho người đàn ông. Tất cả các tùy chọn được chỉ định trong biến này là
bị ghi đè bởi các tùy chọn được đưa ra trên dòng lệnh.

$ MANPATH
Nếu được đặt, biến này chứa các thư mục trong đó người đàn ông trang nhiều cái cây là
được lưu trữ. Điều này được ghi đè bởi tùy chọn --manpath.

$ MANSECT
Nếu đây là danh sách tên phần được phân tách bằng dấu hai chấm, thì việc tìm kiếm người đàn ông trang is
bị hạn chế đối với các phần thủ công theo thứ tự đó. Điều này được ghi đè bởi tùy chọn
- phần.

HỆ THỐNG $
Nếu điều này được đặt thành một danh sách tên được phân tách bằng dấu phẩy, chúng được hiểu là người đàn ông trang
cây cho các hệ điều hành khác nhau. Biến này có thể được ghi đè bởi tùy chọn
--hệ thống; xem ở đó để biết chi tiết.

Biến môi trường $ MANROFFSEQ bị bỏ qua bởi người nói tục bởi vì cần thiết
bộ tiền xử lý được xác định tự động.

CẤU HÌNH CÁC TẬP TIN

người nói tục chương trình có thể được cấu hình trước bởi hai tệp cấu hình.

/etc/groff/groffer.conf
Tệp cấu hình toàn hệ thống cho người nói tục.

$ HOME / .groff / groffer.conf
Tệp cấu hình dành riêng cho người dùng cho người nói tục, Nơi $ HOME biểu thị nhà của người dùng
danh mục. Tệp này được gọi sau tệp cấu hình toàn hệ thống để kích hoạt
ghi đè bởi người dùng.

Cả hai tệp đều được xử lý cho cấu hình, nhưng tệp cấu hình trong / Etc đến
đầu tiên; nó bị ghi đè bởi tệp cấu hình trong thư mục chính; cả hai
các tệp cấu hình bị ghi đè bởi biến môi trường $ GROFFER_OPT; mọi điều
bị ghi đè bởi các đối số dòng lệnh.

Các tệp cấu hình chứa các tùy chọn sẽ được gọi là mặc định cho mọi người nói tục
chạy. Các tùy chọn này được viết thành các dòng sao cho mỗi dòng chứa một tùy chọn dài,
tùy chọn ngắn, hoặc một cụm tùy chọn ngắn; từng có hoặc không có đối số. Vì vậy, mỗi dòng
với thông tin cấu hình bắt đầu bằng ký tự trừ '-'; một dòng dài
tùy chọn bắt đầu bằng hai ký tự trừ '--', một dòng với một tùy chọn ngắn hoặc tùy chọn ngắn
cụm bắt đầu bằng một dấu trừ duy nhất-'.

Tên tùy chọn trong tệp cấu hình không được viết tắt, chúng phải chính xác.

Đối số cho một tùy chọn dài có thể được phân tách khỏi tên tùy chọn bằng một dấu
ký tên='hoặc bởi khoảng trắng, tức là một hoặc một số dấu cách hoặc ký tự tab. Một đối số cho một
tùy chọn ngắn hoặc cụm tùy chọn ngắn có thể được nối trực tiếp vào tên tùy chọn hoặc
ngăn cách nhau bởi khoảng trắng. Phần cuối của một đối số là phần cuối của dòng. Không phải vậy
được phép sử dụng một biến môi trường shell trong tên tùy chọn hoặc đối số.

Không nhất thiết phải sử dụng dấu ngoặc kép trong một tùy chọn hoặc đối số, ngoại trừ các đối số trống.
Một đối số trống có thể được cung cấp bằng cách thêm một cặp dấu ngoặc kép vào dấu phân tách bằng
dấu hoặc khoảng trắng; với một tùy chọn ngắn, dấu phân tách cũng có thể được bỏ qua. Một thời gian dài
tùy chọn có dấu bằng phân cách '=', cặp dấu ngoặc kép có thể được bỏ qua, do đó kết thúc
dòng có dấu bằng phân cách. Tất cả các ký tự trích dẫn khác đều bị hủy
nội bộ

Trong tệp cấu hình, cho phép khoảng trắng tùy ý ở đầu mỗi dòng,
nó chỉ bị bỏ qua. Mỗi khoảng trắng trong một dòng được thay thế bằng một ký tự khoảng trắng
'' trong nội bộ.

Tất cả các dòng của dòng cấu hình không bắt đầu bằng ký tự trừ đều bị bỏ qua,
sao cho các nhận xét bắt đầu bằng `#'có thể. Vì vậy, không có lệnh shell nào trong
tập tin cấu hình.

Ví dụ: hãy xem xét tệp cấu hình sau có thể được sử dụng trong
/etc/groff/groffer.conf or ~ / .groff / groffer.conf .

# tệp cấu hình Groffer
#
# tùy chọn Groffer được sử dụng trong mỗi lần gọi của Groffer
--foreground = DarkBlue
- độ phân giải = 100
--viewer = gxditview -geometry 900x1200
--người xem xpdf -Z 150

Các dòng bắt đầu bằng # chỉ bị bỏ qua, vì vậy chúng hoạt động như các dòng lệnh. Cái này
cấu hình bộ bốn người nói tục các tùy chọn (các dòng bắt đầu bằng `-'). Điều này có
các hiệu ứng sau:

* Sử dụng màu văn bản của Xanh đậm trong tất cả những người xem ủng hộ điều này, chẳng hạn như gxditview.

* Sử dụng độ phân giải của 100dpi trong tất cả những người xem ủng hộ điều này, chẳng hạn như gxditview. Qua
cái này, thiết bị mặc định trong x chế độ được thiết lập để X100.

* Lực lượng gxditview(1) như chế độ x người xem sử dụng tùy chọn hình học để thiết lập chiều rộng
đến 900px và chiều cao để 1200px. Hình dạng này phù hợp với độ phân giải của
100dpi.

* Sử dụng xpdf(1) như chế độ pdf người xem tranh luận -Z 150.

VÍ DỤ

Việc sử dụng người nói tục là rất dễ dàng. Thông thường, nó chỉ được gọi với tên tệp hoặc
người đàn ông trang. Tuy nhiên, các ví dụ sau đây cho thấy rằng người nói tục có nhiều ưa thích hơn
khả năng.

NS# groffer /usr/local/share/doc/groff/meintro.ms.gz

Giải nén, định dạng và hiển thị tệp nén meintro.ms.gz trong danh bạ
/ usr / local / share / doc / groff, sử dụng trình xem tiêu chuẩn gxditview với tư cách là người xem đồ họa khi
trong X Window, hoặc ít(1) chương trình máy nhắn tin khi không ở trong X Window.

NS# Groffer groff

Nếu tệp ./groff tồn tại sử dụng nó làm đầu vào. Nếu không, hãy diễn giải đối số dưới dạng một tìm kiếm
cho người đàn ông trang tên sự lộn xộn trong điều kiện nhỏ nhất có thể người đàn ông phần, là phần 1 trong này
trường hợp.

NS# người đàn ông Groffer: Groff

tìm kiếm người đàn ông trang of sự lộn xộn ngay cả khi tệp ./groff tồn tại.

NS# Groffer groff.7
NS# Groffer 7 Groff

tìm kiếm người đàn ông trang of sự lộn xộn in người đàn ông phần 7. Tìm kiếm phần này chỉ hoạt động cho một chữ số
hoặc một ký tự từ một tập hợp nhỏ.

NS# Groffer fb.modes

Nếu tệp ./fb.modes không tồn tại, giải thích điều này là một tìm kiếm cho người đàn ông trang of
fb.modes. Là phần mở rộng chế độ không phải là một ký tự đơn lẻ trong phong cách phần cổ điển
đối số không được chia thành tìm kiếm fb.

NS# Groffer groff 'troff(1) 'man: roff

Các đối số không phải là tệp hiện có được tra cứu như sau người đàn ông trang: sự lộn xộn
(tìm kiếm tự động, nên được tìm thấy trong người đàn ông Phần 1), troff (trong phần 1), và sự đùa giỡn (Trong
phần có số lượng thấp nhất, là 7 trong trường hợp này). Các trích dẫn xung quanh 'troff(1) '
là cần thiết vì dấu ngoặc đơn là các ký tự shell đặc biệt; thoát khỏi họ bằng một
ký tự gạch chéo ngược \( và \) cũng sẽ có thể. Các tệp được định dạng là
nối và hiển thị trong một mảnh.

NS# LANG = de groffer --man --viewer = galeon ls

Lấy tiếng Đức người đàn ông trang (ngôn ngữ de) cho ls chương trình, giải nén nó, định dạng nó thành
html định dạng (www chế độ) và xem kết quả trong trình duyệt web Galeon. Các tùy chọn --Đàn ông
đảm bảo rằng người đàn ông trang được truy xuất, ngay cả khi một tệp cục bộ ls tồn tại trong thực tế
thư mục.

NS# Groffer - nguồn 'người đàn ông:sự đùa giỡn(7)

Nhận được người đàn ông trang gọi là sự đùa giỡn in người đàn ông phần 7, giải nén nó và in nó chưa được định dạng
nội dung, mã nguồn của nó.

NS# Groffer --de-p --in --ap

Đây là một tập hợp các đối số viết tắt, nó được xác định là

NS# groffer --debug-params --inter Instant-output --apropos

NS# cat file.gz | Groffer -Z -mfoo

Tập tin tập tin.gz được gửi đến đầu vào tiêu chuẩn, điều này được giải nén, và sau đó đây là
vận chuyển đến sự lộn xộn trung gian đầu ra chế độ mà không cần xử lý hậu kỳ (sự lộn xộn tùy chọn
-Z), sử dụng gói macro foo (sự lộn xộn tùy chọn -m).

NS# echo '\ f [CB] WOW! " |
> Groffer --x --bg đỏ --fg vàng - kích thước 200x100 -

Hiển thị từ WOW! trong một cửa sổ nhỏ với phông chữ đậm có chiều rộng không đổi, sử dụng màu vàng trên
nền đỏ.

Tương thích

người nói tục chương trình được viết bằng Perl, phiên bản Perl trong quá trình viết là v5.8.8.

người nói tục cung cấp trình phân tích cú pháp riêng cho các đối số dòng lệnh tương thích với cả hai
POSIX getopt(1) và GNU nhận được(1). Nó có thể xử lý các đối số tùy chọn và tên tệp
chứa khoảng trắng và một tập hợp lớn các ký tự đặc biệt. Tiêu chuẩn sau
các loại tùy chọn được hỗ trợ.

* Tùy chọn bao gồm một dấu trừ duy nhất - đề cập đến đầu vào tiêu chuẩn.

* Một dấu trừ duy nhất theo sau là các ký tự đề cập đến một tùy chọn ký tự đơn hoặc một
sự kết hợp của chúng; ví dụ, người nói tục kết hợp tùy chọn ngắn -Qmfoo is
tương đương với -Q -m foo.

* Tùy chọn dài là tùy chọn có tên dài hơn một ký tự; họ luôn luôn đứng trước
bằng một trừ đôi. Một đối số tùy chọn có thể chuyển đến đối số dòng lệnh tiếp theo
hoặc được thêm dấu bằng vào đối số; Ví dụ, --long = arg là tương đương
đến --Dài arg.

* Một lập luận của -- kết thúc phân tích cú pháp tùy chọn; tất cả các đối số dòng lệnh khác là
được dịch là thông số tập tin tham số, tức là tên tệp hoặc cấu trúc để tìm kiếm
người đàn ông trang).

* Tất cả các đối số dòng lệnh không phải là tùy chọn hoặc đối số tùy chọn đều được diễn giải
as thông số tập tin và được lưu trữ cho đến khi quá trình phân tích cú pháp tùy chọn kết thúc. Ví dụ,
dòng lệnh

NS# Groffer file1 -a -o arg file2

tương đương với

NS# Groffer -a -o arg - file1 file2

Sự pha trộn miễn phí của các tùy chọn và thông số tập tin các tham số tuân theo nguyên tắc GNU. Điều đó có
không thực hiện hành vi tùy chọn kỳ lạ của POSIX. Điều này sẽ kết thúc quá trình xử lý tùy chọn ngay khi
đã đạt đến đối số không phải tùy chọn đầu tiên. Sự kết thúc của quá trình xử lý tùy chọn có thể là
buộc bởi tùy chọn--' dù sao.

Sử dụng Groffer trực tuyến bằng các dịch vụ onworks.net