Dev:Debugging

Debugging YaCy

If you want to debug Yacy, there are some things, you need to take care of.

Locales

Switch to default locales (english) before editing a /htroot/*.html file, or you won't see your change.

Note: actually, the locales will be regenerated, if you start YaCy with a new svn version. So the User will have updated locales, and only in development the locales are not up to date

TemplateCache

Disable enableTemplateCache on AdvancedConfig or before starting YaCy in httpProxy.conf, or every edit of an already loaded page will not be displayed before the next restart.

Which file is used (Overlays)

Dev:Overlays explains, which file is used, if the same file exists in several overlayed directories.

Servlets are cached

And there is currently no way to disable this. So you need to restart YaCy after each change.

yacyDebugMode

This property disables some network checks, and increases the timeout.

TODO: complete description, what is changed

Tools

Eclipse

With eclipse you can debug Yacy and its servlets like every other java application, with breakpoints, step by step debugging, variable watchlist, and all other eclipse features.