Cheat: když je manpage příliš dlouhá

Článek Cheat: když je manpage příliš dlouhá na MojeFedora.cz představuje v Pythonu napsaný nástroj cheat pracující s cheatsheety aneb tím nejdůležitějším z manuálových stránek. Příkaz cheat místo dlouhé manuálové stránky zobrazí krátký seznam příkladů použití daného příkazu.

22.7.2019 11:22 | Ladislav Hagara | Zajímavý článek

Komentáře

[Bedňa]

Príklad je vždy viac ako manuál.

[sdfgfdsg]

A castecne je to taky duvod proc je spolecnost dneska tak v prdeli. Kazdy chce naservirovany vysledky/postup/informace hned, idealne tak, aby nemusel nic delat a hlavne aby se nemusel ucit chapat podstatu veci.

[Kundera]

+1

Ono taky cheat znamená: podvést, ošidit. V manuálových stránkách sekce s příklady celkem běžně bývají. Udržovat příklady na dvou místech mi přijde nadbytečné. Když už si někdo dává práci s dokumentováním/vymýšlením příkladů, tak mi přijde smysluplnější, aby jimi přispěl do dané manuálové stránky.

[Bedňa]

tak mi přijde smysluplnější, aby jimi přispěl do dané manuálové stránky.

Tak s týmto plne súhlasím.

[cezz]

Tak ak ma byt odpoved na problem toho ze su man stranky prilis dlhe to ze ich este predlzime, tak neviem.. Ono su to v zasade dva rozne use cases - ked chcem nieco konkretne spravit, tak ocenim konkretny priklad, ked planujem utilitu pouzivat dlhodobo a na viac ucelov, rad venujem ten cas skutocnemu citaniu manpages.

[k3dAR]

nektere manualove stranky co psal clovek, example na konci obsahujou a casto pomuzou stejne a rychleji jako cteni cele pages

[/dev/random]

Vy budete vlastnit asi aj tlacenu verziu man pages, ze ?

[Bedňa]

Zrejme si nikdy nečítal nejaký zložitejší manuál. Niekedy proste nepochopíš ako tie prepínače použiť a pod.

[J. M.]

Ono to není jen tím manuálem. Některé programy mají tak extrémně zašmodrchané ovládání z příkazové řádky, že prostě není v lidských možnostech je rozklíčovat (a já bych řekl, že u některých ani není v lidských možnostech je tak extrémně blbě navrhnout). Když se k tomu pak přidá naprosto nesrozumitelná manuálová stránka, ze které ani při nejlepší vůli nelze dešifrovat, jak se přepínače a parametry používají, pak jediná možnost, jak program používat, je buď vyčerpávající experimentování metodou pokus-omyl (s nejistým výsledkem), nebo si prostě přečíst příklady.

[Kate]

Jojo, kde jsou ty časy, kdy všichni četli manpages utility od začátku až do konce i ve chvíli, kdy potřebovali základní funkcionalitu.

Tohle fakt není specifikum nějakého „dneska“, lidi si ulehčovali práci odjakživa.

[Ruža Becelin]

Chapu vtip, ale ono to tak celkem bylo, dokud se rozlisovalo: man - strucna napoveda, info - podrobna napoveda.

[nn]

Co ja vim tak opravdu dlouhy man ma pouze bash a vetsina prikazu ma --help/-h, ktery je kratsi a strucnejsi. Zbytecnost.

[SGOrava]

Videli ste youtube-dl ?

[k3dAR]

youtube-dl man-lines=1441
bash man-lines=3132
(fs/fhd, font=10, oba ^^ samozrejme stejne)

[peekaa]

Když vám to nebude fungovat napoprvé jako mě, tak: sudo ln -s /usr/local/lib/python2.7/dist-packages/usr/share/cheat/ /usr/share/cheat, viz https://github.com/cheat/cheat/issues/448 na konci....

[/dev/random]

hmmmm tie pythoňácke programi su sama chyba...

inštalácia:

$ sudo pip3 install cheat

$ cheat tar
No cheatsheet found for tar

$ cheat cp
No cheatsheet found for cp

$ cheat -l
Traceback (most recent call last):
  File "/usr/local/bin/cheat", line 93, in <module>
    print(sheets.list(), end="")
  File "/usr/local/lib/python3.5/dist-packages/cheat/sheets.py", line 59, in list
    pad_length = max([len(x) for x in self.get().keys()]) + 4
ValueError: max() arg is an empty sequence

proste krása...