groffer - Online di Cloud

PROGRAM:

NAMA

groffer - menampilkan file groff dan halaman manual di X dan tty

RINGKASAN

penggerutu [--] [spesifikasi file ....]

penggerutu [opsi mode ....] [opsi groff ....] [opsi pria ....] [Opsi-X ....]
[--] [spesifikasi file ....]

penggerutu -h | --membantu

penggerutu -v | --Versi: kapan

DESKRIPSI

penggerutu program adalah cara termudah untuk digunakan kasar(1). Itu dapat menampilkan sewenang-wenang
dokumen tertulis dalam kasar bahasa, lihat kasar(7), atau lainnya roff bahasa, lihat
roff(7), yang kompatibel dengan aslinya troff bahasa. Ia menemukan dan menjalankan semua
perlu kasar praprosesor, seperti: Kimia.

penggerutu program juga mencakup banyak fitur untuk menemukan dan menampilkan Unix
halaman manual (pria halaman), sehingga dapat digunakan sebagai pengganti a pria(1) program.
Selain itu, file terkompresi yang dapat ditangani oleh gzip(1) atau bzip2(1) didekompresi pada-
lalat.

Penggunaan normal cukup sederhana dengan memberikan nama file atau nama a pria halaman tanpa
pilihan lebih lanjut. Tetapi penanganan opsi memiliki banyak kemungkinan untuk membuat spesial
perilaku. Ini dapat dilakukan baik dalam file konfigurasi, dengan lingkungan shell
variabel $GROFFER_OPT, atau di baris perintah.

