# Project Information

_Ewo_ is a tool written in Python for the [Gentoo GNU/Linux](http://www.gentoo.org) distribution to optimize the recompilation of the whole system, all installed packages.

Usually one can simply use `emerge -e world` and `emerge --resume` when something bad happens, but sometimes you need to run another emerge process to solve a problem and this alter the desired `emerge --resume` behavior. _Ewo_ solves this issue and it can be used in general to compile all the packages that have not been updated or replaced after a specific date (CFLAGS, LDFLAGS change, compiler upgrade and so on).
Using a config file named `package.skip` the user can avoid useless packages reinstallation, like large binary packages for example.

Take a look at `ewo --help` before use it or read

# BasicHelp

```
EWO - Emerge (-e) World Optimizer (v0.5)

Usage: ewo [options]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -s TOUCH_FROMDATE, --setstart=TOUCH_FROMDATE
                        set the starting point (possible values are 'NOW' or a
                        genlop-style date like 'Mon Jun 05 11:09:37 2007')
  -P, --purgestart      remove the previously set starting point
  -v, --showstart       show the already set starting point
  -f, --fetchonly       use the --fetchonly option in the emerge command
  -i, --ignore-smartworld
                        sometimes could be useful to ignore smartworld cache
                        (e.g. when some 'fetch restricted' files are removed
                        since last ewo run)
  -o, --problematic-only
                        this option should be used *before* running ewo in
                        'exec-mode' to avoid problems related with interactive
                        and fetch restricted ebuilds and to fully support
                        multiple emerge jobs (interactive force --jobs=1)
  -m MODE, --mode=MODE  using mode 'exec' an 'emerge -1 [...]' will start
                        automatically; using 'pretend' ewo simply shows the
                        todo packages list on the stdout and using 'emerge-
                        pretend' (Default) the output of 'emerge -1vp [...] |
                        less' will be shown.The 'cleaner' mode removes files
                        related with the already-done ebuilds.
```

Runtime dependencies: app-portage/genlop