Vlákno názorů ke zprávičce Vylepšené formátování našich manuálových stránek od vvv - Dokud tam nebude uvedeno, k jake verzi programu,...

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 :-)

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.