groffer - Online în cloud

PROGRAM:

NUME

groffer - afișați fișierele groff și paginile de manual pe X și tty

REZUMAT

groffer [--] [fisierspec ....]

groffer [mod-opțiune ....] [groff-opțiuni ....] [man-opțiuni ....] [X-opțiuni ....]
[--] [fisierspec ....]

groffer -h | --Ajutor

groffer -v | --versiune

DESCRIERE

groffer programul este cel mai simplu mod de utilizat groff(1). Se poate afișa arbitrar
documente scrise în groff limba, vezi groff(7), sau altele roff limbi, vezi
roff(7), care sunt compatibile cu originalul troff limba. Găsește și rulează pe toate
necesar groff preprocesoare, cum ar fi chim.

groffer programul include, de asemenea, multe dintre caracteristicile pentru găsirea și afișarea Unix-ului
pagini de manual (om pagini), astfel încât să poată fi folosit ca înlocuitor pentru a om(1) program.
În plus, fișiere comprimate care pot fi gestionate de gzip(1) sau bzip2(1) sunt decomprimate pe-
Muscă.

Utilizarea normală este destul de simplă prin furnizarea unui nume de fișier sau a unui nume om pagină fără
opțiuni suplimentare. Dar opțiunea de manipulare are multe posibilități de creare speciale
comportamentelor. Acest lucru se poate face fie în fișierele de configurare, cu mediul shell
variabil $GROFFER_OPT, sau pe linia de comandă.

Ieșirea poate fi generată și vizualizată în mai multe moduri diferite disponibile pentru groff.
Aceasta include groff vizualizator nativ X Window gxditview(1), fiecare Postscript, pdf, dvi
program de afișare, un browser web prin generare html in www mod, sau mai multe a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. moduri de in
terminale text.

Majoritatea opțiunilor care trebuie denumite atunci când rulează groff direct sunt determinate
automat pentru groffer, datorită utilizării interne a Grog(1) program. Dar tot
părțile pot fi controlate și manual prin argumente.

Pe argumentele liniei de comandă pot fi specificate mai multe nume de fișiere. Ele sunt transformate
într-un singur document în modul normal de groff.

