/*
 * breaks $text into sections with maximum length no bigger than $allowedlength
 * and not allowing the number of sections returned to be bigger than $maxsections
 * if supplied
 *
 * Earendur Ancalimon
 * 16-11-2006
 */
function sectionalizeLongText($text, $allowedlength, $maxsections = 0)
{
        $splitchar = " ";
        $newcomment = array();
       
        // split $text into array of single 'words'
        $text = split($splitchar, $text);
       
        // set section counter
        $c = 0;
        for( $i = 0; $i < count($text); $i++ )
        {
                // temp store current section and new word
                $temp = $newcomment[$c] . $text[$i] . " ";
               
                // check if new word would make section longer than allowed length
                if( strlen($temp) > $allowedlength )
                {
                        // increment counter (next section)
                        $c++;
                       
                        if( $maxsections > 0 && $c >= $maxsections )
                        {
                                $newcomment[$c-1] = substr($newcomment[$c-1], 0, $allowedlength - 3);
                                $newcomment[$c-1] .= "...";
                                return $newcomment;
                        }
                       
                        if( $i < count($text) )
                        {
                                // initialize
                                $newcomment[$c] = "";
                        }                     
                }
               
                // add on the next word
                $newcomment[$c] .= $text[$i] . " ";
        }
       
        return $newcomment;
}