.TH "PS_HYPHENATE" "3" 
.SH "NAME" 
PS_hyphenate \(em Hyphenates a word 
.SH "SYNOPSIS" 
.PP 
#include <pslib.h> 
.PP 
int PS_hyphenate(PSDoc *psdoc, const char *text, char **hyphens) 
.SH "DESCRIPTION" 
.PP 
Hyphenates the passed word. \fBtext\fR should not 
contain any non alpha characters. Possible positions for breaks are 
returned in \fBhyphens\fR. 
.PP 
This function requires the locale category LC_CTYPE to be set 
propperly. PS_boot() usually does it by using the enviroment variables. 
 
.PP 
PS_hyphenate() evaluates the value 'hyphenminchars' and the parameter 
`hyphendict'. hyphendict must be set before calling this function. 
.SH "RETURN VALUE" 
.PP 
Returns \-1 in case of an error, and otherwise 0. 
.SH "SEE ALSO" 
.PP 
PS_boot(3), PS_show_boxed(3), locale(1) 
.SH "AUTHOR" 
.PP 
This manual page was written by Uwe Steinmann <uwe@steinmann.cx>. 
.\" created by instant / docbook-to-man