Just for your reference, very 1st draft manual pages for the module is located at
http://www.dd.iij4u.or.jp/~yohgaki/php/Manual_en/ref.jstring.html (Due to storage size limit, I deleted most of pages that is not related to it) There are mistakes descriptions, typo, etc. I'll fix them later. I need to know if this style is acceptable or not. Thanks for your comments. Regards, -- Yasuo Ohgaki ""Yasuo Ohgaki"" <[EMAIL PROTECTED]> wrote in message 9ck0gu$72h$[EMAIL PROTECTED]">news:9ck0gu$72h$[EMAIL PROTECTED]... > I thought it might be a good idea to ask before I finish making a new function > reference. > > Almost all current PHP function references in PHP manual do not have separated > description for function parameters/return value. (I understand why, it's in > README in phpdoc CVS) Here is my question for you. > > Is it acceptable to have separated description for parameters and return value > for a function? (For new function/module reference?) > > For example, > -------------- > jstr_strimwidth > > (PHP 4 >= 4.0.6) > > jstr_strimwidth - Truncated string with specified display width > > Description > string jstr_strimwidth(string str, int start, int width [, string trimmarker [, > string encoding]]) > > Truncates string to specified display width. > > Parameter: > str : String to be truncated > start : Start position in number of characters from the beginning of string > width : Displayed width > trimmarker : String to add when string is truncated. > encoding : Character code name. If encoding is not specified, internal > character code is used. > > Return Value: > Truncated string. > > Example: > $str = jstr_strimwidth($str, 0, 40, "..>"); > ----------------- > > Some functions set default value when parameter is set, and return current > settings if parameter is omitted. Return values are differ depends on parameter > or what has been done in function. I thought it would be nice to users to have a > separated sub section (sub section like paragraph) for the module's function. > > Thanks for your reply. > > -- > Yasuo Ohgaki >