about summary refs log tree commit diff stats
path: root/examples/README
Commit message (Collapse)AuthorAgeFilesLines
* removed options.py, improved plugins. *UPDATE YOUR COMMANDS.PY*hut2012-12-041-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Previously, you could change settings in both rc.conf and options.py. With this commit, options.py is deprecated and you are encouraged to use rc.conf to change settings. I chose to do this because it is more elegant to use a simple list of ranger commands for configuration rather than a python file with lots of magic around it and potential syntax errors for inexperienced users. The existing "set" command doesn't evaluate python objects anymore, instead it always takes strings and converts to the proper type automatically. This means that the old set command will not work anymore and you have to update your commands.py if it still uses the old definition of the "set" command. This is how to convert your options.py: old way, in options.py | new way, in rc.conf ---------------------------+------------------------ show_hidden = False | set show_hidden false sort = 'basename' | set sort basename column_ratios = (1, 5, 3) | set column_ratios 1,5,3 For backward compatibility, you still can use options.py, but you get a warning when you start ranger. You can pipe stderr to /dev/null to silence the warning, or just move your stuff from options.py to rc.conf and plugins and delete the options.py. Finally, to extend ranger, which you previously could do through monkey-patching in options.py, you should now use the plugin system. This was an experimental, undocumented feature of ranger for some time, but this and the following commits will imrpove and document it. You can simply move all the monkey-patching code from options.py to a *.py file in ~/.config/ranger/plugins/.
* added the examples from the man page to the examples directoryhut2012-08-061-0/+2
I guess a whole directory for examples scales better than having them in the man page.