Gestionarea opțiunilor se face în stil GNU. Opțiunile și numele fișierelor pot fi amestecate liber. The
opțiunea `--' închide gestionarea opțiunilor, toate argumentele următoare sunt tratate ca nume de fișiere.
Opțiunile lungi pot fi prescurtate în mai multe moduri.

OPȚIUNE ÎNSCRIERI

de rupere Opțiuni

[-h | --Ajutor] [-v | --versiune]

groffer mod Opțiuni

[--auto] [--Mod implicit] [--modurile-implicite mod1,mod2,....] [--dvi] [--groff]
[--html] [--latină1] [--mod modul de afișare] [--pdf] [--pdf2] [--ps] [--sursă]
[--text] [--la-stdout] [--tty] [--utf8] [--vizor prog] [--www] [--X | --X]

Opțiuni legate de la groff

[-T | --dispozitiv dispozitiv] [-Z | --ieșire-intermediară | --ditroff]

Totul mai departe groff sunt acceptate opțiuni scurte.

Opțiuni pentru om pagini

[--apropos] [--apropos-date] [--apropos-devel] [--apropos-progs] [--om]
[--nici un om] [--nu-special] [--ce este]

lung Opțiuni luate peste din GNU om

[--toate] [--ascii] [--ditroff] [--extensie sufix] [--locale limbă]
[--local-file] [--Locație | --Unde] [--manpath dir1:dir2:....] [--fără locație]
[--pager program] [--secțiuni sec1:sec2:....] [--sisteme sys1,sys2,....]
[--troff-dispozitiv dispozitiv]

Alte opțiuni lungi ale GNU om sunt acceptate de asemenea.

X Fereastră Setul de instrumente Opțiuni

[--bd | --bordercolor pixeli] [--bg | --fundal culoare]
[--bw | --lățimea graniței pixeli] [--afişa Afișaj X] [--fg | --prim plan culoare]
[--fn | --ft | --font font_name] [--geometrie dimensiune_poz] [--rezoluţie valoare] [--rv]
[--titlu şir] [--xrm X-resursa]

Opțiuni pentru dezvoltare

[--depanare] [--debug-filenames] [--debug-grog] [--debug-keep] [--debug-params]
[--debug-tmpdir] [--nu face nimic] [--imprimare a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. ] [-V]

fisierspec argumente

fisierspec parametrii sunt toate argumentele care nu sunt nici o opțiune, nici o opțiune
argument. Ele înseamnă de obicei un nume de fișier sau un om pagină schema de cautare.

În cele ce urmează, termenul section_extension este folosit. Înseamnă un cuvânt care
constă dintr-un om secțiune care este urmat opțional de un extensie. Numele lui
a om secțiune este un singur personaj din [1–9 pe], extensie este un cuvânt. The
extensie lipsește în mare parte.

Nu fisierspec parametri înseamnă intrare standard.

- reprezintă intrarea standard (poate apărea de mai multe ori).

nume de fișier numele căii unui fișier existent.

om:nume(section_extension)
om:nume.section_extension
nume(section_extension)
nume.section_extension
section_extension nume
caută pagina de manual nume in sectiunea cu extensie optionala
section_extension.

om:nume pagina de manual în partea de jos om secțiune care are nume.

nume if nume nu este o căutare de fișiere existentă pentru pagina de manual nume în
cea mai de jos secțiune a omului.

OPȚIUNE DETALII

groffer programul poate fi rulat de obicei cu foarte puține opțiuni. Dar pentru scopuri speciale,
acceptă multe opțiuni. Acestea pot fi clasificate în 5 clase de opțiuni.

Toate opțiunile scurte ale groffer sunt compatibile cu opțiunile scurte ale groff(1). Tot lung
opțiuni de groffer sunt compatibile cu opțiunile lungi ale om(1).

Argumentele pentru nume lungi de opțiuni pot fi abreviate în mai multe moduri. În primul rând, argumentul
se verifică dacă poate fi prelungit ca atare. În plus, fiecare semn minus - is
considerată ca punct de plecare pentru o nouă abreviere. Aceasta duce la un set de multiple
abrevieri pentru un singur argument. De exemplu, --de-nf poate fi folosit ca abreviere
pentru --debug-not-func, Dar --de-n functioneaza la fel. Dacă abrevierea argumentului conduce
la mai multe opțiuni rezultate se ridică o eroare.

Aceste abrevieri sunt permise numai în variabila de mediu $GROFFER_OPT, dar nu în
fișierele de configurare. În configurație, toate opțiunile lungi trebuie să fie exacte.

groffer de rupere Opţiuni
De îndată ce una dintre aceste opțiuni este găsită pe linia de comandă este executată, tipărită
ieșire standard și rulare groffer se încheie ulterior. Toate celelalte argumente
sunt ignorate.

-h | --Ajutor
Imprimați informații de ajutor cu o scurtă explicație a opțiunilor pentru ieșirea standard.

-v | --versiune
Tipăriți informațiile despre versiune la rezultatul standard.

groffer mod Opţiuni
Modul de afișare și programele de vizualizare sunt determinate de aceste opțiuni. Dacă niciunul dintre
aceste opțiuni de mod și vizualizare sunt specificate groffer încearcă să găsească un mod de afișare potrivit
automat. Modurile implicite sunt mod pdf, mod ps, mod html, mod x și mod dvi
în X Window cu diferiți vizualizatori și mod tty cu dispozitiv utf8 în mai puțin pe un terminal;
alte moduri sunt testate dacă programele pentru modul implicit principal nu există.

În X Window, multe programe își creează propria fereastră atunci când sunt apelate. groffer pot rula acestea
telespectatorii ca un program independent în fundal. Deoarece acest lucru nu funcționează în modul text
pe un terminal (tty) trebuie să existe o modalitate de a ști ce vizualizatori sunt grafici X Window
programe. The groffer scriptul are un set mic de informații despre unele nume de vizualizatori. În cazul în care un
Argumentul viewer al liniei de comandă alege un element care este păstrat ca program X Window în
această listă este tratată ca un vizualizator care poate rula în fundal. Toate celelalte, necunoscute
apelurile de vizualizare nu sunt rulate în fundal.

Pentru fiecare mod, sunteți liber să alegeți ce spectator doriți. Nu trebuie să fie unele
vizualizator grafic potrivit pentru acest mod. Există șansa de a vizualiza sursa de ieșire; pentru
de exemplu, combinația de opțiuni --mode=ps si --viewer=mai puțin arata continutul de
il Post-scriptum ieșire, codul sursă, cu paginatorul mai puțin.

--auto Echivalentă cu --mode=auto.

--Mod implicit
Resetați toată configurația de la opțiunile de linie de comandă procesate anterior la
valori implicite. Acest lucru este util pentru a șterge toate opțiunile anterioare ale
configurație, în $GROFFER_OPTși reporniți procesarea opțiunilor folosind numai restul
a liniei de comandă.

--modurile-implicite mod1,mod2,....
Setați secvența modurilor pentru Auto mod la lista separată prin virgulă dată în
argument. Vedea --mod pentru detalii despre moduri. Afișare în mod implicit;
de fapt, asta înseamnă să încerci modurile x, ps și tty în această secvență.

--dvi Echivalentă cu --mode=dvi.
--vizor prog
Alegeți un program de vizualizare pentru dvi mod. Acesta poate fi un nume de fișier sau un program care urmează să fie
căutat în $ PATH. Fereastră X cunoscută dvi telespectatorii includ xdvi(1) și dvilx(1). În
în fiecare caz, argumentele pot fi furnizate suplimentar.

--groff
Echivalentă cu --mode=groff.

--html Echivalentă cu --mode=html.
--vizor
Alegeți un program de browser web pentru vizualizare în html mod. Poate fi numele căii lui
un fișier executabil sau un program în $ PATH. În fiecare caz, pot fi furnizate argumente
în plus.

--mod valoare
Setați modul de afișare. Sunt recunoscute următoarele valori de mod:

Auto Selectați determinarea automată a modului de afișare. Secvența de
modurile care sunt încercate pot fi setate cu --modurile-implicite opțiune. Util pentru
restabilirea lipsă mod când a fost specificat un alt mod înainte.

dvi Afișează intrarea formatată în a dvi programul de vizualizare. În mod implicit, formatul
intrarea este afișată cu xdvi(1) program.

groff După determinarea fișierului, comutați groffer pentru a procesa intrarea ca
groff(1) ar face. Aceasta dezactivează groffer caracteristici de vizualizare.

html Traduceți intrarea în format html și afișați rezultatul într-un browser web
program. Implicit, existența unei secvențe de browsere web standard
este testat, începând cu cuceritor(1) și mozilla(1). Vizualizatorul text html
is râs(1).

pdf Transforma roff intrare fișiere într-o PDF fişier folosind groff (1) dispozitiv
-Tpdf. Aceasta este valoarea implicită PDF generator. Cel generat PDF fişier is
afișate cu programe de vizualizare adecvate, cum ar fi ocular(1).

pdf2 Acesta este tradiționalul pdf mod. Uneori, acest mod produce mai corect
ieșire decât cea implicită PDF mod. În mod implicit, intrarea este formatată de
groff folosind dispozitivul Postscript, apoi este transformat în fișierul PDF
format folosind gs(1) sau ps2pdf(1). Dacă acest lucru nu este posibil, Post-scriptum
mod (ps) este folosit în schimb. În cele din urmă, este afișat folosind un vizualizator diferit
programe.

ps Afișează intrarea formatată într-un program de vizualizare Postscript. În mod implicit,
intrarea formatată este afișată într-unul dintre numeroasele programe de vizualizare.

a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. Format în a groff a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. mod și scrieți rezultatul la ieșirea standard fără
un pager sau un program de vizualizare. Dispozitivul de text, latin1 implicit, poate fi
ales cu opțiune -T.

tty Format în a groff a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. mod și scrieți rezultatul în ieșirea standard folosind a
program de paginare text, chiar și atunci când este în X Window.

www Echivalentă cu --mode=html.

x Afișați intrarea formatată într-un mod nativ roff privitor. În mod implicit,
intrarea formatată este afișată cu gxditview(1) programul în curs de distribuire
Împreună cu groff. Dar instrumentul standard X Window xditview(1) poate fi, de asemenea
ales cu opțiunea --vizor. Rezoluția implicită este 75dpi, Dar
100dpi sunt de asemenea posibile. Implicit groff dispozitiv pentru rezolvarea
75dpi is X75-12, Pentru 100dpi este X100. Corespondența groff
intermediar producție pentru că dispozitivul real este generat și rezultatul este
afișat. Pentru o rezoluție de 100dpi, lățimea implicită a geometriei
programul de afișare este ales 850dpi.

X Echivalentă cu --mode=x.

Următoarele moduri nu folosesc groffer caracteristici de vizualizare. Ele sunt numai
interesant pentru aplicații avansate.

groff Generați ieșirea dispozitivului cu simplu groff fără a utiliza vizualizarea specială
caracteristici ale groffer. Dacă nu a fost specificat niciun dispozitiv prin opțiune -T il groff
lipsă ps este asumat.

sursă Ieșiți codul sursă roff al fișierelor de intrare fără procesare ulterioară.

--pdf Echivalentă cu --mode=pdf.
--pdf2 Echivalentă cu --mode=pdf2.
--vizor prog
Alegeți un program de vizualizare pentru pdf mod. Acesta poate fi un nume de fișier sau un program care urmează să fie
căutat în $ PATH; argumentele pot fi furnizate suplimentar.

--ps Echivalentă cu --mode=ps.
--vizor prog
Alegeți un program de vizualizare pentru ps mod. Acesta poate fi un nume de fișier sau un program care urmează să fie
căutat în $ PATH. Vizionatorii obișnuiți Postscript includ ocular(1), dovadă(1), gv(1),
vedere fantomă(1), și gs(1), În fiecare caz, argumentele pot fi furnizate suplimentar.

--sursă
Echivalentă cu --mode=sursa.

--text Echivalentă cu --mode=text.

--la-stdout
Fișierul pentru modul ales este generat și conținutul acestuia este tipărit la standard
ieșire. Nu va fi afișat în modul grafic.

--tty Echivalentă cu --mode=tty.
--vizor prog
Alegeți un paginator text pentru mod tty. Pagina standard este mai puțin(1). Această opțiune este
echivalent cu om opțiune --pager=prog. Argumentul opțiunii poate fi un nume de fișier sau un
programul în care să fie căutat $ PATH; argumentele pot fi furnizate suplimentar.

--www Echivalentă cu --mode=html.
--vizor
prog.

--X | --X
Echivalentă cu --mode=x.
--vizor prog
Alegeți un program de vizualizare pentru x mod. Programele de vizualizare potrivite sunt gxditview(1)
care este implicit și xditview(1). Argumentul poate fi orice fișier executabil sau un
program în $ PATH; argumentele pot fi furnizate suplimentar.

-- Semnalează sfârșitul procesării opțiunii; toate argumentele rămase sunt interpretate ca
fisierspec parametri.

Pe langa acestea, groffer acceptă toate opțiunile scurte care sunt valabile pentru groff(1) program.
Toate non-groffer opțiunile sunt trimise nemodificate prin Grog la groff. Deci postprocesoare, macro
pachete, compatibilitate cu clasic troff, și multe altele pot fi specificate manual.

Opţiuni legate de la groff
Toate opțiunile scurte ale groffer sunt compatibile cu opțiunile scurte ale groff(1).
urmare a groff opțiunile au fie o semnificație specială suplimentară în interior groffer or
are sens pentru utilizare normală.

Din cauza comportamentului special de ieșire al groff opțiune -Z groffer a fost proiectat să
fi schimbat în groff mod; groffer funcțiile de vizualizare sunt dezactivate acolo. Celălalt
groff opțiunile nu schimbă modul, dar permit personalizarea procesului de formatare.

--A Acest lucru generează o aproximare ascii a ieșirii în a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. moduri de. Asta ar putea fi
important atunci când paginatorul text are probleme cu secvențele de control în tty mod.

--m fişier
Adăuga fişier ca o groff fișier macro. Acest lucru este util în cazul în care nu poate fi recunoscut
în mod automat.

-P opt_or_arg
Trimite argumentul opt_or_arg ca opțiune sau argument de opțiune față de real groff
postprocesor.

--T devname | --dispozitiv devname
Această opțiune determină groffdispozitivul de ieșire al lui. Cele mai importante dispozitive sunt
dispozitive de ieșire a textului pentru referire la diferitele seturi de caractere, cum ar fi ascii,
utf8, latin1, utf8, si altii. Fiecare dintre aceste argumente se schimbă groffer într-o
a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. mod folosind acest dispozitiv, pentru a mod tty dacă modul real nu este a a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. mod.
Următoarele devname argumentele sunt mapate la cele corespunzătoare groffer
--mode=devname opţiune: dvi, html și ps. Toate X* argumentele sunt mapate la mod x.
Fiecare devname argumentul trece la mod groff folosind acest dispozitiv.

--X este echivalent cu groff -X. Acesta afișează groff intermediar producție cu
gxditview. Deoarece calitatea este relativ proastă, această opțiune este depreciată; utilizare --X
în schimb pentru că x mod folosește un X* dispozitiv pentru o afișare mai bună.

-Z | --ieșire-intermediară | --ditroff
Comutați în groff mod și formatați intrarea cu groff intermediar producție
fără postprocesare; vedea groff_out(5). Aceasta este echivalentă cu opțiunea --ditroff
of om, care poate fi folosit și.

Toti ceilalti groff opțiunile sunt acceptate de groffer, dar sunt doar transparente
Transferat către groff fara nicio interventie. Opțiunile care nu sunt în mod explicit
manevrat de groffer sunt transmise în mod transparent groff. Prin urmare, aceste opțiuni transparente
nu sunt documentate aici, ci în groff(1). Datorită automatismului în groffer, nici unul dintre acestea
groff ar trebui să fie necesare opțiuni, cu excepția utilizării avansate.

Opţiuni pentru om pagini
--apropos
Porniți oportun(1) comanda sau facilitate de om(1) pentru căutarea fisierspec
argumente în cadrul tuturor om pagină descrieri. Fiecare fisierspec argumentul este luat pentru
caută așa cum este; secțiune anumite piese nu sunt manipulate, astfel încât 7 groff Cautari
pentru cele două argumente 7 si groff, cu un rezultat mare; pentru fisierspec groff.7
nu se va găsi nimic. The limbă localul este gestionat numai atunci când este apelat
programele susțin acest lucru; GNU oportun si om -k nu face. Afișajul diferă
de la oportun program prin următoarele concepte:

* Construiți a groff cadru asemănător cu a om pagină la ieșirea de oportun,

* fiecare fisierspec argumentul este căutat de la sine.

* Restricția de către --secțiuni este de asemenea tratat,

* Caracterele wildcard sunt permise și gestionate fără o altă opțiune.

--apropos-date
Arată numai oportun descrieri pentru documentele de date, acestea sunt om(7)
secțiuni 4, 5 și 7. Direct secțiune declarațiile sunt ignorate, metacaracterele sunt
admis.

--apropos-devel
Arată numai oportun descrieri pentru documentele de dezvoltare, acestea sunt om(7)
secțiuni 2, 3 și 9. Direct secțiune declarațiile sunt ignorate, metacaracterele sunt
admis.

--apropos-progs
Arată numai oportun descrieri pentru documente pe programe, acestea sunt om(7)
secțiuni 1, 6 și 8. Direct secțiune declarațiile sunt ignorate, metacaracterele sunt
admis.

--ce este
Pentru fiecare fisierspec argumente caută toate om pagini și afișați descrierea acestora — sau
spune că nu este o om pagină. Acesta este scris din nou, deci diferă de om's
ce este produs de următoarele concepte

* fiecare nume de fișier preluat este adăugat,

* fișierele locale sunt gestionate, de asemenea,

* limbă si sistem localitatea este acceptată,

* afișajul este încadrat de a groff format de ieșire similar cu a om pagină,

* Caracterele wildcard sunt permise fără o altă opțiune.

Au fost adăugate următoarele opțiuni groffer pentru a alege dacă argumentele numelui fișierului
sunt interpretate ca nume pentru fișierele locale sau ca un model de căutare pentru om pagini.
implicit caută fișiere locale.

--om Verificați argumentele din linia de comandă fără opțiuni (specificațiile fișierelor) mai întâi pe a fi om pagini,
apoi dacă reprezintă un fișier existent. În mod implicit, a fisierspec este primul
a testat dacă este un fișier existent.

--nici un om | --local-file
Nu verifica pentru om pagini. --local-file este corespunzătoare om opțiune.

--nu-special
Dezactivați apelurile anterioare ale --toate, --apropos* și --ce este.

Lung Opțiuni luate peste din GNU om
Opțiunile lungi ale groffer au fost sincronizate cu opțiunile lungi ale GNU om. Tot lung
opțiunile GNU om sunt recunoscute, dar nu toate aceste opțiuni sunt importante pentru groffer,
deci majoritatea sunt doar ignorate. Acestea ignorate om opțiunile sunt --Omul pisica, --troff și
--Actualizați.

În cele ce urmează, om opțiuni care au o semnificație specială pentru groffer sunt documentate.

Dacă sistemul dumneavoastră are GNU om a instalat setul complet de opțiuni lungi și scurte ale GNU om
programul poate fi transmis prin variabila de mediu $MANOPT; vedea om(1).

--toate În căutare om pagini, preluați toate documentele adecvate în loc de doar unul.

-7 | --ascii
In a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. moduri de, afișați traducerea ASCII a caracterelor speciale pentru critice
mediu inconjurator. Aceasta este echivalentă cu groff -mtty_char; vedea groff_tmac(5).

--ditroff
Produce groff intermediar producție. Acest lucru este echivalent cu groffer -Z.

--extensie sufix
restrânge om pagină căutați la nume de fișiere care au sufix anexate la secțiunea lor
element. De exemplu, în numele fișierului /usr/share/man/man3/terminfo.3ncurses.gz
il om pagină extensia este ncursuri.

--locale limbă
Setați limba pentru om pagini. Acesta are același efect, dar suprascrie $LANG.

--Locație
Tipăriți locația fișierelor preluate la eroare standard.

--fără locație
Nu afișați locația fișierelor preluate; aceasta resetează un apel anterior la
--Locație. Aceasta a fost adăugată de groffer.

--manpath 'dir1:dir2:....'
Utilizați calea de căutare specificată pentru recuperare om pagini în locul programului
implicite. Dacă argumentul este setat la șirul gol „”, căutați om pagină is
dezactivat.

--pager
Setați programul pager în tty mod; implicit este mai puțin. Acesta poate fi setat cu --vizor.

--secțiuni sec1:sec2:....
Restricționați căutarea om pagini la dat secțiuni, o listă separată prin două puncte.

--sisteme sys1,sys2,....
Caută om pagini pentru sistemele de operare date; argumentul sisteme este
listă separată prin virgulă.

--Unde
Echivalentă cu --Locație.

X Fereastră Setul de instrumente Opţiuni
Următoarele opțiuni lungi au fost adaptate din opțiunile X Window Toolkit corespunzătoare.
groffer le va transmite programului de vizualizare real dacă este un program X Window.
În caz contrar, aceste opțiuni sunt ignorate.

Din păcate, aceste opțiuni folosesc stilul vechi al unui singur minus pentru opțiunile lungi. Pentru
groffer care a fost schimbat la standard cu utilizarea unui minus dublu pentru opțiunile lungi, pt
exemplu, groffer folosește opțiunea --font pentru opțiunea X Window -font.

Vedea X(7) și documentația despre opțiunile X Window Toolkit pentru mai multe detalii despre acestea
opțiunile și argumentele acestora.

--fundal culoare
Setați culoarea de fundal a ferestrei de vizualizare.

--bd pixeli
Aceasta este echivalentă cu --bordercolor.

--bg culoare
Aceasta este echivalentă cu --fundal.

--bw pixeli
Aceasta este echivalentă cu --lățimea graniței.

--bordercolor pixeli
Specifică culoarea chenarului din jurul ferestrei de vizualizare.

--lățimea graniței pixeli
Specifică lățimea în pixeli a chenarului din jurul ferestrei de vizualizare.

--afişa Afișaj X
Setați afișajul X Window pe care va fi pornit programul de vizualizare, consultați
X Documentație fereastră pentru sintaxa argumentului.

--prim plan culoare
Setați culoarea primului plan a ferestrei de vizualizare.

--fg culoare
Aceasta este echivalentă cu --prim plan.

--fn font_name
Aceasta este echivalentă cu --font.

--font font_name
Setați fontul utilizat de fereastra de vizualizare. Argumentul este un nume de font X Window.

--ft font_name
Aceasta este echivalentă cu --font.

--geometrie dimensiune_poz
Setați geometria ferestrei de afișare, adică dimensiunea și pornirea acesteia
poziţie. Vedea X(7) pentru sintaxa argumentului.

--rezoluţie valoare
Setați rezoluția X Window în dpi (puncte pe inch) în unele programe de vizualizare. Singura
valorile dpi acceptate sunt 75 si 100. De fapt, rezoluția implicită pentru groffer
este setat la 75dpi. Rezoluția setează și dispozitivul implicit mod x.

--rv Inversați culoarea primului plan și a fundalului ferestrei de vizualizare.

--titlu 'niste text'
Setați titlul pentru fereastra de vizualizare.

--xrm 'resursă'
Setați resursa X Window.

Opţiuni pentru Dezvoltare
--depanare
Activați toate opțiunile de depanare --depanare-tip. Fișierele temporare sunt păstrate și nu
șters, the Grog ieșirea este tipărită, numele directorului temporar este
sunt tipărite, numele fișierelor afișate sunt tipărite, iar parametrii sunt tipăriți.

--debug-filenames
Tipăriți numele fișierelor și om pagini care sunt afișate de groffer.

--debug-grog
Tipăriți rezultatul tuturor Grog comenzi.

--debug-keep
Activați două informații de depanare. Tipăriți numele directorului temporar și
păstrați fișierele temporare, nu le ștergeți în timpul rulării groffer.

--debug-params
Tipăriți parametrii, obținuți din fișierele de configurare, de la GROFFER_OPT,
și argumentele liniei de comandă.

--debug-tmpdir
Tipăriți numele directorului temporar.

--nu face nimic
Aceasta este ca. --versiune, dar fără ieșire; niciun vizualizator nu este pornit. Asta face
numai simț în dezvoltare.

--print=a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match.
Doar imprimați argumentul la eroare standard. Acest lucru este bun pentru verificarea parametrilor.

-V Aceasta este o opțiune avansată numai pentru depanare. În loc să afișați formatul
intrare, o mulțime de groffer informații specifice sunt tipărite la ieșire standard:

* numele fișierului de ieșire în directorul temporar,

* modul de afișare a actualului groffer alerga,

* programul de afișare pentru vizualizarea ieșirii cu argumentele sale,

* parametrii activi din fișierele de configurare, argumentele din $GROFFER_OPT și
argumentele liniei de comandă,

* conducta care ar fi condusă de groff program, dar fără a-l executa.

Alte opțiuni utile de depanare sunt groff opțiune -Z si --mode=groff.

Filespec Argumente
A fisierspec parametrul este un argument care nu este un argument de opțiune sau opțiune. În groffer,
fisierspec parametrii sunt un nume de fișier sau un șablon pentru căutare om pagini. Aceste intrări
sursele sunt colectate și compuse într-un singur fișier de ieșire, cum ar fi groff nu.

Comportamentul ciudat POSIX de a considera toate argumentele din spatele primului argument fără opțiune ca
fisierspec argumentele sunt ignorate. Comportamentul GNU de a recunoaște opțiunile chiar și atunci când este amestecat cu
fisierspec argumentele sunt folosite pe tot parcursul. Dar, ca de obicei, argumentul dublu minus -- se încheie
opțiunea care gestionează și interpretează toate argumentele următoare ca fisierspec argumente; asa ca
Comportamentul POSIX poate fi adoptat cu ușurință.

Opțiunile --apropos* au o manipulare specială a fisierspec argumente. Fiecare argument este
luată ca o schemă de căutare proprie. De asemenea, o expresie regulată (expresie regulată) poate fi folosită în
spec. De exemplu, groffer --apropos '^gro.f$' Cautari groff în om pagină
nume, în timp ce groffer --apropos groff Cautari groff undeva în numele sau descrierea
il om pagini.

Toate celelalte părți ale groffer, cum ar fi afișajul normal sau ieșirea cu --ce este ia o
schema diferita pentru specificațiile fișierelor. Nu se folosesc expresii regulate pentru argumente. The
fisierspec argumentele sunt tratate prin următoarea schemă.

Este necesar să știți că pe fiecare sistem om pagini sunt sortate conform lor
conținut în mai multe secțiuni. The clasic om secțiuni au un nume cu un singur caracter,
fie o cifră din 1 la 9 sau unul dintre personaje n or o.

Aceasta poate fi urmată opțional de un șir, așa-numitul extensie. extensie
permite stocarea mai multor om pagini cu acelasi nume in acelasi secțiune. Cu exceptia
extensie este folosit doar rar, de obicei este omis. Apoi extensii sunt căutate
automat după alfabet.

În cele ce urmează, folosim numele section_extension pentru un cuvânt care constă dintr-un singur
caracter secțiune nume sau a secțiune caracter care este urmat de un extensie. Fiecare
fisierspec parametrul poate avea una dintre următoarele forme în secvență descrescătoare.

* Nu fisierspec parametrii înseamnă că groffer așteaptă intrarea standard. Opțiunea în minus -
reprezintă întotdeauna intrare standard; poate apărea de mai multe ori. Dacă doriți să căutați un
om pagină denumit - folosește argumentul om:-.

* În continuare a fisierspec este testat dacă este numele căii unui fișier existent. Altfel ea
se presupune a fi un model de căutare pentru a om pagină.

* om:nume(section_extension), om:nume.section_extension, nume(section_extension), or
nume.section_extension caută pagina de manual nume in sectiunea man si eventual extindere a
section_extension.

* Acum om:nume caută a om pagină în cel mai de jos om secțiune care are un document
denumit nume.

* section_extension nume este un model de 2 argumente care provine dintr-un ciudat
analiza argumentului om program. Din nou, aceasta caută în pagina de manual nume cu
section_extension, o combinație de a secțiune caracter urmat opțional de un
extensie.

* Rămânem cu argumentul nume care nu este un fișier existent. Deci asta caută
il om pagină denumit nume în cel mai de jos om secțiune care are un document pentru acest nume.

Pot fi furnizate mai multe argumente de nume de fișier. Sunt amestecate de groff într-o singură
document. Rețineți că setul de argumente ale opțiunii trebuie să se potrivească tuturor acestor argumente ale fișierului.
Deci ar trebui să aibă cel puțin același stil groff limba.

REZULTATE MODURI

Implicit, groffer programul colectează toate intrările într-un singur fișier, îl formatează cu
groff program pentru un anumit dispozitiv și apoi alege un program de vizualizare potrivit. The
dispozitiv și vizualizator proces în groffer se numește a mod. Modul și vizualizatorul unei alergări
groffer programul este selectat automat, dar utilizatorul îl poate alege și cu opțiuni.
Modurile sunt selectate prin opțiunea argumentelor --mode=oricum. În plus, fiecare dintre
acest argument poate fi specificat ca o opțiune proprie, cum ar fi oricum. Cele mai multe dintre acestea
modurile au un program de vizualizare, care poate fi ales prin opțiune --vizor.

Sunt oferite mai multe moduri diferite, moduri grafice pentru X Window, a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. moduri de, si ceva
direcționa groff moduri de pentru depanare și dezvoltare.

În mod implicit, groffer mai întâi încearcă dacă x mod este posibil, atunci ps mod, și, în sfârșit
tty mod. Această secvență de testare a modului pentru Auto mod poate fi schimbat prin specificarea unei virgule
listă separată de moduri cu opțiunea --modurile-implicite.

Căutarea om pagini iar decompresia intrării sunt active în fiecare mod.

Grafic Afişa Moduri
Modurile de afișare grafică funcționează mai ales în mediul X Window (sau similar
implementări în alte medii de ferestre). Variabila de mediu $DISPLAY
si optiunea --afişa sunt utilizate pentru a specifica afișajul X Window care va fi utilizat. Dacă aceasta
variabila de mediu este goală groffer presupune că nicio fereastră X nu rulează și se schimbă în a
a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. mod. Puteți modifica acest comportament automat prin opțiune --modurile-implicite.

Vizualizatori cunoscuți pentru modurile de afișare grafică și programele lor standard de vizualizare X Window
sunt

* într-un vizualizator PDF (pdf mod)

* într-un browser web (html or www mod)

* într-un vizualizator Postscript (ps mod)

* Fereastra X roff telespectatori precum gxditview(1) sau xditview(1) (în x mod)

* într-un program de vizualizare dvi (dvi mod)

pdf mod are un avantaj major — este singurul mod de afișare grafică care permite
căutarea textului în vizualizator; aceasta poate fi o caracteristică cu adevărat importantă. Din pacate,
este nevoie de ceva timp pentru a transforma intrarea în format PDF, așa că nu a fost ales ca
modul major.

Aceste vizualizatoare grafice pot fi personalizate prin opțiunile setului de instrumente X Window. Cu exceptia
groffer opțiunile folosesc un minus dublu de început în loc de minusul simplu folosit de
Setul de instrumente X Window.

Text moduri de
Există două moduri de ieșire a textului, mod a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. pentru ieșire simplă fără paginator și
mod tty pentru o ieșire de text pe un terminal de text folosind un program de paginare.

Dacă variabila $DISPLAY nu este setat sau gol, groffer presupune că ar trebui să folosească tty mod.

În implementarea efectivă, groff dispozitiv de ieșire latin1 este ales pentru a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. moduri de.
Acest lucru poate fi modificat prin specificarea opțiunii -T or --dispozitiv.

Paginarul de utilizat poate fi specificat printr-una dintre opțiuni --pager si --vizor, sau de
variabila de mediu $PAGER. Dacă toate acestea nu sunt folosite, mai puțin(1) program cu
opțiune -r pentru afișarea corectă a secvențelor de control este folosit ca paginator implicit.

Special Moduri pentru Depanarea si Dezvoltare
Aceste moduri folosesc groffer determinarea și decompresia fișierelor. Aceasta este combinată într-un
un singur fișier de intrare care este introdus direct în groff cu strategie diferită fără
groffer facilitati de vizionare. Aceste moduri sunt considerate avansate, sunt utile pentru
scopuri de depanare și dezvoltare.

sursă mod cu optiune --sursă afișează doar intrarea decomprimată.

Opțiune --la-stdout nu se afișează într-un mod grafic. Doar generează fișierul pentru
modul ales și apoi își imprimă conținutul la ieșire standard.

groff mod transmite intrarea către groff folosind doar unele opțiuni adecvate oferite
groffer. Acest lucru permite utilizatorului să salveze rezultatul generat într-un fișier sau să o conecteze
alt program.

In groff mod, optiunea -Z dezactivează post-procesarea, producând astfel groff
intermediar producție. În acest mod, intrarea este formatată, dar nu este postprocesată; vedea
groff_out(5) pentru detalii.

TOATE groff opțiunile scurte sunt susținute de groffer.

MAN PAGINĂ IN CAUTAREA

Comportamentul implicit al groffer este de a testa mai întâi dacă un parametru de fișier reprezintă a
fisier local; dacă nu este un nume de fișier existent, se presupune că reprezintă numele unui
om pagină. Următoarele opțiuni pot fi utilizate pentru a determina dacă argumentele ar trebui să fie
tratate ca nume de fișier sau om pagină argumente.

--om forțează să interpreteze toți parametrii fișierului ca specificațiile fișierelor pentru căutare om pagini.

--nici un om
--local-file
dezactivați om in cautarea; deci sunt afișate numai fișierele locale.

Dacă nici un fișier local, nici un om pagină a fost preluat pentru un parametru de fișier este un avertisment
emis pe o eroare standard, dar procesarea este continuată.

Caută Algoritm
Să presupunem acum că a om pagină ar trebui căutat. The groffer programul oferă a
facilitate de căutare pentru om pagini. Toate opțiunile lungi, toate variabilele de mediu și majoritatea
funcționalitatea GNU om(1) au fost implementate programul. Algoritmul de căutare trebuie
determinați ce fișier este afișat pentru un anumit om pagină. Procesul poate fi modificat prin
opțiuni și variabile de mediu.

Numai om acțiune care este omisă în groffer sunt preformatate om pagini, De asemenea, numit
pisică pagini. Cu performanța excelentă a computerelor reale, cele preformatate
om pagini nu mai sunt necesare. În plus, groffer este roff program; vrea
a citi roff fișierele sursă și formatați-le singur.

Algoritmul pentru preluarea fișierului pentru a om pagină are nevoie mai întâi de un set de directoare.
Acest set începe cu așa-numitul om cale care se modifică mai târziu prin adăugarea numelor de
de operare sistem si limbă. Acest set care apare este folosit pentru adăugarea secțiunii
directoarele care conțin om pagină fișiere.

om cale este o listă de directoare care sunt separate prin două puncte. Este generat de
următoarele metode.

* Variabila de mediu $MANPATH poate fi setat.

* Poate fi citit din argumentele variabilei de mediu $MANOPT.

* om cale poate fi specificat manual folosind opțiunea --manpath. Un argument gol
dezactivează om pagină in cautarea.

* Când nu om cale a fost setat cale_man(1) programul este încercat să determine unul.

* Dacă acest lucru nu funcționează, o cale implicită rezonabilă de la $ PATH este determinat.

Acum avem un set inițial de directoare. Prima modalitate de a schimba acest set este prin adăugare
nume ale de operare sisteme. Aceasta presupune că om pagini pentru cateva de operare sisteme sunt
instalat. Acest lucru nu este întotdeauna adevărat. Numele unor astfel de de operare sisteme pot fi furnizate
prin 3 metode.

* Variabila de mediu $SYSTEM are cea mai mică prioritate.

* Aceasta poate fi înlocuită de o opțiune în $MANOPT.

* Aceasta din nou este suprascrisă de opțiunea din linia de comandă --sisteme.

Mai multe nume de de operare sisteme pot fi date prin adăugarea numelor acestora, separate prin a
virgulă.

om cale se modifică prin adăugarea fiecăruia sistem nume ca subdirector la sfârșitul fiecăruia
directorul setului. Niciun director al om cale setul este păstrat. Dar dacă nu sistem numele este
a specificat om cale este lăsat neschimbat.

După aceasta, setul real de directoare poate fi schimbat prin limbă informație. Acest
presupune că există om pagini în diferite limbi. The Wanted limbă poate fi
alese prin mai multe metode.

* Variabilă de mediu $LANG.

* Aceasta este înlocuită de $LC_MESSAGES.

* Aceasta este înlocuită de $LC_ALL.

* Aceasta poate fi anulată prin furnizarea unei opțiuni în $MANOPT.

* Toate aceste variabile de mediu sunt înlocuite de opțiunea din linia de comandă --locale.

lipsă limbă poate fi specificat prin specificarea unuia dintre parametrii de pseudo-limbaj
C sau POSIX. Este ca și cum ai șterge o dată anterior limbă informație. The om pagini
în lipsă limbă sunt de obicei în engleză.

Desigur, limbă numele este determinat de om. În GNU om, este specificat în
Format bazat pe POSIX 1003.1:

[_[.[,]]],

dar codul din două litere în este suficient pentru majoritatea scopurilor. Dacă pentru a
complicat limbă formularea nr om pagini sunt găsite groffer caută partea de țară
format și din aceste prime două personaje.

Setul real de directoare este copiat de trei ori. The limbă numele este adăugat ca subdirector
la fiecare director din prima copie a setului de directoare real (acest lucru se face numai atunci când a
se oferă informații despre limbă). Apoi abrevierea din 2 litere a lui limbă numele este
atașat ca subdirectoare la a doua copie a setului de directoare (acest lucru se face numai când
numele limbii date are mai mult de 2 litere). A treia copie a setului de directoare este
păstrat neschimbat (dacă nu limbă informațiile sunt date, acesta este directorul păstrat).
Aceste maxim 3 copii sunt atașate pentru a obține noul set de director.

Acum avem un set complet de directoare cu care să lucrăm. În fiecare dintre aceste directoare,
om fișierele sunt separate în secțiuni. Numele lui a secțiune este reprezentat de un singur
caracter, o cifră între 1 si 9, sau personajul o or n, in aceasta ordine.

Pentru fiecare disponibil secțiune, un subdirector om există conţinând toate om fișiere
pentru asta secțiune, În cazul în care este un singur caracter așa cum este descris mai sus. Fiecare om
fișier într-un secțiune directorul are forma
om/.[ ][.], În cazul în care si
sunt opționale. este numele om pagină care este de asemenea specificat ca
argument filespec pe linia de comandă.

extensie este o completare la secțiune. Acest postfix acționează ca o subsecțiune. Un
extensie apare numai în numele fișierului, nu în numele fișierului secțiune subdirectorul. Se poate
fi specificat pe linia de comandă.

Pe de altă parte, comprimare este doar o informație despre modul în care fișierul este comprimat.
Acest lucru nu este important pentru utilizator, astfel încât nu poate fi specificat pe linia de comandă.

Există 4 metode pentru a specifica a secțiune pe linia de comandă:

* Variabilă de mediu $MANSECT

* Opțiunea de linie de comandă --secțiuni

* Anexa la nume argument în formă .

* Preargument înainte de nume argument în formă

De asemenea, se pot specifica mai multe secțiuni prin adăugarea caracterelor individuale
separate prin două puncte. Ne putem imagina că aceasta înseamnă a restricționa om pagină caută la
doar câteva secțiuni. Multiplul secțiuni sunt posibile numai pentru $MANSECT si --secțiuni.

Daca nu secțiune este specificat toate secțiuni sunt căutate unul după altul în date
comanda, incepand cu secțiune 1, până când este găsit un fișier adecvat.

Există 4 metode de a specifica un extensie pe linia de comandă. Dar nu este necesar
pentru a furniza numele întregului extensie, o abreviere este suficient de bună în majoritatea cazurilor.

* Variabilă de mediu $EXTENSIE

* Opțiunea de linie de comandă --extensie

* Anexa la . argument în formă .

* Preargument înainte de nume argument în formă

Pentru mai multe detalii despre om pagină căutând, vezi om(1).

Exemple of om fișiere
/usr/share/man/man1/groff.1
Acesta este un fișier necomprimat pentru om pagină groff in secțiune 1. Se poate numi
by
SH# groffer groff
Nu secțiune este specificat aici, deci toate secțiuni ar trebui căutat, dar ca secțiune 1
este căutat primul acest fișier va fi găsit primul. Numele fișierului este compus din
următoarele componente. / usr / share / man / trebuie să facă parte din om cale;
subdirector om1/ iar partea .1 stand pentru secțiune; groff este numele
om pagină.

/usr/local/share/man/man7/groff.7.gz
Numele fișierului este compus din următoarele componente. /usr/local/share/man trebuie sa
fi parte din om cale; subdirectorul om7/ iar partea .7 stand pentru
secțiune; groff este numele om pagină; partea finală .gz reprezintă o
compresie cu gzip(1). Dupa cum secțiune nu este primul care trebuie specificat
de asemenea. Acest lucru se poate face cu una dintre următoarele comenzi.
SH# groffer groff.7
SH# groffer 7 groff
SH# groffer --sections=7 groff

/usr/local/man/man1/ctags.1emacs21.bz2
Aici / usr / local / man trebuie să fie înăuntru om cale; subdirectorul om1/ și numele fișierului
parte .1 stand pentru secțiune 1; numele om pagină is ctag-uri; sectiunea are o
extensie emacs21; iar fișierul este comprimat ca .bz2 cu bzip2(1). Dosarul poate
să fie vizualizat cu una dintre următoarele comenzi
SH# groffer ctags.1e
SH# groffer 1e ctags
SH# groffer --extension=e --sections=1 ctags
unde e funcționează ca o abreviere pentru extensia emacs21.

/usr/man/linux/de/man7/man.7.Z
Directorul / usr / man face parte acum din om cale; apoi există un subdirector
pentru o de operare sistem nume linux/; Urmează un subdirector de / pentru neamț
limbă; secțiune nume man7 si .7 sunt cunoscute până acum; om este numele
om paginăŞi .Z semnifică compresia care poate fi gestionată de gzip(1). Noi vrem
acum arătați cum să furnizați mai multe valori pentru unele opțiuni. Asta este posibil pentru
secțiuni si de operare sistem nume. Deci folosim ca secțiuni 5 si 7 și ca sistem
nume linux si aix. Comanda este atunci

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

DECOMPRESIE

Programul are o facilitate de decompresie. Dacă intrarea standard sau un fișier care a fost preluat
din linia de comandă parametrii este comprimat cu un format care este acceptat de oricare
gzip(1) sau bzip2(1) este decomprimat din mers. Aceasta include GNU .gz, .bz2 și
traditionalul .Z comprimare. Programul afișează concatenarea tuturor
intrare decomprimată în secvența care a fost specificată pe linia de comandă.

MEDIUL

groffer programul acceptă multe variabile de sistem, majoritatea prin amabilitatea altora
programe. Toate variabilele de mediu ale groff(1) și GNU om(1) și un sistem standard
variabilele sunt onorate.

Nativ groffer Variabile
$GROFFER_OPT
Opțiuni de stocare pentru o serie de groffer. Opțiunile specificate în această variabilă sunt
suprascris de opțiunile oferite pe linia de comandă. Conținutul acestei variabile
este rulat prin shell-ul încorporat „eval”; deci argumente care conțin spații albe sau
caracterele speciale de shell trebuie citate. Nu uitați să exportați această variabilă,
altfel nu există în timpul rulării groffer.

Sistem Variabile
Următoarele variabile au o semnificație specială pentru groffer.

$DISPLAY
Dacă această variabilă este setată, aceasta indică faptul că sistemul X Window rulează.
Testarea acestei variabile decide dacă este generată rezultatul grafic sau text.
Această variabilă nu ar trebui schimbată de utilizator cu neglijență, dar poate fi folosită
începe graficul groffer pe un terminal X Window la distanță. De exemplu, în funcție
pe sistemul dvs., groffer poate fi pornit pe al doilea monitor prin comandă

SH# DISPLAY=:0.1 groffer what.ever &

$LC_ALL
$LC_MESSAGES
$LANG Dacă una dintre aceste variabile este setată (în secvența de mai sus), conținutul acesteia este
interpretată ca localitate, limba care trebuie utilizată, în special la preluare
om pagini. Un nume local este de obicei de formă
limbă[_teritoriu[.set de coduri[@schimbare]]], Unde limbă este un limbaj ISO 639
cod, teritoriu este un cod de țară ISO 3166 și set de coduri este un set de caractere sau
identificator de codificare precum ISO-8859-1 sau UTF-8; vedea setlocale(3). Valorile locale
C și POSIX reprezintă implicit, adică om pagină directoare fără limbă
prefix. Acesta este același comportament ca atunci când toate cele 3 variabile sunt nesetate.

$PAGER Această variabilă poate fi utilizată pentru a seta paginatorul pentru ieșirea tty. De exemplu, să
dezactivați utilizarea unui pager setați complet această variabilă la pisică(1) program

SH# PAGER=cat groffer orice

$ PATH Toate programele din cadrul groffer scripturile sunt apelate fără o cale fixă. Astfel aceasta
variabila de mediu determină setul de programe utilizate în timpul rulării groffer.

Groff Variabile
groffer apelurile interne ale programului groff, deci toate variabilele de mediu documentate în
groff(1) sunt utilizate intern în interiorul groffer de asemenea. Următoarea variabilă are un direct
sens pentru groffer programul.

$GROFF_TMPDIR
Dacă valoarea acestei variabile este un director existent, care poate fi scris, groffer îl folosește
pentru stocarea fișierelor sale temporare, la fel ca groff face. Vezi groff(1) pagină de manual pentru
mai multe detalii despre locația fișierelor temporare.

Barbat Variabile
Părți ale funcționalității om programul au fost implementate în groffer; sprijin pentru toti
variabilele de mediu documentate în om(1) a fost adăugat la groffer, dar sensul era
ușor modificată datorită abordării diferite în groffer; dar interfața cu utilizatorul este
la fel. The om variabilele de mediu pot fi suprascrise de opțiunile furnizate cu $MANOPT,
care la rândul său este suprascris de linia de comandă.

$EXTENSIE
Restricționați căutarea pentru om pagini la fișierele care au această extensie. Aceasta este
înlocuit de opțiune --extensie; vezi acolo pentru detalii.

$MANOPT
Această variabilă conține opțiuni ca presetare pentru om(1). Cum nu toate acestea sunt
relevante pentru groffer sunt extrase doar părțile esențiale ale valorii sale. The
opțiunile specificate în această variabilă suprascriu valorile celuilalt mediu
variabile care sunt specifice om. Toate opțiunile specificate în această variabilă sunt
suprascris de opțiunile date pe linia de comandă.

$MANPATH
Dacă este setată, această variabilă conține directoarele în care om pagină copacii sunt
stocate. Aceasta este înlocuită de opțiune --manpath.

$MANSECT
Dacă aceasta este o listă de nume de secțiuni separate prin puncte, se caută om pagini is
limitat la acele secțiuni ale manualului în această ordine. Aceasta este înlocuită de opțiune
--secțiuni.

$SYSTEM
Dacă aceasta este setată la o listă de nume separate prin virgulă, acestea sunt interpretate ca om pagină
arbori pentru diferite sisteme de operare. Această variabilă poate fi suprascrisă prin opțiune
--sisteme; vezi acolo pentru detalii.

Variabila de mediu $MANROFFSEQ este ignorat de groffer deoarece necesarul
preprocesoarele sunt determinate automat.

CONFIGURARE DOSARE

groffer programul poate fi preconfigurat prin două fișiere de configurare.

/etc/groff/groffer.conf
Fișier de configurare la nivel de sistem pentru groffer.

$HOME/.groff/groffer.conf
Fișier de configurare specific utilizatorului pentru groffer, În cazul în care $ ACASĂ denotă casa utilizatorului
director. Acest fișier este apelat după fișierul de configurare la nivel de sistem pentru activare
depășirea de către utilizator.

Ambele fișiere sunt gestionate pentru configurare, dar fișierul de configurare în / Etc vine
primul; este suprascris de fișierul de configurare din directorul principal; ambii
fișierele de configurare sunt suprascrise de variabila de mediu $GROFFER_OPT; Tot
este suprascris de argumentele liniei de comandă.

Fișierele de configurare conțin opțiuni care ar trebui apelate implicit pentru fiecare groffer
alerga. Aceste opțiuni sunt scrise în rânduri astfel încât fiecare să conțină fie o opțiune lungă, a
opțiune scurtă sau un cluster de opțiuni scurte; fiecare cu sau fără argument. Deci fiecare linie
cu informații de configurare începe cu un caracter minus `-'; o linie cu un lung
opțiunea începe cu două caractere minus `--', o linie cu opțiune scurtă sau opțiune scurtă
cluster începe cu un singur minus `-'.

