Bro pages: like man pages, but with examples only
I humbly submit an implementation of `eg`.  It solves the <i>technical</i> problem
discussed here for a selection of programms (notably git!):<p><pre><code>    alias eg='man --pager='\''less -p "^[A-Z]* ?EXAMPLES"'\'''
</code></pre>
This obviously depends on the quality of the man-pages.<p>Witness: `eg git pull` (with a recent enough Bash, `eg git-pull` otherwise),
`eg awk`, `eg cat` or even `eg man`.<p>Ironically, the curl man-page doesn't have a separate Examples section; the
authors prefer to intersperse those throughout the text.<p>The name was coined here by imdsm[0] -- I had been using `examples` previously.<p>[0] <a href="https://news.ycombinator.com/item?id=7121505" rel="nofollow">https://news.ycombinator.com/item?id=7121505</a>