Output dapat dihasilkan dan dilihat dalam beberapa cara berbeda yang tersedia untuk kasar.
Ini termasuk kasar penampil X Window asli tampilan gxdit(masing-masing 1 Postkrip, pdf, atau Dvi
program tampilan, browser web dengan menghasilkan html in www mode, atau beberapa teks mode in
terminal teks.

Sebagian besar opsi yang harus diberi nama saat dijalankan kasar langsung ditentukan
secara otomatis untuk penggerutu, karena penggunaan internal dari minuman keras(1) program. Tapi semua
bagian juga dapat dikontrol secara manual dengan argumen.

Beberapa nama file dapat ditentukan pada argumen baris perintah. Mereka berubah
menjadi satu dokumen dengan cara biasa kasar.

Penanganan opsi dilakukan dalam gaya GNU. Pilihan dan nama file dapat dicampur secara bebas. Itu
pilihan `--' menutup penanganan opsi, semua argumen berikut diperlakukan sebagai nama file.
Opsi panjang dapat disingkat dalam beberapa cara.

PILIHAN GAMBARAN

melanggar Pilihan

[-h | --membantu] [-v | --Versi: kapan]

penggerutu mode Pilihan

[--mobil] [--bawaan] [--mode-default mode1, mode2, ....] [--dvi] [--groff]
[--html] [--latin1] [--mode mode tampilan] [--pdf] [--pdf2] [--ps] [--sumber]
[--teks] [--ke-stdout] [--tty] [--utf8] [--penonton prog] [--www] [--X | --X]

Pilihan terkait untuk kasar

[-T | --perangkat alat] [-Z | --keluaran menengah | --ditroff]

Selanjutnya kasar opsi pendek diterima.

Pilihan untuk pria halaman

[--tepat] [--apropos-data] [--apropos-berkembang] [--apropos-prog] [--pria]
[--tidak ada laki-laki] [--tidak-khusus] [--apa yang]

panjang Pilihan diambil lebih dari GNU pria

[--semua] [--ascii] [--ditroff] [--perpanjangan akhiran] [--lokal bahasa]
[--file-lokal] [--lokasi | --di mana] [--jalur manusia dir1:dir2: ....] [--tidak ada lokasi]
[--halaman program] [--bagian detik1:detik2:....] [--sistem sys1, sys2, ....]
[--troff-perangkat alat]

Opsi panjang lebih lanjut dari GNU pria diterima juga.

X Jendela Toolkit Pilihan

[--bd | --warna batas piksel] [--bg | --Latar Belakang warna]
[--bw | --lebar batas piksel] [--menampilkan tampilan X] [--fg | --latar depan warna]
[--fn | --kaki | --font nama_font] [--geometri ukuran_pos] [--resolusi nilai] [--rv]
[--judul string] [--xrm sumber daya X]

Pilihan untuk pengembangan

[--debug] [--debug-nama file] [--debug-grog] [--debug-simpan] [--debug-params]
[--debug-tmpdir] [--tidak melakukan apapun] [--mencetak teks] [-V]

spesifikasi file argumen

spesifikasi file parameter adalah semua argumen yang bukan merupakan opsi atau opsi
argumen. Mereka biasanya berarti nama file atau pria halaman skema pencarian.

Berikut ini adalah istilah bagian_ekstensi digunakan. Itu berarti sebuah kata yang
terdiri dari pria bagian yang secara opsional diikuti oleh perpanjangan. Nama dari
a pria bagian adalah karakter tunggal dari [1–9 pada], yang perpanjangan adalah beberapa kata. Itu
perpanjangan sebagian besar kurang.

Tidak spesifikasi file parameter berarti input standar.

- singkatan dari input standar (dapat terjadi beberapa kali).

nama file nama path dari file yang ada.

man:nama(bagian_ekstensi)
man:nama.bagian_ekstensi
nama(bagian_ekstensi)
nama.bagian_ekstensi
bagian_ekstensi nama
cari halaman manual nama di bagian dengan ekstensi opsional
bagian_ekstensi.

man:nama halaman manual di paling bawah pria bagian yang memiliki nama.

nama if nama bukan pencarian file yang ada untuk halaman manual nama dalam
bagian pria terendah.

PILIHAN RINCIAN

penggerutu program biasanya dapat dijalankan dengan pilihan yang sangat sedikit. Tetapi untuk tujuan khusus,
mendukung banyak pilihan. Ini dapat diklasifikasikan dalam 5 kelas opsi.

Semua opsi singkat dari penggerutu kompatibel dengan opsi pendek dari kasar(1). Selamanya
pilihan dari penggerutu kompatibel dengan opsi panjang pria(1).

Argumen untuk nama opsi yang panjang dapat disingkat dalam beberapa cara. Pertama, argumen
diperiksa apakah dapat diperpanjang apa adanya. Selanjutnya, setiap tanda minus - is
dianggap sebagai titik awal untuk singkatan baru. Ini mengarah ke satu set multiple
singkatan untuk satu argumen. Sebagai contoh, --de-nf dapat digunakan sebagai singkatan
untuk --debug-tidak-berfungsi, tapi --sarang bekerja juga. Jika singkatan dari argumen mengarah
untuk beberapa pilihan yang dihasilkan kesalahan dimunculkan.

Singkatan ini hanya diperbolehkan dalam variabel lingkungan $GROFFER_OPT, tapi tidak di
file-file konfigurasi. Dalam konfigurasi, semua opsi panjang harus tepat.

penggerutu melanggar Opsi
Segera setelah salah satu opsi ini ditemukan di baris perintah, opsi tersebut akan dieksekusi, dicetak ke
keluaran standar, dan berjalan penggerutu diakhiri setelahnya. Semua argumen lainnya
diabaikan.

-h | --membantu
Cetak informasi bantuan dengan penjelasan singkat tentang opsi untuk keluaran standar.

-v | --Versi: kapan
Cetak informasi versi ke output standar.

penggerutu mode Opsi
Mode tampilan dan program penampil ditentukan oleh opsi ini. Jika tidak ada
mode dan opsi penampil ini ditentukan penggerutu mencoba menemukan mode tampilan yang sesuai
secara otomatis. Mode default adalah mode pdf, mode ps, mode html, mode x, dan mode Dvi
di X Window dengan pemirsa yang berbeda dan mode tty dengan perangkat utf8 bawah kurang di terminal;
mode lain diuji jika program untuk mode default utama tidak ada.

Di X Window, banyak program membuat jendela sendiri saat dipanggil. penggerutu dapat menjalankan ini
pemirsa sebagai program independen di latar belakang. Karena ini tidak berfungsi dalam mode teks
pada terminal (tty) harus ada cara untuk mengetahui pemirsa mana yang grafis X Window
program. NS penggerutu skrip memiliki sekumpulan kecil informasi tentang beberapa nama pemirsa. Jika sebuah
argumen penampil dari baris perintah memilih elemen yang disimpan sebagai program X Window di
daftar ini diperlakukan sebagai penampil yang dapat berjalan di latar belakang. Semua lainnya, tidak diketahui
panggilan pemirsa tidak berjalan di latar belakang.

Untuk setiap mode, Anda bebas memilih penampil apa pun yang Anda inginkan. Itu tidak perlu beberapa
penampil grafis yang cocok untuk mode ini. Ada kesempatan untuk melihat sumber keluaran; untuk
contoh, kombinasi opsi --mode=ps dan --penonton=kurang menunjukkan isi dari
itu Nota bene output, kode sumber, dengan pager kurang.

--mobil Setara dengan --mode=otomatis.

--bawaan
Atur ulang semua konfigurasi dari opsi baris perintah yang diproses sebelumnya ke
nilai dasar. Ini berguna untuk menghapus semua opsi sebelumnya dari
konfigurasi, dalam $GROFFER_OPT, dan mulai ulang pemrosesan opsi hanya menggunakan sisanya
dari baris perintah.

--mode-default mode1, mode2, ....
Atur urutan mode untuk mobil mode ke daftar yang dipisahkan koma yang diberikan dalam
argumen. Lihat --mode untuk detail tentang mode. Tampilkan dengan cara default;
sebenarnya, ini berarti mencoba mode x, ps, dan tty dalam urutan ini.

--dvi Setara dengan --mode=dvi.
--penonton prog
Pilih program pemirsa untuk Dvi mode. Ini bisa berupa nama file atau program yang akan
mencari di $ PATH. Dikenal X Window Dvi pemirsa termasuk xdvi(1) dan dvilx(1). Di
setiap kasus, argumen dapat diberikan tambahan.

--groff
Setara dengan --mode=groff.

--html Setara dengan --mode=html.
--penonton
Pilih program browser web untuk dilihat di html mode. Itu bisa menjadi nama jalur
file yang dapat dieksekusi atau program di $ PATH. Dalam setiap kasus, argumen dapat diberikan
sebagai tambahan.

--mode nilai
Mengatur mode tampilan. Nilai mode berikut dikenali:

mobil Pilih penentuan otomatis mode tampilan. Urutan dari
mode yang dicoba dapat diatur dengan --mode-default pilihan. Berguna untuk
memulihkan kegagalan mode ketika mode yang berbeda ditentukan sebelumnya.

Dvi Tampilkan input yang diformat dalam a Dvi program pemirsa. Secara default, format
masukan ditampilkan dengan xdvi(1) program.

kasar Setelah penentuan file, alihkan penggerutu untuk memproses input seperti
kasar(1) akan dilakukan. Ini menonaktifkan penggerutu melihat fitur.

html Terjemahkan input ke dalam format html dan tampilkan hasilnya di browser web
program. Secara default, keberadaan urutan browser web standar
diuji, dimulai dengan penakluk(1) dan mozilla(1). Penampil html teks
is lynx(1).

pdf Mengubah roff memasukkan arsip menjadi PDF fillet dengan menggunakan kasar (1) alat
-tpdf. Ini defaultnya PDF generator. yang dihasilkan PDF fillet is
ditampilkan dengan program pemirsa yang sesuai, seperti okular(1).

pdf2 Ini tradisional pdf mode. Terkadang mode ini menghasilkan lebih banyak yang benar
keluaran dari default PDF mode. Secara default, input diformat oleh
kasar menggunakan perangkat Postscript, kemudian diubah menjadi file PDF
format menggunakan gs(1), atau ps2pdf(1). Jika itu tidak mungkin, Nota bene
mode (ps) digunakan sebagai gantinya. Akhirnya ditampilkan menggunakan penampil yang berbeda
program.

ps Tampilkan input yang diformat dalam program penampil Postscript. Secara default,
input yang diformat ditampilkan di salah satu dari banyak program penampil.

teks Format dalam kasar teks mode dan tulis hasilnya ke output standar tanpa
program pager atau penampil. Perangkat teks, latin1 secara default, bisa
dipilih dengan opsi -T.

tty Format dalam kasar teks mode dan tulis hasilnya ke output standar menggunakan a
program pager teks, bahkan ketika di X Window.

www Setara dengan --mode=html.

x Tampilkan input yang diformat dalam bahasa asli roff penonton. Secara default,
input yang diformat ditampilkan dengan tampilan gxdit(1) program sedang didistribusikan
Bersama kasar. Tapi alat X Window standar tampilan xdit(1) bisa juga
dipilih dengan opsi --penonton. Resolusi default adalah 75dpi, tapi
100dpi juga mungkin. Standarnya kasar perangkat untuk resolusi
75dpi is X75-12, Untuk 100dpi ini X100. Yang sesuai kasar
menengah keluaran untuk perangkat yang sebenarnya dihasilkan dan hasilnya adalah
ditampilkan. Untuk resolusi 100dpi, lebar default geometri dari
program tampilan dipilih untuk 850dpi.

X Setara dengan --mode=x.

Mode berikut tidak menggunakan penggerutu melihat fitur. Mereka hanya
menarik untuk aplikasi tingkat lanjut.

kasar Hasilkan keluaran perangkat dengan polos kasar tanpa menggunakan tampilan khusus
fitur dari penggerutu. Jika tidak ada perangkat yang ditentukan oleh opsi -T itu kasar
kegagalan ps diasumsikan.

sumber Keluarkan kode sumber roff dari file input tanpa pemrosesan lebih lanjut.

--pdf Setara dengan --mode=pdf.
--pdf2 Setara dengan --mode=pdf2.
--penonton prog
Pilih program pemirsa untuk pdf mode. Ini bisa berupa nama file atau program yang akan
mencari di $ PATH; argumen dapat diberikan tambahan.

--ps Setara dengan --mode=ps.
--penonton prog
Pilih program pemirsa untuk ps mode. Ini bisa berupa nama file atau program yang akan
mencari di $ PATH. Pemirsa Postscript umum termasuk okular(1) memperlihatkan(1) gv(1)
pemandangan hantu(1), dan gs(1), Dalam setiap kasus, argumen dapat diberikan tambahan.

--sumber
Setara dengan --mode=sumber.

--teks Setara dengan --mode=teks.

--ke-stdout
File untuk mode yang dipilih dihasilkan dan isinya dicetak ke standar
keluaran. Ini tidak akan ditampilkan dalam mode grafis.

--tty Setara dengan --mode=tty.
--penonton prog
Pilih pager teks untuk mode tty. Pager standar adalah kurang(1). Pilihan ini adalah
setara dengan pria Option --halaman=prog. Argumen opsi dapat berupa nama file atau
program yang akan dicari $ PATH; argumen dapat diberikan tambahan.

--www Setara dengan --mode=html.
--penonton
prog.

--X | --X
Setara dengan --mode=x.
--penonton prog
Pilih program pemirsa untuk x mode. Program pemirsa yang cocok adalah tampilan gxdit(1)
yang merupakan default dan tampilan xdit(1). Argumen dapat berupa file yang dapat dieksekusi atau a
program di $ PATH; argumen dapat diberikan tambahan.

-- Memberi tanda akhir dari pemrosesan opsi; semua argumen yang tersisa ditafsirkan sebagai
spesifikasi file parameter.

Selain ini, penggerutu menerima semua opsi pendek yang valid untuk kasar(1) program.
Semua non-penggerutu opsi dikirim tanpa dimodifikasi melalui minuman keras untuk kasar. Jadi pascaprosesor, makro
paket, kompatibilitas dengan klasik troff, dan banyak lagi yang dapat ditentukan secara manual.

Opsi terkait untuk kasar
Semua opsi singkat dari penggerutu kompatibel dengan opsi pendek dari kasar(1). Itu
mengikuti dari kasar pilihan memiliki arti khusus tambahan di dalam penggerutu or
masuk akal untuk penggunaan normal.

Karena perilaku keluaran khusus dari kasar Option -Z penggerutu dirancang untuk
diubah menjadi kasar mode; itu penggerutu fitur melihat dinonaktifkan di sana. Yang lain
kasar opsi tidak mengganti mode, tetapi memungkinkan untuk menyesuaikan proses pemformatan.

--Sebuah Ini menghasilkan perkiraan ascii dari output dalam teks mode. Itu bisa jadi
penting ketika pager teks memiliki masalah dengan urutan kontrol di tty mode.

--M fillet
Add fillet sebagai kasar berkas makro. Ini berguna jika tidak dapat dikenali
otomatis.

--P pilih_atau_arg
Kirim argumennya pilih_atau_arg sebagai opsi atau argumen opsi ke yang sebenarnya kasar
pascaprosesor.

--T nama pengembang | --perangkat nama pengembang
Pilihan ini menentukan kasarperangkat keluaran. Perangkat yang paling penting adalah
perangkat output teks untuk merujuk ke set karakter yang berbeda, seperti ascii,
utf8, latin1, utf8, dan lain-lain. Masing-masing argumen ini beralih penggerutu menjadi
teks mode menggunakan perangkat ini, untuk mode tty jika mode sebenarnya bukan a teks mode.
Berikut ini nama pengembang argumen dipetakan ke yang sesuai penggerutu
--modus=nama pengembang opsi: Dvi, html, dan ps. Semua X* argumen dipetakan ke mode x.
Satu sama lain nama pengembang argumen beralih ke mode kasar menggunakan perangkat ini.

--X adalah setara dengan kasar -X. Ini menampilkan kasar menengah keluaran dengan
tampilan gxdit. Karena kualitasnya relatif buruk, opsi ini tidak digunakan lagi; menggunakan --X
sebagai gantinya karena x mode menggunakan X* perangkat untuk tampilan yang lebih baik.

-Z | --keluaran menengah | --ditroff
Beralih ke kasar mode dan format input dengan kasar menengah keluaran
tanpa pasca-pemrosesan; melihat groff_out(5). Ini setara dengan opsi --ditroff
of pria, yang dapat digunakan juga.

Semua lainnya kasar pilihan didukung oleh penggerutu, tetapi mereka hanya transparan
ditransfer ke kasar tanpa intervensi apapun. Opsi yang tidak secara eksplisit
ditangani oleh penggerutu secara transparan diteruskan ke kasar. Oleh karena itu opsi transparan ini
tidak didokumentasikan di sini, tetapi di kasar(1). Karena otomatisme dalam penggerutu, tidak satupun
kasar opsi harus diperlukan, kecuali untuk penggunaan lanjutan.

Opsi untuk pria halaman
--tepat
Memulai tepat(1) perintah atau fasilitas dari pria(1) untuk mencari spesifikasi file
argumen dalam semua pria halaman deskripsi. Setiap spesifikasi file argumen diambil untuk
cari apa adanya; bagian bagian tertentu tidak ditangani, sehingga 7 kasar pencarian
untuk dua argumen 7 dan kasar, dengan hasil yang besar; Untuk spesifikasi file kasar.7
tidak ada yang akan ditemukan. Itu bahasa lokal ditangani hanya ketika dipanggil
program memang mendukung ini; GNU tepat dan pria -k tidak. Tampilannya berbeda
dari tepat program dengan konsep berikut:

* Bangun a kasar bingkai mirip dengan pria halaman untuk keluaran dari tepat,

* setiap spesifikasi file argumen dicari sendiri.

* Pembatasan oleh --bagian ditangani juga,

* karakter wildcard diizinkan dan ditangani tanpa opsi lebih lanjut.

--apropos-data
Tampilkan hanya tepat deskripsi untuk dokumen data, ini adalah pria(7)
bagian 4, 5, dan 7. Langsung bagian deklarasi diabaikan, wildcard adalah
diterima.

--apropos-berkembang
Tampilkan hanya tepat deskripsi untuk dokumen pengembangan, ini adalah pria(7)
bagian 2, 3, dan 9. Langsung bagian deklarasi diabaikan, wildcard adalah
diterima.

--apropos-prog
Tampilkan hanya tepat deskripsi untuk dokumen pada program, ini adalah: pria(7)
bagian 1, 6, dan 8. Langsung bagian deklarasi diabaikan, wildcard adalah
diterima.

--apa yang
Untuk setiap spesifikasi file cari argumen semua pria halaman dan tampilkan deskripsinya — atau
katakan itu bukan pria halaman. Ini ditulis dari yang baru, jadi ini berbeda dari pria's
apa yang output dengan konsep-konsep berikut:

* setiap nama file yang diambil ditambahkan,

* file lokal juga ditangani,

* itu bahasa dan sistem lokal didukung,

* tampilan dibingkai oleh a kasar format keluaran mirip dengan a pria halaman,

* karakter wildcard diperbolehkan tanpa opsi lebih lanjut.

Opsi berikut ditambahkan ke penggerutu untuk memilih apakah argumen nama file
ditafsirkan sebagai nama untuk file lokal atau sebagai pola pencarian untuk pria halaman. itu
default sedang mencari file lokal.

--pria Periksa argumen baris perintah non-opsi (spesifikasi file) pertama menjadi pria halaman,
lalu apakah mereka mewakili file yang ada. Secara default, spesifikasi file adalah yang pertama
diuji apakah itu file yang sudah ada.

--tidak ada laki-laki | --file-lokal
Jangan periksa pria halaman. --file-lokal adalah yang sesuai pria .

--tidak-khusus
Nonaktifkan panggilan sebelumnya dari --semua, --tepat*, dan --apa yang.

Panjang Pilihan diambil lebih dari GNU pria
Pilihan panjang dari penggerutu disinkronkan dengan opsi panjang GNU pria. Selamanya
pilihan GNU pria dikenali, tetapi tidak semua opsi ini penting untuk penggerutu,
sehingga kebanyakan dari mereka diabaikan begitu saja. Ini diabaikan pria pilihannya adalah --manusia kucing, --troff, dan
--memperbarui.

Berikut ini, pria pilihan yang memiliki arti khusus untuk penggerutu didokumentasikan.

Jika sistem Anda memiliki GNU pria menginstal set lengkap opsi panjang dan pendek GNU pria
program dapat diteruskan melalui variabel lingkungan $MANOPT; Lihat pria(1).

--semua dalam mencari pria halaman, ambil semua dokumen yang sesuai, bukan hanya satu.

-7 | --ascii
In teks mode, tampilkan terjemahan ASCII karakter khusus untuk kritis
lingkungan. Ini setara dengan kasar -mtty_char; Lihat groff_tmac(5).

--ditroff
Menghasilkan kasar menengah keluaran. Ini sama dengan penggerutu -Z.

--perpanjangan akhiran
membatasi pria halaman cari ke nama file yang memiliki akhiran ditambahkan ke bagian mereka
elemen. Misalnya, dalam nama file /usr/share/man/man3/terminfo.3ncurses.gz
itu pria halaman ekstensi adalah kutukan.

--lokal bahasa
Setel bahasa untuk pria halaman. Ini memiliki efek yang sama, tetapi menimpa $LANG.

--lokasi
Cetak lokasi file yang diambil ke kesalahan standar.

--tidak ada lokasi
Jangan tampilkan lokasi file yang diambil; ini mengatur ulang panggilan sebelumnya ke
--lokasi. Ini ditambahkan oleh penggerutu.

--jalur manusia 'dir1:dir2:....'
Gunakan jalur pencarian yang ditentukan untuk mengambil pria halaman bukannya program
default. Jika argumen disetel ke string kosong "" pencarian untuk pria halaman is
dengan disabilitas.

--halaman
Atur program pager di tty mode; defaultnya adalah kurang. Ini dapat diatur dengan --penonton.

--bagian detik1:detik2:....
Batasi pencarian pria halaman kepada yang diberikan bagian, daftar yang dipisahkan titik dua.

--sistem sys1, sys2, ....
Pencarian untuk pria halaman untuk sistem operasi yang diberikan; argumen sistem adalah
daftar yang dipisahkan koma.

--di mana
Setara dengan --lokasi.

X Jendela Toolkit Opsi
Opsi panjang berikut ini diadaptasi dari opsi X Window Toolkit yang sesuai.
penggerutu akan meneruskannya ke program penampil yang sebenarnya jika itu adalah program X Window.
Jika tidak, opsi ini diabaikan.

Sayangnya opsi ini menggunakan gaya lama minus tunggal untuk opsi panjang. Untuk
penggerutu yang diubah ke standar dengan menggunakan minus ganda untuk opsi panjang, untuk
contoh, penggerutu menggunakan opsi --font untuk opsi X Window -font.

Lihat X(7) dan dokumentasi pada opsi X Window Toolkit untuk detail lebih lanjut tentang ini
pilihan dan argumennya.

--Latar Belakang warna
Mengatur warna latar belakang jendela penampil.

--bd piksel
Ini setara dengan --warna batas.

--bg warna
Ini setara dengan --Latar Belakang.

--bw piksel
Ini setara dengan --lebar batas.

--warna batas piksel
Menentukan warna batas yang mengelilingi jendela penampil.

--lebar batas piksel
Menentukan lebar dalam piksel batas yang mengelilingi jendela penampil.

--menampilkan tampilan X
Atur tampilan X Window di mana program penampil akan dimulai, lihat:
Dokumentasi X Window untuk sintaks argumen.

--latar depan warna
Atur warna latar depan jendela penampil.

--fg warna
Ini setara dengan --latar depan.

--fn nama_font
Ini setara dengan --font.

--font nama_font
Atur font yang digunakan oleh jendela penampil. Argumennya adalah nama font X Window.

--kaki nama_font
Ini setara dengan --font.

--geometri ukuran_pos
Atur geometri jendela tampilan, itu berarti ukurannya dan awalnya
posisi. Melihat X(7) untuk sintaks argumen.

--resolusi nilai
Atur resolusi X Window dalam dpi (dots per inch) di beberapa program penampil. Satu-satunya
nilai dpi yang didukung adalah 75 dan 100. Sebenarnya, resolusi default untuk penggerutu
diatur ke 75dpi. Resolusi juga mengatur perangkat default di mode x.

--rv Membalikkan warna latar depan dan latar belakang jendela penampil.

--judul 'beberapa teks'
Tetapkan judul untuk jendela penampil.

--xrm 'sumber'
Setel sumber daya X Window.

Opsi untuk Pengembangan
--debug
Aktifkan semua opsi debug --debug-mengetik. File-file sementara disimpan dan tidak
dihapus, minuman keras output dicetak, nama direktori sementara adalah
dicetak, nama file yang ditampilkan dicetak, dan parameter dicetak.

--debug-nama file
Cetak nama file dan pria halaman yang ditampilkan oleh penggerutu.

--debug-grog
Cetak output dari semua minuman keras perintah.

--debug-simpan
Aktifkan dua informasi debug. Cetak nama direktori sementara dan
simpan file-file sementara, jangan hapus selama menjalankan penggerutu.

--debug-params
Cetak parameter, seperti yang diperoleh dari file konfigurasi, dari GROFFER_OPT,
dan argumen baris perintah.

--debug-tmpdir
Cetak nama direktori sementara.

--tidak melakukan apapun
Ini seperti --Versi: kapan, tetapi tanpa keluaran; tidak ada pemirsa yang dimulai. Ini membuat
hanya akal dalam pembangunan.

--cetak=teks
Cukup cetak argumen ke kesalahan standar. Ini bagus untuk pemeriksaan parameter.

-V Ini adalah opsi lanjutan untuk debugging saja. Alih-alih menampilkan format
masukan, banyak penggerutu informasi spesifik dicetak ke output standar:

* nama file keluaran di direktori sementara,

* mode tampilan yang sebenarnya penggerutu Lari,

* program tampilan untuk melihat output dengan argumennya,

* parameter aktif dari file konfigurasi, argumen di $GROFFER_OPT, dan
argumen dari baris perintah,

* pipa yang akan dijalankan oleh kasar program, tetapi tanpa menjalankannya.

Opsi debugging berguna lainnya adalah kasar Option -Z dan --mode=groff.

Spesifikasi file kasus
A spesifikasi file parameter adalah argumen yang bukan opsi atau argumen opsi. Di penggerutu,
spesifikasi file parameter adalah nama file atau templat untuk pencarian pria halaman. masukan ini
sumber dikumpulkan dan disusun menjadi satu file keluaran seperti: kasar tidak.

Perilaku POSIX yang aneh untuk menganggap semua argumen di balik argumen non-opsi pertama sebagai
spesifikasi file argumen diabaikan. Perilaku GNU untuk mengenali opsi bahkan ketika dicampur dengan
spesifikasi file argumen digunakan di seluruh. Tapi, seperti biasa, argumen minus ganda -- berakhir
penanganan opsi dan menafsirkan semua argumen berikut sebagai spesifikasi file argumen; sehingga
Perilaku POSIX dapat dengan mudah diadopsi.

Opsi --tepat* memiliki penanganan khusus spesifikasi file argumen. Setiap argumen adalah
diambil sebagai skema pencariannya sendiri. Juga regexp (ekspresi reguler) dapat digunakan dalam
spesifikasi file Sebagai contoh, penggerutu --tepat '^gro.f$' pencarian kasar dalam pria halaman
nama, sedangkan penggerutu --tepat kasar pencarian kasar di suatu tempat dalam nama atau deskripsi
itu pria halaman.

Semua bagian lain dari penggerutu, seperti tampilan normal atau output dengan --apa yang memiliki
skema yang berbeda untuk spesifikasi file. Tidak ada ekspresi reguler yang digunakan untuk argumen. Itu
spesifikasi file argumen ditangani oleh skema berikut.

Perlu diketahui bahwa pada setiap sistem pria halaman diurutkan menurut
konten menjadi beberapa bagian. Itu klasik pria bagian memiliki nama karakter tunggal,
salah satu digit dari 1 untuk 9 atau salah satu karakter n or o.

Ini secara opsional dapat diikuti oleh string, yang disebut perpanjangan. itu perpanjangan
memungkinkan untuk menyimpan beberapa pria halaman dengan nama yang sama di tempat yang sama bagian. Tapi
perpanjangan hanya jarang digunakan, biasanya dihilangkan. Kemudian ekstensi dicari
secara otomatis berdasarkan alfabet.

Berikut ini, kami menggunakan nama bagian_ekstensi untuk sebuah kata yang terdiri dari satu
karakter bagian nama atau bagian karakter yang diikuti oleh perpanjangan. Masing-masing
spesifikasi file parameter dapat memiliki salah satu bentuk berikut dalam urutan menurun.

* Tidak ada spesifikasi file parameter berarti bahwa penggerutu menunggu input standar. Opsi minus -
selalu berarti input standar; dapat terjadi beberapa kali. Jika Anda ingin mencari
pria halaman bernama - gunakan argumen manusia:-.

* Selanjutnya spesifikasi file diuji apakah itu nama path dari file yang ada. Jika tidak,
diasumsikan sebagai pola pencarian untuk pria halaman.

* man:nama(bagian_ekstensi), man:nama.bagian_ekstensi, nama(bagian_ekstensi), or
nama.bagian_ekstensi cari halaman manual nama di bagian man dan mungkin perpanjangan dari
bagian_ekstensi.

* Sekarang man:nama mencari pria halaman di paling bawah pria bagian yang memiliki dokumen
bernama nama.

* bagian_ekstensi nama adalah pola 2 argumen yang berasal dari yang aneh
penguraian argumen dari pria program. Sekali lagi, ini mencari halaman manual nama dengan
bagian_ekstensi, kombinasi dari bagian karakter opsional diikuti oleh an
perpanjangan.

* Kami dibiarkan dengan argumen nama yang bukan merupakan file yang ada. Jadi ini mencari
itu pria halaman bernama nama di paling bawah pria bagian yang memiliki dokumen untuk nama ini.

Beberapa argumen nama file dapat diberikan. Mereka dicampur oleh kasar menjadi satu
dokumen. Perhatikan bahwa kumpulan argumen opsi harus sesuai dengan semua argumen file ini.
Jadi mereka setidaknya harus memiliki gaya yang sama kasar bahasa.

KELUARAN MODE

Secara default, penggerutu program mengumpulkan semua input ke dalam satu file, memformatnya dengan
kasar program untuk perangkat tertentu, dan kemudian memilih program penampil yang sesuai. Itu
perangkat dan proses penampil di penggerutu disebut a mode. Mode dan penampil lari
penggerutu program dipilih secara otomatis, tetapi pengguna juga dapat memilihnya dengan opsi.
Mode dipilih dengan opsi argumen dari --modus=mode apa saja. Selain itu, masing-masing
argumen ini dapat ditentukan sebagai opsinya sendiri, seperti mode apa saja. Sebagian besar
mode memiliki program penampil, yang dapat dipilih dengan opsi --penonton.

Beberapa mode berbeda ditawarkan, mode grafis untuk X Window, teks mode, dan beberapa
langsung kasar mode untuk debugging dan pengembangan.

Secara default, penggerutu percobaan pertama apakah x mode mungkin, maka ps mode, dan akhirnya
tty mode. Urutan pengujian mode ini untuk mobil mode dapat diubah dengan menentukan koma
daftar mode yang terpisah dengan opsi --mode-default.

Pencarian untuk pria halaman dan dekompresi input aktif di setiap mode.

Grafis Display Mode
Mode tampilan grafis sebagian besar berfungsi di lingkungan X Window (atau yang serupa)
implementasi dalam lingkungan windowing lainnya). Variabel lingkungan $TAMPILAN
dan pilihan --menampilkan digunakan untuk menentukan tampilan X Window yang akan digunakan. Jika ini
variabel lingkungan kosong penggerutu mengasumsikan bahwa tidak ada X Window yang berjalan dan berubah menjadi a
teks mode. Anda dapat mengubah perilaku otomatis ini dengan opsi --mode-default.

Pemirsa terkenal untuk mode tampilan grafis dan program penampil X Window standar mereka
adalah

* dalam penampil PDF (pdf mode)

* di browser web (html or www mode)

* dalam penampil Postscript (ps mode)

* Jendela X roff pemirsa seperti tampilan gxdit(1) atau tampilan xdit(1) (dalam x mode)

* dalam program penampil dvi (Dvi mode)

pdf mode memiliki keuntungan besar — ​​ini adalah satu-satunya mode tampilan grafis yang memungkinkan untuk
mencari teks di dalam penampil; ini bisa menjadi fitur yang sangat penting. Sayangnya,
butuh beberapa waktu untuk mengubah input ke dalam format PDF, sehingga tidak dipilih sebagai
modus utama.

Penampil grafis ini dapat disesuaikan dengan opsi X Window Toolkit. Tetapi
penggerutu opsi menggunakan minus ganda di depan alih-alih minus tunggal yang digunakan oleh
Perangkat Jendela X.

Teks mode
Ada dua mode untuk output teks, mode teks untuk output biasa tanpa pager dan
mode tty untuk keluaran teks pada terminal teks menggunakan beberapa program pager.

Jika variabel $TAMPILAN tidak disetel atau kosong, penggerutu mengasumsikan bahwa itu harus menggunakan tty mode.

Dalam implementasi yang sebenarnya, kasar perangkat keluaran latin1 dipilih untuk teks mode.
Ini dapat diubah dengan menentukan opsi -T or --perangkat.

Pager yang akan digunakan dapat ditentukan oleh salah satu opsi --halaman dan --penonton, atau oleh
variabel lingkungan $HALAMAN. Jika semua ini tidak digunakan, kurang(1) program dengan
Option -r untuk menampilkan urutan kontrol dengan benar digunakan sebagai pager default.

Khusus Mode untuk Debugging dan Pengembangan
Mode ini menggunakan penggerutu penentuan file dan dekompresi. Ini digabungkan menjadi
file input tunggal yang diumpankan langsung ke kasar dengan strategi yang berbeda tanpa
penggerutu fasilitas melihat. Mode ini dianggap canggih, mereka berguna untuk
debugging dan tujuan pengembangan.

sumber mode dengan pilihan --sumber hanya menampilkan input yang didekompresi.

pilihan --ke-stdout tidak ditampilkan dalam mode grafis. Itu hanya menghasilkan file untuk
mode yang dipilih dan kemudian mencetak isinya ke output standar.

kasar mode melewati input ke kasar hanya menggunakan beberapa opsi yang sesuai yang disediakan untuk
penggerutu. Ini memungkinkan pengguna untuk menyimpan output yang dihasilkan ke dalam file atau menyalurkannya ke
program lain.

In kasar mode, pilihan -Z menonaktifkan pasca-pemrosesan, sehingga menghasilkan kasar
menengah keluaran. Dalam mode ini, input diformat, tetapi tidak diproses setelahnya; melihat
groff_out(5) untuk rincian.

Semua kasar opsi pendek didukung oleh penggerutu.

MAN HALAMAN PENCARIAN

Perilaku default dari penggerutu adalah untuk menguji terlebih dahulu apakah parameter file mewakili a
berkas lokal; jika bukan nama file yang ada, itu dianggap mewakili nama a
pria halaman. Opsi berikut dapat digunakan untuk menentukan apakah argumen harus:
ditangani sebagai nama file atau pria halaman argumen.

--pria memaksa untuk menafsirkan semua parameter file sebagai spesifikasi file untuk mencari pria halaman.

--tidak ada laki-laki
--file-lokal
nonaktifkan pria mencari; jadi hanya file lokal yang ditampilkan.

Jika bukan file lokal atau a pria halaman telah diambil untuk beberapa parameter file, peringatannya adalah
dikeluarkan pada kesalahan standar, tetapi pemrosesan dilanjutkan.

Pencarian Algoritma
Mari kita asumsikan bahwa a pria halaman harus dicari. Itu penggerutu program menyediakan
fasilitas pencarian untuk pria halaman. Semua opsi panjang, semua variabel lingkungan, dan sebagian besar
fungsi GNU pria(1) program dilaksanakan. Algoritma pencarian harus
menentukan file mana yang ditampilkan untuk diberikan pria halaman. Prosesnya dapat dimodifikasi dengan
pilihan dan variabel lingkungan.

Satu-satunya pria tindakan yang dihilangkan dalam penggerutu adalah yang telah diformat sebelumnya pria halaman, Juga disebut
kucing halaman. Dengan kinerja yang sangat baik dari komputer yang sebenarnya, yang telah diformat
pria halaman tidak diperlukan lagi. Selain itu, penggerutu adalah roff program; itu ingin
untuk membaca roff file sumber dan memformatnya sendiri.

Algoritma untuk mengambil file untuk a pria halaman kebutuhan pertama satu set direktori.
Set ini dimulai dengan apa yang disebut pria path yang dimodifikasi kemudian dengan menambahkan nama
operasi sistem dan bahasa. Himpunan timbul ini digunakan untuk menambahkan bagian
direktori yang berisi pria halaman file.

pria path adalah daftar direktori yang dipisahkan oleh titik dua. Ini dihasilkan oleh
metode berikut.

* Variabel lingkungan $MANPATH dapat diatur.

* Dapat dibaca dari argumen variabel lingkungan $MANOPT.

* The pria path dapat ditentukan secara manual dengan menggunakan opsi --jalur manusia. Argumen kosong
menonaktifkan pria halaman mencari.

* Bila tidak pria path telah ditetapkan jalan manusia(1) program dicoba untuk menentukan satu.

* Jika ini tidak berhasil, jalur default yang masuk akal dari $ PATH ditentukan.

Kami sekarang memiliki satu set direktori awal. Cara pertama untuk mengubah set ini adalah dengan menambahkan
nama operasi sistem. Ini mengasumsikan bahwa pria halaman untuk beberapa operasi sistem adalah
diinstal. Hal ini tidak selalu benar. Nama-nama tersebut operasi sistem dapat disediakan
dengan 3 metode.

* Variabel lingkungan $SISTEM memiliki prioritas terendah.

* Ini dapat diganti dengan opsi di $MANOPT.

* Ini lagi ditimpa oleh opsi baris perintah --sistem.

Beberapa nama dari operasi sistem dapat diberikan dengan menambahkan nama mereka, dipisahkan dengan
koma.

pria path diubah dengan menambahkan masing-masing sistem beri nama sebagai subdirektori di akhir setiap
direktori himpunan. Tidak ada direktori pria path set disimpan. Tapi jika tidak sistem nama adalah
ditentukan pria path dibiarkan tidak berubah.

Setelah ini, kumpulan direktori yang sebenarnya dapat diubah dengan bahasa informasi. Ini
mengasumsikan bahwa ada pria halaman dalam bahasa yang berbeda. Yang dicari bahasa dapat
dipilih dengan beberapa metode.

* Variabel lingkungan $LANG.

* Ini ditimpa oleh $LC_MESSAGES.

* Ini ditimpa oleh $LC_SEMUA.

* Ini dapat diganti dengan memberikan opsi di $MANOPT.

* Semua variabel lingkungan ini ditimpa oleh opsi baris perintah --lokal.

kegagalan bahasa dapat ditentukan dengan menentukan salah satu parameter pseudo-bahasa
C atau POSIX. Ini seperti menghapus yang sebelumnya diberikan bahasa informasi. Itu pria halaman
dalam kegagalan bahasa biasanya dalam bahasa Inggris.

Tentu saja, bahasa nama ditentukan oleh pria. Di GNU pria, ditentukan dalam
Format berbasis POSIX 1003.1:

[_[.[,]]],

tapi kode dua huruf di cukup untuk sebagian besar tujuan. Jika untuk
rumit bahasa formulasi no pria halaman Ditemukan penggerutu mencari bagian negara
terdiri dari dua karakter pertama ini juga.

Set direktori yang sebenarnya disalin tiga kali. Itu bahasa nama ditambahkan sebagai subdirektori
ke setiap direktori dalam salinan pertama dari set direktori yang sebenarnya (ini hanya dilakukan ketika a
informasi bahasa diberikan). Kemudian singkatan 2 huruf dari bahasa nama adalah
ditambahkan sebagai subdirektori ke salinan kedua dari kumpulan direktori (ini hanya dilakukan ketika
nama bahasa yang diberikan memiliki lebih dari 2 huruf). Salinan ketiga dari set direktori adalah
tetap tidak berubah (jika tidak ada bahasa informasi yang diberikan ini adalah set direktori yang disimpan).
Maksimal 3 salinan ini ditambahkan untuk mendapatkan set direktori baru.

Kami sekarang memiliki satu set lengkap direktori untuk dikerjakan. Di masing-masing direktori ini,
pria file dipisahkan dalam bagian. Nama dari bagian diwakili oleh satu
karakter, angka antara 1 dan 9, atau karakter o or n, dalam urutan ini.

Untuk setiap tersedia bagian, sebuah subdirektori pria ada yang mengandung semua pria arsip
untuk ini bagian, Di mana adalah karakter tunggal seperti yang dijelaskan sebelumnya. Setiap pria
file dalam bagian direktori memiliki bentuk
pria/.[ ][.], Di mana dan
bersifat opsional. adalah nama dari pria halaman yang juga ditentukan sebagai
argumen filespec pada baris perintah.

perpanjangan adalah tambahan untuk bagian. Postfix ini bertindak seperti subbagian. Sebuah
perpanjangan hanya terjadi pada nama file, bukan pada nama bagian subdirektori. Bisa
ditentukan pada baris perintah.

Di sisi lain, kompresi hanyalah informasi tentang bagaimana file dikompresi.
Ini tidak penting bagi pengguna, sehingga tidak dapat ditentukan pada baris perintah.

Ada 4 metode untuk menentukan a bagian pada baris perintah:

* Variabel lingkungan $ MANSECT

* Opsi baris perintah --bagian

* Lampiran untuk nama argumen dalam bentuk .

* Pra-argumen sebelum nama argumen dalam bentuk

Dimungkinkan juga untuk menentukan beberapa bagian dengan menambahkan karakter tunggal
dipisahkan oleh titik dua. Orang dapat membayangkan bahwa ini berarti membatasi pria halaman cari ke
hanya beberapa bagian. banyak bagian hanya mungkin untuk $ MANSECT dan --bagian.

Jika tidak bagian ditentukan semua bagian dicari satu demi satu dalam yang diberikan
memesan, dimulai dengan bagian 1, hingga file yang sesuai ditemukan.

Ada 4 metode untuk menentukan perpanjangan pada baris perintah. Tapi itu tidak perlu
untuk memberikan seluruh nama ekstensi, beberapa singkatan cukup baik dalam banyak kasus.

* Variabel lingkungan $EXTENSI

* Opsi baris perintah --perpanjangan

* Lampiran untuk . argumen dalam bentuk .

* Pra-argumen sebelum nama argumen dalam bentuk

Untuk detail lebih lanjut tentang pria halaman mencari, lihat pria(1).

contoh of pria arsip
/usr/share/man/man1/groff.1
Ini adalah file tidak terkompresi untuk pria halaman marah bagian 1. Itu bisa disebut
by
SH# Groffer Groff
Tidak bagian ditentukan di sini, jadi semua bagian harus dicari, tetapi sebagai bagian 1
dicari terlebih dahulu file ini akan ditemukan terlebih dahulu. Nama file terdiri dari
komponen berikut. / usr / share / man / harus menjadi bagian dari pria path; itu
subdirektori pria1/ dan bagian .1 berdiri untuk bagian; kasar adalah nama dari
pria halaman.

/usr/local/share/man/man7/groff.7.gz
Nama file terdiri dari komponen-komponen berikut. /usr/local/share/man harus
menjadi bagian dari pria path; subdirektori pria7/ dan bagian .7 berdiri untuk
bagian; kasar adalah nama dari pria halaman; bagian akhir .gz singkatan dari a
kompresi dengan gzip(1). sebagai bagian bukan yang pertama itu harus ditentukan
demikian juga. Ini dapat dilakukan dengan salah satu perintah berikut.
SH# Groffer Groff.7
SH# Groffer 7 Groff
SH# groff --sections=7 groff

/usr/local/man/man1/ctags.1emacs21.bz2
Sini / usr / local / man harus masuk pria path; subdirektori pria1/ dan nama filenya
bagian .1 berdiri untuk bagian 1; nama dari pria halaman is ctag; bagian memiliki
perpanjangan emacs21; dan file dikompres sebagai . Bz2 dengan bzip2(1). Filenya bisa
dilihat dengan salah satu perintah berikut
SH# Groffer ctags.1e
SH# groffer 1e ctag
SH# groffer --extension=e --sections=1 ctag
di mana e berfungsi sebagai singkatan untuk ekstensi emacs21.

/usr/man/linux/de/man7/man.7.Z
Direktori / usr / man sekarang menjadi bagian dari pria path; lalu ada subdirektori
untuk operasi sistem nama linux /; selanjutnya datang subdirektori de / untuk orang Jerman
bahasa; itu bagian nama man7 dan .7 diketahui sejauh ini; pria adalah nama dari
pria halaman; Dan .Z menandakan kompresi yang dapat ditangani oleh gzip(1). Kami ingin
sekarang tunjukkan bagaimana memberikan beberapa nilai untuk beberapa opsi. Itu mungkin untuk
bagian dan operasi sistem nama. Jadi kita gunakan sebagai bagian 5 dan 7 dan sebagai sistem
nama linux dan ayx. Perintahnya kemudian

SH# Groffer --locale=de --sections=5:7 --systems=linux,aix man
SH# LANG=de MANSECT=5:7 SYSTEM=linux, dan Groffer Man

DEKOMPRESI

Program ini memiliki fasilitas dekompresi. Jika input standar atau file yang diambil
dari parameter baris perintah dikompresi dengan format yang didukung oleh
gzip(1) atau bzip2(1) itu didekompresi on-the-fly. Ini termasuk GNU .gz, . Bz2, dan
tradisional .Z kompresi. Program ini menampilkan gabungan dari semua
input yang didekompresi dalam urutan yang ditentukan pada baris perintah.

LINGKUNGAN

penggerutu program mendukung banyak variabel sistem, kebanyakan dari mereka dengan izin lainnya
program. Semua variabel lingkungan dari kasar(1) dan GNU pria(1) dan beberapa sistem standar
variabel dihormati.

Asli penggerutu Variabel
$GROFFER_OPT
Opsi toko untuk menjalankan penggerutu. Opsi yang ditentukan dalam variabel ini adalah
ditimpa oleh opsi yang diberikan pada baris perintah. Isi dari variabel ini
dijalankan melalui shell builtin `eval'; jadi argumen yang mengandung spasi atau
karakter shell khusus harus dikutip. Jangan lupa untuk mengekspor variabel ini,
jika tidak, itu tidak ada selama menjalankan penggerutu.

System Variabel
Variabel berikut memiliki arti khusus untuk penggerutu.

$TAMPILAN
Jika variabel ini disetel, ini menunjukkan bahwa sistem X Window sedang berjalan.
Pengujian variabel ini memutuskan apakah output grafis atau teks dihasilkan.
Variabel ini tidak boleh diubah oleh pengguna secara sembarangan, tetapi dapat digunakan untuk
mulai grafisnya penggerutu pada terminal X Window jarak jauh. Misalnya, tergantung
pada sistem Anda, penggerutu dapat dimulai pada monitor kedua dengan perintah

SH# DISPLAY=:0.1 groffer apa pun &

$LC_SEMUA
$LC_MESSAGES
$LANG Jika salah satu variabel ini diatur (dalam urutan di atas), isinya adalah
diartikan sebagai lokal, bahasa yang akan digunakan, terutama saat mengambil
pria halaman. Nama lokal biasanya berbentuk
bahasa[_wilayah[.kumpulan kode[@pengubah]]], di mana bahasa adalah bahasa ISO 639
kode, wilayah adalah kode negara ISO 3166, dan kumpulan kode adalah kumpulan karakter atau
pengidentifikasi pengkodean seperti ISO-8859-1 atau UTF-8; melihat setlokal(3). Nilai lokal
C dan POSIX adalah singkatan dari default, yaitu pria halaman direktori tanpa bahasa
awalan. Ini adalah perilaku yang sama seperti ketika ketiga variabel tidak disetel.

$HALAMAN Variabel ini dapat digunakan untuk mengatur pager untuk keluaran tty. Misalnya, ke
nonaktifkan penggunaan pager setel sepenuhnya variabel ini ke kucing(1) program

SH# PAGER=kucing groffer apa saja

$ PATH Semua program dalam penggerutu skrip dipanggil tanpa jalur tetap. Jadi ini
variabel lingkungan menentukan set program yang digunakan dalam menjalankan penggerutu.

Mengerikan Variabel
penggerutu program panggilan internal kasar, jadi semua variabel lingkungan didokumentasikan dalam
kasar(1) digunakan secara internal di dalam penggerutu demikian juga. Variabel berikut memiliki arah
artinya untuk penggerutu program.

$GROFF_TMPDIR
Jika nilai variabel ini adalah direktori yang sudah ada dan dapat ditulis, penggerutu menggunakannya
untuk menyimpan file sementaranya, sama seperti kasar melakukan. Lihat kasar(1) halaman manual untuk
rincian lebih lanjut tentang lokasi file-file sementara.

Pria Variabel
Bagian dari fungsi pria program dilaksanakan di penggerutu; dukungan untuk semua
variabel lingkungan didokumentasikan dalam pria(1) ditambahkan ke penggerutu, tapi artinya adalah
sedikit dimodifikasi karena pendekatan yang berbeda dalam penggerutu; tetapi antarmuka pengguna adalah
sama. Itu pria variabel lingkungan dapat ditimpa oleh opsi yang disediakan dengan $MANOPT,
yang pada gilirannya ditimpa oleh baris perintah.

$EXTENSI
Batasi pencarian untuk pria halaman ke file yang memiliki ekstensi ini. Ini
ditimpa oleh opsi --perpanjangan; lihat di sana untuk detailnya.

$MANOPT
Variabel ini berisi opsi sebagai preset untuk pria(1). Karena tidak semua ini adalah
relevan untuk penggerutu hanya bagian penting dari nilainya yang diekstraksi. Itu
opsi yang ditentukan dalam variabel ini menimpa nilai lingkungan lain
variabel yang khusus untuk pria. Semua opsi yang ditentukan dalam variabel ini adalah
ditimpa oleh opsi yang diberikan pada baris perintah.

$MANPATH
Jika disetel, variabel ini berisi direktori di mana pria halaman pohon adalah
disimpan. Ini ditimpa oleh opsi --jalur manusia.

$ MANSECT
Jika ini adalah daftar nama bagian yang dipisahkan titik dua, cari pria halaman is
terbatas pada bagian manual dalam urutan itu. Ini ditimpa oleh opsi
--bagian.

$SISTEM
Jika ini diatur ke daftar nama yang dipisahkan koma, ini ditafsirkan sebagai pria halaman
pohon untuk sistem operasi yang berbeda. Variabel ini dapat ditimpa oleh opsi
--sistem; lihat di sana untuk detailnya.

Variabel lingkungan $MANROFFSEQ diabaikan oleh penggerutu karena perlu
preprocessors ditentukan secara otomatis.

KONFIGURASI FILE

penggerutu program dapat dikonfigurasi dengan dua file konfigurasi.

/etc/groff/groffer.conf
File konfigurasi seluruh sistem untuk penggerutu.

$HOME/.groff/groffer.conf
File konfigurasi khusus pengguna untuk penggerutu, Di mana $ HOME menunjukkan rumah pengguna
direktori. File ini dipanggil setelah file konfigurasi seluruh sistem untuk mengaktifkan
ditimpa oleh pengguna.

Kedua file ditangani untuk konfigurasi, tetapi file konfigurasi di / Etc datang
pertama; itu ditimpa oleh file konfigurasi di direktori home; keduanya
file konfigurasi ditimpa oleh variabel lingkungan $GROFFER_OPT; semuanya
ditimpa oleh argumen baris perintah.

File konfigurasi berisi opsi yang harus dipanggil sebagai default untuk setiap penggerutu
Lari. Opsi-opsi ini ditulis dalam baris sedemikian rupa sehingga masing-masing berisi opsi panjang, a
opsi pendek, atau kluster opsi pendek; masing-masing dengan atau tanpa argumen. Jadi setiap baris
dengan informasi konfigurasi dimulai dengan karakter minus `-'; garis dengan panjang
opsi dimulai dengan dua karakter minus `--', garis dengan opsi pendek atau opsi pendek
cluster dimulai dengan satu minus `-'.

Nama opsi dalam file konfigurasi tidak boleh disingkat, harus sama persis.

Argumen untuk opsi yang panjang dapat dipisahkan dari nama opsi baik dengan persamaan
tanda tangani `=' atau dengan spasi, yaitu satu atau beberapa spasi atau karakter tab. Argumen untuk
opsi pendek atau cluster opsi pendek dapat langsung ditambahkan ke nama opsi atau
dipisahkan oleh spasi. Akhir dari sebuah argumen adalah akhir dari baris. Bukan itu
diizinkan untuk menggunakan variabel lingkungan shell dalam nama opsi atau argumen.

Tidak perlu menggunakan tanda kutip dalam opsi atau argumen, kecuali untuk argumen kosong.
Argumen kosong dapat diberikan dengan menambahkan sepasang tanda kutip ke persamaan pemisah
tanda atau spasi; dengan opsi pendek, pemisah juga dapat dihilangkan. untuk waktu yang lama
opsi dengan tanda sama dengan pemisah `=', Sepasang tanda kutip dapat dihilangkan, sehingga berakhir
garis yang memisahkan tanda sama dengan. Semua karakter kutipan lainnya dibatalkan
secara internal.

Dalam file konfigurasi, spasi kosong diizinkan di awal setiap baris,
itu diabaikan begitu saja. Setiap spasi dalam satu baris diganti dengan satu karakter spasi
`` secara internal.

Semua baris dari baris konfigurasi yang tidak dimulai dengan karakter minus diabaikan,
sehingga komentar dimulai dengan `#' mungkin. Jadi tidak ada perintah shell di
file konfigurasi.

Sebagai contoh, perhatikan file konfigurasi berikut yang dapat digunakan baik di
/etc/groff/groffer.conf or ~/.groff/groffer.conf .

# file konfigurasi groffer
#
# opsi groffer yang digunakan di setiap panggilan groffer
--latar depan=Biru Tua
--resolusi=100
--viewer=gxditview -geometri 900x1200
--penampil xpdf -Z 150

Garis dimulai dengan # diabaikan begitu saja, jadi mereka bertindak sebagai baris perintah. Ini
konfigurasi set empat penggerutu pilihan (baris yang dimulai dengan `-'). Ini memiliki
efek berikut:

* Gunakan warna teks Biru tua di semua pemirsa yang mendukung ini, seperti tampilan gxdit.

* Gunakan resolusi 100dpi di semua pemirsa yang mendukung ini, seperti tampilan gxdit. Oleh
ini, perangkat default di x mode diatur ke X100.

* Memaksa tampilan gxdit(1) sebagai mode-x penampil menggunakan opsi geometri untuk mengatur lebar
untuk 900px dan tinggi ke 1200px. Geometri ini cocok untuk resolusi
100dpi.

* Gunakan xpdf(1) sebagai mode pdf penonton dengan argumen -Z 150.

CONTOH

Penggunaan penggerutu sangat mudah. Biasanya hanya dipanggil dengan nama file atau
pria halaman. Contoh-contoh berikut, bagaimanapun, menunjukkan bahwa penggerutu memiliki jauh lebih mewah
kemampuan.

SH# Groffer /usr/local/share/doc/groff/meintro.ms.gz

Dekompresi, format dan tampilkan file terkompresi meintro.ms.gz di direktori
/usr/local/share/doc/groff, menggunakan penampil standar tampilan gxdit sebagai penampil grafis ketika
di X Window, atau kurang(1) program pager saat tidak di X Window.

SH# Groffer Groff

Jika file ./groff ada menggunakannya sebagai input. Kalau tidak, tafsirkan argumen sebagai pencarian
untuk pria halaman bernama kasar sekecil mungkin pria bagian, menjadi bagian 1 dalam hal ini
kasus.

SH# pria groffer:groff

cari pria halaman of kasar bahkan ketika file ./groff ada

SH# Groffer Groff.7
SH# Groffer 7 Groff

cari pria halaman of kasar in pria bagian 7. Pencarian bagian ini hanya berfungsi untuk satu digit
atau satu karakter dari satu set kecil.

SH# Groffer fb.modes

Jika file ./fb.mode tidak ada menafsirkan ini sebagai pencarian untuk pria halaman of
fb.mode. Sebagai ekstensi mode bukan karakter tunggal dalam gaya bagian klasik
argumen tidak dibagi menjadi pencarian untuk fb.

SH# groffer groff 'troff(1)' pria: roff

Argumen yang bukan file yang ada dicari sebagai berikut: pria halaman: kasar
(pencarian otomatis, harus ditemukan di pria bagian 1), troff (di bagian 1), dan roff (di
bagian dengan angka terendah, menjadi 7 dalam hal ini). Kutipan di sekitar 'troff(1)'
diperlukan karena tanda kurung adalah karakter shell khusus; melarikan diri dari mereka dengan
karakter garis miring terbalik \( dan \) akan mungkin juga. File yang diformat adalah:
digabungkan dan ditampilkan dalam satu kesatuan.

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

Ambil Jerman pria halaman (bahasa de) Untuk ls program, dekompresi, format ke
html format (www mode) dan lihat hasilnya di browser web galleon. Pilihan --pria
menjamin bahwa pria halaman diambil, bahkan ketika file lokal ls ada dalam kenyataan
direktori.

SH# groffer --source 'man:roff(7)'

Dapatkan pria halaman bernama roff in pria bagian 7, dekompresi, dan cetak yang belum diformat
konten, kode sumbernya.

SH# Groffer --de-p --di --ap

Ini adalah seperangkat argumen yang disingkat, ditentukan sebagai

SH# groffer --debug-params --output menengah --apropos

SH# file kucing.gz | groffer -Z -mfoo

File file.gz dikirim ke input standar, ini didekompresi, dan kemudian ini
diangkut ke kasar menengah keluaran mode tanpa pasca-pemrosesan (kasar Option
-Z), menggunakan paket makro foo (kasar Option -m).

SH# echo '\f[CB]WOW!' |
> groffer --x --bg merah --fg kuning --geometri 200x100 -

Tampilkan kata WOW! di jendela kecil dalam font tebal dengan lebar konstan, menggunakan warna kuning pada
latar belakang merah.

KOMPATIBILITAS

penggerutu program ditulis dalam Perl, versi Perl saat menulis adalah v5.8.8.

penggerutu menyediakan parsernya sendiri untuk argumen baris perintah yang kompatibel dengan keduanya
POSIX getopt(1) dan GNU dapatkan opt(1). Itu dapat menangani argumen opsi dan nama file
berisi spasi putih dan satu set besar karakter khusus. Standar berikut
jenis opsi yang didukung.

* Opsi yang terdiri dari satu minus - mengacu pada masukan standar.

* Satu minus diikuti oleh karakter mengacu pada opsi karakter tunggal atau a
kombinasinya; misalnya, penggerutu kombinasi opsi pendek -Qmfoo is
setara dengan -Q -m foo.

* Opsi panjang adalah opsi dengan nama yang lebih panjang dari satu karakter; mereka selalu didahului
dengan minus ganda. Argumen opsi bisa pergi ke argumen baris perintah berikutnya
atau ditambahkan dengan tanda sama dengan argumen; Misalnya, --panjang=arg setara
untuk --panjang arg.

* Argumen -- mengakhiri penguraian opsi; semua argumen baris perintah lebih lanjut adalah
ditafsirkan sebagai spesifikasi file parameter, yaitu nama file atau konstruksi untuk pencarian
pria halaman).

* Semua argumen baris perintah yang bukan opsi atau argumen opsi ditafsirkan
as spesifikasi file parameter dan disimpan hingga penguraian opsi selesai. Misalnya,
command line

SH# file groffer1 -a -o arg file2

adalah setara dengan

SH# Groffer -a -o arg -- file1 file2

Pencampuran opsi gratis dan spesifikasi file parameter mengikuti prinsip GNU. Itu tidak
tidak memenuhi perilaku opsi aneh POSIX yang segera mengakhiri pemrosesan opsi
argumen non-opsi pertama telah tercapai. Akhir dari pemrosesan opsi dapat berupa
dipaksa oleh opsi `--' omong-omong.

Gunakan groffer online menggunakan layanan onworks.net