Este posibil ca numele opțiunilor din fișierele de configurare să nu fie prescurtate, trebuie să fie exacte.

Argumentul pentru o opțiune lungă poate fi separat de numele opțiunii fie printr-un egal
semn `=' sau prin spații albe, adică unul sau mai multe spații sau caractere tabulatoare. Un argument pentru a
opțiunea scurtă sau clusterul de opțiuni scurte pot fi atașate direct la numele opțiunii sau
separate prin spații albe. Sfârșitul unui argument este sfârșitul liniei. Nu este
permis să utilizeze o variabilă de mediu shell într-un nume de opțiune sau un argument.

Nu este necesar să folosiți ghilimele într-o opțiune sau argument, cu excepția argumentelor goale.
Un argument gol poate fi furnizat prin adăugarea unei perechi de ghilimele la egalul de separare
semn sau spațiu alb; cu o opțiune scurtă, separatorul poate fi de asemenea omis. Pentru mult
opțiunea cu semnul egal de separare `=', perechea de ghilimele poate fi omisă, terminându-se astfel
linia cu semnul egal de separare. Toate celelalte ghilimele sunt anulate
intern.

În fișierele de configurare, sunt permise spații albe arbitrare la începutul fiecărei linii,
este doar ignorat. Fiecare spațiu alb dintr-o linie este înlocuit cu un singur caracter spațiu
` ' pe plan intern.

Toate liniile liniilor de configurare care nu încep cu un caracter minus sunt ignorate,
astfel încât comentariile care încep cu `#' sunt posibile. Deci nu există comenzi shell în
fișiere de configurare.

