News for hackers. Stuff that matters.
Re:Simplified and community-driven man pages by dmitriid on Sunday November 26, 2017 @11:48AM (#15781681)
Yup, and the examples section is usually last, with no possibility to jump directly to it
Re:Simplified and community-driven man pages by crispinb on Sunday November 26, 2017 @05:13PM (#15783352)
> and the examples section is usually last

A far better answer to this would have been a project to (1) improve man page examples, and then (2) create a small alternative man page client that displays only the examples (or puts them up top).

Having said that I do see the need for what tldr is doing, even though I would have preferred it added to existing tools. More often than not I only find man pages useful after I have needed to look up something. They're usually OK for wholistic understanding, but often too dense and assuming of far too much contextual knowledge to be useful in the heat of battle.

Re:Simplified and community-driven man pages by begriffs on Sunday November 26, 2017 @12:02PM (#15781766)
You can jump to it by typing /EXAMPLES<enter>

Or if that seems like a lot of keystrokes, /EX<enter> will probably jump to what you want most of the time too.

Re:Simplified and community-driven man pages by dmitriid on Monday November 27, 2017 @03:18AM (#15785661)
"probably"

   > man less

   /EX
   pattern not found

   /ex
   ends up somewhere in the middle of the text 
   on a word that contains ex
Re:Simplified and community-driven man pages by jforberg on Monday November 27, 2017 @06:57AM (#15786662)
> with no possibility to jump directly to it

How about '/examples'? Maybe you should take some time to actually learn how 'man' works before you start bashing it online...

Re:Simplified and community-driven man pages by explainplease on Monday November 27, 2017 @08:00AM (#15786934)

    $ cat ~/.bin/eg
    #!/bin/bash
    man $@ | awk '/^EXAMPLE/ { getline; while ($0 !~ /^[A-Z]+/) { print $0; getline; } }'
Re:Simplified and community-driven man pages by zaarn on Monday November 27, 2017 @04:05AM (#15785852)
Usually Shift-G should transport you to the end of the document.