irb-pager/README.md

45 lines
1.1 KiB
Markdown

`IRB::Pager` vs. `Pager`
====================
Because naming conflicts, i renamed Pager to `IRB::Pager`.
There is no need for `IRB`; of course you can use `IRB::Pager` without `irb`.
I renamed these things:
* gem: `gem install pager` #=> `gem install irb-pager`
* lib: `require 'pager'` #=> `require 'irb-pager'`
* module: `Pager` #=> `IRB::Pager`
`Pager.pager` will be `IRB::Pager.pager` now.
Usage
=====
Very simple:
require 'irb-pager'
include IRB::Pager
pager { puts "Hello World!" }
pager { 1.upto(200) {|i|sleep 0.2; puts i} }
Exceptions will not be handled by pager:
pager { raise 'Oops' }
But if you want, pager can do:
pager( :rescuing => true) { raise 'Oops' }
$PAGER_RESCUE = true # forces pager to handle exceptions everytime.
pager { raise 'Oops' }
You like more more than less? (I cannot understand, but it is your choice)
pager( :pager => 'more') { puts "Hello World!" }
$PAGER = 'more' # forces pager to use more
pager { puts "Hello World!" }
If you have set `PAGER` in your Processenvironment (`/etc/profile` or `~/.profile` ...) this `PAGER` will be used.
PAGER=more
export PAGER