Ca exemplu, luați în considerare următorul fișier de configurare care poate fi utilizat fie în
/etc/groff/groffer.conf or ~/.groff/groffer.conf .

# fișier de configurare groffer
#
# opțiuni groffer care sunt utilizate în fiecare apel de groffer
--foreground=Albastru închis
--resolution=100
--viewer=gxditview -geometry 900x1200
--viewer xpdf -Z 150

Rândurile care încep cu # sunt doar ignorate, deci acţionează ca linii de comandă. Acest
configurație seturi patru groffer opțiuni (liniile care încep cu `-'). Aceasta are
urmatoarele efecte:

* Folosiți o culoare de text de Albastru inchis în toți telespectatorii care susțin acest lucru, cum ar fi gxditview.

* Utilizați o rezoluție de 100dpi în toți telespectatorii care susțin acest lucru, cum ar fi gxditview. De
acesta, dispozitivul implicit în x mod este setat la X100.

* Forta gxditview(1) ca modul x vizualizatorul utilizând opțiunea de geometrie pentru setarea lățimii
la 900px iar înălțimea până la 1200px. Această geometrie este potrivită pentru o rezoluție de
100dpi.

* Utilizare xpdf(1) ca modul pdf privitorul cu argumentul -Z 150.

EXEMPLE

Utilizarea groffer Este foarte ușor. De obicei, este numit doar cu un nume de fișier sau
om pagină. Următoarele exemple arată însă că groffer are mult mai multă fantezie
capacităţi.

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

Decomprimați, formatați și afișați fișierul comprimat meintro.ms.gz în director
/usr/local/share/doc/groff, folosind vizualizatorul standard gxditview ca vizualizator grafic când
în X Window sau în mai puțin(1) program de paginare când nu este în X Window.

SH# groffer groff

Dacă dosarul ./groff există folosiți-l ca intrare. În caz contrar, interpretați argumentul ca pe o căutare
pentru om pagină numit groff în cel mai mic posibil om secțiune, fiind secțiunea 1 din aceasta
caz.

SH# groffer man:groff

căutați om pagină of groff chiar şi atunci când dosarul ./groff există.

SH# groffer groff.7
SH# groffer 7 groff

căutați în om pagină of groff in om secțiune 7. Această secțiune de căutare funcționează numai pentru o cifră
sau un singur personaj dintr-un set mic.

SH# groffer fb.modes

Dacă dosarul ./fb.modes nu există interpreta asta ca o căutare a om pagină of
fb.moduri. Ca extensie moduri de nu este un singur personaj în stilul secțiunii clasice
argumentul nu este împărțit într-o căutare pentru fb.

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

Argumentele care nu sunt fișiere existente sunt căutate după cum urmează om pagini: groff
(căutare automată, ar trebui găsită în om sectiunea 1), troff (în secțiunea 1) și roff (În
secțiunea cu numărul cel mai mic, fiind 7 în acest caz). Citatele din jur "troff(1)'
sunt necesare deoarece parantezele sunt caractere speciale de shell; scăpându-le cu a
caracter backslash \( si \) ar fi posibil, de asemenea. Fișierele formatate sunt
concatenate și afișate într-o singură bucată.

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

Preluați germanul om pagină (limba de) pentru ls program, decomprimați-l, formatați-l la
html format (www mod) și vizualizați rezultatul în browserul web galion. Optiunea --om
garantează că om pagină este preluat, chiar și atunci când un fișier local ls există în realitate
director.

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

Obţineţi om pagină denumit roff in om secțiunea 7, decomprimați-o și imprimați-o neformatată
conținut, codul său sursă.

SH# groffer --de-p --in --ap

Acesta este un set de argumente abreviate, se determină ca

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

SH# fișier pisică.gz | groffer -Z -mfoo

Fișierul fișier.gz este trimis la intrarea standard, aceasta este decomprimată și apoi aceasta este
transportat la groff intermediar producție mod fără post-procesare (groff opțiune
-Z), folosind pachetul macro foo (groff opțiune -m).

SH# echo „\f[CB]WOW!' |
> groffer --x --bg roșu --fg galben --geometrie 200x100 -

Afișează cuvântul WOW! într-o fereastră mică cu font aldine cu lățime constantă, folosind culoarea galbenă
fundal roșu.

COMPATIBILITATE

groffer programul este scris în Perl, versiunea Perl în timpul scrierii a fost v5.8.8.

groffer oferă propriul analizor pentru argumentele liniei de comandă care este compatibil cu ambele
POSIX getopts(1) și GNU getopt(1). Poate gestiona argumentele opțiunilor și numele fișierelor
conținând spațiu alb și un set mare de caractere speciale. Următorul standard
tipurile de opțiuni sunt acceptate.

* Opțiunea constând dintr-un singur minus - se referă la intrarea standard.

* Un singur minus urmat de caractere se referă la o opțiune de un singur caracter sau a
combinație a acestora; de exemplu, cel groffer combinație de opțiuni scurte -Qmfoo is
echivalent cu -Q -m foo.

* Opțiunile lungi sunt opțiuni cu nume mai lungi de un caracter; sunt întotdeauna precedate
cu un dublu minus. Un argument opțiune poate merge fie la următorul argument din linia de comandă
sau să fie atașat cu un semn egal la argument; de exemplu, --long=arg este echivalent
la --lung arg.

* Un argument al -- termină analizarea opțiunii; toate argumentele suplimentare ale liniei de comandă sunt
interpretat ca fisierspec parametri, adică nume de fișiere sau constructe pentru căutare
om pagini).

* Toate argumentele liniei de comandă care nu sunt nici opțiuni, nici argumente opțiuni sunt interpretate
as fisierspec parametrii și stocați până la finalizarea analizei opțiunilor. De exemplu, cel
Linie de comanda

SH# groffer file1 -a -o arg file2

este echivalent cu

SH# groffer -a -o arg -- fisier1 fisier2

Amestecarea gratuită a opțiunilor și fisierspec parametrii urmează principiul GNU. Asta face
nu îndeplinește comportamentul ciudat al opțiunii al POSIX care încheie procesarea opțiunii de îndată ce
s-a ajuns la primul argument fără opțiune. Sfârșitul procesării opțiunii poate fi
forțat de opțiunea `--' oricum.

Utilizați groffer online folosind serviciile onworks.net