tealdeer

[Isegrimm666]

Guten Morgen zusammen ...

Für die, die es noch nicht kennen: https://rundumlinux.de/kurze-hilfeseiten-im-terminal/

Ich persönlich finde es ein sinnvolles tool um manpages effizienter zu nutzen.

[edlin]

tldr - to long? don't read! 

Einen schönen Start ins Wochenende.
Also ich hab mir das mal angeschaut und meine persönliche Meinung fällt da ganz anders aus. Das mag aber jeder für sich aushandeln, je nach Erwartungen, Erfahrungen etc.
Da tealdeer in den Repos ist, hab ich es mal schnell installiert. Aufgerufen wird es dann aber mit tldr. Beim ersten Start wird zunächst ein update für den Cache erforderlich, denn bei den später offerierten Seiten handelt es sich um von der Gemeinschaft erstellten Inhalten, basierend auf den manpages. Voreingestellt sind die Sprachen de und en.
Erster Test: tldr apt Erstes Ergebnis: Ein Farbprofil der Düsternis, welches ich erst mal mit etwas mehr Kontrast anreichern musste. Also geschaut, ob es eine config gibt. Da ich nicht gleich fündig wurde, habe ich mal tldr tldr eingegeben - kein Hinweis. Dann also doch man tldr. Dort fündig geworden, habe ich mir mit tldr --seed-config eine Basiskonfiguration erstellt und dort das Farbschema angepasst.
Zweiter Versuch mit tldr apt. Jetzt erfahre ich, dass es sich bei apt um ein Debian und Ubuntu Paket Management Tool. Empfohlene Alternative zu `apt-get` seit Ubuntu 16.04. handelt. Gefolgt von ein paar einfachen Befehlszeilenbeispielen mit Eklärung in Nanotechnologie - muss ja alles auf eine Bildschirmseite passen. Die Beispiele stammen aus dem Heile-Welt-Alltagsrepertoire (update, upgrade, remove, install, show, search etc.). Weiterführende Sachen, wie full-upgrade, why, why-not, autopurge usf. darf man nicht erwarten.
Also mal ein paar andere Beispiele getestet:
tldr dd
tldr xrandr
tldr bash
tldr mpv
tldr ffmpeg-all
...
Während es für dd noch ganz brauchbare Beispiele gab, war es bei xrandr schon eine minimalistische Katastrophe.
6 Beispiele decken nun mal nur einen Bruchteil der Möglichkeiten ab. Ein Blick in die manpage offeriert erst das Potenzial von xrandr:

SYNOPSIS
     xrandr  [--help]   [--display  display]  [-q]  [-v] [--verbose] [--dryrun] [--screen snum] [--q1] [--q12] [--current] [--noprimary]
     [--panning       widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]]
     [--scale  x[xy]]  [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb widthxheight] [--fbmm widthxheight]
     [--dpi dpi] [--dpi from-output] [--newmode name mode] [--rmmode name] [--addmode output name]  [--delmode  output  name]  [--output
     output]  [--auto]  [--mode  mode]  [--preferred] [--pos xxy] [--rate rate] [--reflect reflection] [--rotate orientation] [--left-of
     output] [--right-of output] [--above output] [--below output] [--same-as output]  [--set  property  value]  [--off]  [--crtc  crtc]
     [--gamma  red[:green:blue]]  [--brightness  brightness]  [-o  orientation]  [-s size] [-r rate] [-x] [-y] [--listproviders] [--set‐
     provideroutputsource provider source] [--setprovideroffloadsink provider sink] [--listmonitors] [--listactivemonitors]  [--setmoni‐
     tor name geometry outputs] [--delmonitor name]

Und das ist halt das Problem von tldr: Es ist immer eine minimalistische Auswahl an Beispielen; das Potenzial eines Paketes mit seinen Möglichkeiten wird schlicht nicht aufgezeigt. Das mag für den Anfänger/Umsteiger zunächst ganz nett sein, da alles ganz einfach und übersichtlich ausschaut, aber das wars schon. Es ist weder ein Ersatz für man noch eine Alternative zu man.

Ich gebe ja zu, dass die Beispiele mit mpv, bash und ffmpeg-all schon ganz bewusst gewählt waren, denn dabei handelt es sich um "etwas" umfangreichere manpages (bash: 5096 Zeilen, mpv: 16732 Zeilen und ffmpeg-all: 45608 Zeilen). Dass da nicht wirklich viel herumkommen kann, sollte eigentlich klar sein. Zu ffmpeg-all liefert tldr auch nichts mehr aus.

Das Ganze erinnert mich an einen Versuch, ein Datenblatt zu einer 32-bit Connectivity MCU with Integrated Security, zum Beispiel einem PIC32CZ, auf eine Seite einzudampfen. Das Datenblatt hat übrigens 2185 Seiten und laut wc 123230 Zeilen Text (ohne Abbildungen). Datenblatt
 
Ich persönlich schaue da lieber in das vollständige Datenblatt eines IC in Originalsprache und hier in die manpages im Original. Das Original ist immer noch die verlässlichste und vollständigste Informationsquelle für mich (zumal es ja auch noch eine Suchfunktion gibt). Effizienz sieht für mich anders aus. Tealdeer/tldr ist sicher nett gemeint, aber einen Deutschkurs kann man ja auch nicht auf 6 Beispielsätze reduzieren.

JM2C - edlin