.\" Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Sun Jul 25 11:06:05 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Sat Jun  8 00:39:52 1996 by aeb.
.TH MAN 7 "25 July 1993" "Linux" "Linux Programmer's Manual"
.SH NÉV
man \- manual oldalak formázásához használatos makrók
.SH ÁTTEKINTÉS
.B groff \-Tascii \-man
.I fájl
\&...
.LP
.B groff \-Tps \-man
.I fájl
\&...
.LP
.B man
.RI [ szekció ]
.I cím
.SH LEÍRÁS
Ez a manual oldal a
.B "groff tmac.an"
makrócsomag használatát magyarázza el. Ez a makrócsomag manual oldalak
írásakor vagy Linux alá portolásakor használatos. A kompatibilitása
más makrócsomagokkal elég jó, emiatt a portolás nem okozhat nagy
problémát (ez alól a NET-2 BSD kivétel, mivel az teljesen más
makrócsomagot alkalmaz).

A NET-2 BSD manual oldalait
.B groff
használatával úgy lehet megnézni, hogy a
.B \-mdoc
opciót használod a
.B \-man
opció helyett. A
.B \-mandoc
opció használata a javasolt, mert ez automatikusan felismeri, melyik
makrócsomagot kell alkalmaznia.
.SH BEVEZETÉS
A manual oldal első parancsa a
.RS
.sp
.B \&.TH
.IR "cím szekció dátum forrás manual" 
.sp
.RE
kell legyen, ahol
.RS
.TP 0.8i
.I cím
A manual oldal címe (pl. 
.IR MAN ).
.TP
.I szekció
Ebbe a szekcióba kerüljön a manual oldal (pl.
.IR 7 ).
.TP
.I dátum
Az utolsó módosítás dátuma\(emne felejtsd el minden alkalommal
módosítani, ha a manual oldalt módosítod. Ez a verzióellenőrzés
legáltalánosabb módja.
.TP
.I forrás
A parancs, program forrása.
.sp
Bináris állományokhoz valami ilyesmit használj:
.IR GNU ", " NET-2 ", " "SLS Distribution" ", " "MCC Distribution" .
.sp
Rendszerhívások esetén a kernel verziószámát használd:
.IR "Linux 0.99.11" .
.sp
Könyvtári függvényhívásokhoz a függvény forrását használd:
.IR GNU ", " "BSD 4.3" ", " "Linux DLL 4.4.1" .
.TP
.I manual
A manual oldal címe (pl.
.IR "Linux Programmer's Manual" ).
.RE
.PP
A manual oldalak hagyományosan a következő szekciókra vannak
felosztva:
.RS
.TP 0.8i
.B 1 Parancsok
A felhasználó által a shellből végrehajtható parancsok.
.TP
.B 2 Rendszerhívások
A kernel által végzett függvényhívások.
.TP
.B 3 Könyvtári függvényhívások
A
.I libc
függvények legtöbbje, mint pl. a
.BR sort (3).
.TP
.B 4 Speciális fájlok
A 
.IR /dev
könyvtárban található fájlok.
.TP
.B 5 Fájlformátumok és konvenciók
Az 
.I /etc/passwd
és más, emberi olvasásra alkalmas fájlok formátuma.
.TP
.B 6 Játékok
.TP
.B 7 Makrócsomagok és konvenciók
A szabványos fájlrendszer leírása, ennek a manual oldalnak a leírása és
egyéb dolgok.
.TP
.B 8 Rendszerkarbantartó parancsok
Az olyan parancsok, mint pl. a
.BR mount (8),
amiket csak a
.I root
használhat.
.TP
.B 9 Kernel rutinok
Ez egy nem szabványos manual szekció, és csak azért van, mert a Linux
kernel forráskódja a GNU Általános Közengedély alatt szabadon elérhető,
és sok ember dolgozik a kernelen.
.RE
.SH BETŰTÍPUSOK
A UNIX-világban több önkényes manual oldal formátum van, a néhányszáz
létező Linux-specifikus manual oldal azonban meghatározza a mi szabványainkat:
.IP
Függvényeknél az argumentumlista mindig dőlt betűvel szerepel,
.IR "a ÁTTEKINTÉS szekcióban is" ,
aholis a függvény többi része félkövérrel szedett:
.RS
.BI "int myfunction(int " argc ", char **" argv );
.RE
.IP
A fájlnevek mindig dőlt betűkkel szerepelnek (pl.
.IR "/usr/include/stdio.h" ,
kivéve a ÁTTEKINTÉS szekciót, ahol a beágyazott fájlok félkövér betűkkel
szedettek (pl.
.BR "#include <stdio.h>" ).
.IP
A speciális makrók, amik általában nagybetűsek, félkövér betűkkel
szedettek (pl.
.BR MAXINT ).
.IP
Hibakódok listájának felsorolásakor a kódok félkövér betűkkel szedettek
(ehhez általában a
.B \&.TP
makró használatos).
.IP
Hivatkozás más manual oldalra vagy az aktuális manual oldal tárgyára
félkövér betűkkel szedett. Ha a szekciószám is adott, az mindig
Roman betűtípussal, szóközök nélkül szedett (pl.
.BR man (7)).

A betűtípust, -formát kiválasztó parancsok:
.TP 0.8i
.B \&.B
Félkövér
.TP
.B \&.BI
Félkövér dőlt
.TP
.B \&.BR
Félkövér Roman
.TP
.B \&.I
Dőlt
.TP
.B \&.IB
Dőlt félkövér
.TP
.B \&.IR
Dőlt Roman
.TP
.B \&.RB
Roman félkövér
.TP
.B \&.RI
Roman dőlt
.TP
.B \&.SB
Kicsi félkövér
.TP
.B \&.SM
Kicsi
.LP
Hagyományosan minden parancsnak maximum hat argumentuma lehet, de úgy
látszik a GNU verzió feloldotta ezt a korlátozást. Az argumentumokat
egymástól szóközök választják el. Dupla idézőjelek használatával lehet
szóközt tartalmazó argumentumot átadni. Az argumentumok közvetlenül
egymás után, szóköz nélkül íródnak ki, így a
.B \&.BR
parancs használatával lehet egy félkövér szó után egy Roman írásjelet
tenni.
.SH SZEKCIÓK
A szekciók a
.B \&.SH
paranccsal kezdődnek, argumentum a szekció neve. Ha a szekció nevében
van szóköz karakter és ugyanabban a sorban van mint a
.BR \&.SH ,
akkor a szekció nevét dupla idézőjelbe kell tenni. A hagyományos
szekciónevek: NÉV, ÁTTEKINTÉS, LEÍRÁS, OPCIÓK, FÁJLOK, LÁSD MÉG,
DIAGNOSZTIKA, HIBÁK és SZERZŐ. Az egyetlen kötelező szekció a
.IR NÉV ,
amit a következő sorban a program egysoros leírásának kell követnie:
.RS
.sp
\&.SH NÉV
.br
chess \\- sakkjáték
.sp
.RE
Nagyon fontos, hogy ez legyen a formátum, és hogy legyen egy backslash
a parancs nevét követő kötőjel előtt. Ezt a formátumot használja a
.BR makewhatis "(8) vagy a " mandb (8)
program hogy a
.BR whatis (1)
és a
.BR apropos (1)
parancsok számára elkészítse a parancsok rövid leírásának adatbázisát.
.SH TOVÁBBI MAKRÓK
.TP
.B \&.DT
Alapértelmezésű tabulátorok
.TP
.B \&.HP
Begin hanging indent
.TP
.B \&.IP
Bekezdés behúzás egy kezdő cimszóval (tag). Ez ugyanaz, mint a
.BR \&.TP ,
kivéve, hogy a tag ugyanabban a sorban van, nem a következőben.
.TP
.B \&.LP
Ugyanaz mint a
.B \&.PP
.TP
.B \&.PD
A paragrafusok közötti távolságot állítja az argumentum szerint.
.TP
.B \&.PP
Új bekezdés kezdete
.TP
.B \&.RE
Relatív behúzás vége (behúzott bekezdések)
.TP
.B \&.RS
Relatív behúzás kezdete (behúzott bekezdések)
.TP
.B \&.SS
Alfejléc (mint a
.BR \&.SH ,
de alszekciók jelölésére)
.TP
.B \&.TP
Bekezdés behúzás egy kezdő cimszóval (tag). A tag a következő sorban van 
megadva. Ez hasonló a
.B \&.IP
.LP
.SH FÁJLOK
.I /usr/local/lib/groff/tmac/tmac.an
.br
.I /usr/man/whatis
.SH LÁSD MÉG
.BR groff (1),
.BR man (1),
.BR whatis (1),
.BR apropos (1),
.BR makewhatis (8)
.SH MAGYAR FORDÍTÁS
Tevesz Tamás <ice@rulez.org>