Vylepšené formátování našich manuálových stránek

Kód je dobře, ale zase tam jsou nějaká přebytečná "R", například "The R wait () system call..."

Dokud tam nebude uvedeno, k jake verzi programu, OS, ... se dana manualova stranka vztahuje, tak to i nadale bude jen stek do prazdna bez valneho praktickeho vyznamu. Jako kuriozita je to OK, ale pro systemovou administraci se to vubec nehodi.

videl jste snad manualove stranky jinde nez na unixech? napr. man notepad.exe ? ;-) a pod solaris/bsd/linux/mac os x dela man to same :-)

A viděl jsi ty manuálové stránky na něčem jiném než Linuxu (Solaris, FreeBSD)? Připadá ti že je tam ten samý text? Zkus třeba "man watch" na Linuxu vs. FreeBSD nebo "man killall" na Linuxu vs. Solarisu - to jsou úplně jiné programy.

Presne tak. Lisi se volby i funkcnost a nejde jen o rozdily mezi derivaty BSD a System 5 Unixu. V nekterych pripadech existuji vyznamne rozdily i mezi Red Hatem a SUSE Linuxem. Navic moznosti programu se neustale rozsiruji a manualova stranka musi ty zmeny reflektovat.

Misto reci radsi uvedu nekolik prikladu:

################################################################
1. Solaris 9 vs. SLES 10

> man ps # Solaris 9
...
SYNOPSIS
ps [-aAcdefjlLPy] [-g grplist] [-n namelist] [-o format]...
[-p proclist] [-s sidlist] [-t term] [-u uidlist] [-
U uidlist] [-G gidlist]

> man ps # SLES 10
...
SYNOPSIS
ps [options] # options nejsou explicitne vypsane, protoze zalezi na PERSONALITY
...
PS_PERSONALITY
Set to one of posix, old, linux, bsd, sun, digital... (see section PERSONALITY below).

################################################################
2. SLES 10 vs Red Hat (neznama verze z Internetu)

> man passwd # SLES 10
...
SYNOPSIS
passwd [-f|-g|-s|-k[-q]] [name]
passwd [-D binddn][-n min][-x max][-w warn][-i inact] account
passwd [-D binddn] {-l|-u|-d|-S[-a]|-e} name
passwd --stdin [account]

# Red Hat
SYNOPSIS
passwd [-k] [-l] [-u [-f]] [-d] [-n mindays] [-x maxdays] [-w warndays] [-i inactivedays] [-S] [--stdin] [username]

################################################################
Casovy vyvoj:

Stare verze rsync nepodporovaly ani ACLs ani extended attributes. Man page na Root.cz popisuje ACLs, ale nikoliv extended attributes.
> man rsync # openSUSE 10.2
...
-A, --acls preserve ACLs (implies -p) [non-standard]
-X, --xattrs preserve extended attrs (implies -p) [n.s.]
--chmod=CHMOD change destination permissions

# Root.cz
...
-A, --acls preserve ACLs (implies -p) [non-standard]

Pro nezavazne cteni jsou manualove stranky na Root.cz OK, ale pro seriozni systemovou administraci jsou nepouzitelne. Na produkcnich systemech nemuzete poustet prikazy, aniz byste meli jistotu, ze volby funguji tak, jak jsou popsany v dokumentaci.

no tak toto je len mudrost zase...

zevraj dela to same, to mas odkial ?

napriklad taky killall na hpux nevykonava ani zdaleka to iste ako killall na linuxe, a vela rozdielov je aj v inych programoch