Vlákno názorů ke zprávičce Vylepšené formátování našich manuálových stránek
aura:88
18. 1. 2008 14:58
Re: Verze
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.
vvv (neregistrovaný)
18. 1. 2008 15:46
Re: Verze
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.
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.
