SYNOPSIS
#include <pslib.h>
int PS_hyphenate(PSDoc *psdoc, const char *text, char **hyphens)
DESCRIPTION
Hyphenates the passed word. text should not contain any non alpha characters. Possible positions for breaks are returned in hyphens.
This function requires the locale category LC_CTYPE to be set
propperly. PS_boot() usually does it by using the enviroment variables.
PS_hyphenate() evaluates the value 'hyphenminchars' and the parameter `hyphendict'. hyphendict must be set before calling this function.
RETURN VALUE
Returns -1 in case of an error, and otherwise 0.