Hlavní navigace

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

Sdílet

Petr Krčmář 18. 1. 2008

Někteří čtenáři nás upozornili na rozbité formátování v manuálových stránkách. Konkrétně se jednalo o příklady kódu, které nebyly zobrazovány správně. Na server byla nasazena nová verze a vše by již mělo být v pořádku. Příklad: man wait (dole).

Našli jste v článku chybu?
  • Aktualita je stará, nové názory již nelze přidávat.
  • 18. 1. 2008 13:33

    vvv (neregistrovaný)
    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.
  • 18. 1. 2008 14:47

    potwor (neregistrovaný)
    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 :-)
  • 18. 1. 2008 14:58

    Lukáš Turek
    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.
  • 18. 1. 2008 15:46

    vvv (neregistrovaný)
    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.
  • 18. 1. 2008 17:38

    bez přezdívky
    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