Re: More explicit support for Unicode title case

[Mike Gran <spk121@yahoo.com>]

[-- Attachment #1: Type: text/plain, Size: 853 bytes --]

> >> +SCM_API scm_t_wchar scm_c_titlecase (scm_t_wchar c);

> >
> > I think it should be documented in the manual.
> 
> Actually, I'm going to hold off on this, since documenting this would
> require at least some explanation of scm_t_wchar, which seems to me to
> be outside the scope of this patch.  I'm happy to add documentation
> for this (as well as the other wchar functions), although some context
> from the originator of that typedef (`git blame' says it was Mike
> Gran) would be useful.

I wonder if these should be API.  It is probably too late to change them, 
since they've existed as API since the late 1990s, but, as far as I can
tell, no one has ever used them (I checked codesearch.google.com 
and koders.com).  They've also never been documented.

But, a patch for documenting these is attached.

Thanks,

Mike

[-- Attachment #2: api-data-case.patch --]
[-- Type: application/octet-stream, Size: 769 bytes --]

--- doc/ref/api-data.texi.0	2009-12-21 22:40:16.226406152 -0800
+++ doc/ref/api-data.texi	2009-12-21 23:07:43.902405881 -0800
@@ -1901,6 +1901,17 @@
 Return the lowercase character version of @var{chr}.
 @end deffn
 
+@tindex scm_t_wchar
+@deftypefn {C Function} scm_t_wchar scm_c_upcase (scm_t_wchar @var{c})
+@deftypefnx {C Function} scm_t_wchar scm_c_downcase (scm_t_wchar @var{c})
+@deftypefnx {C Function} scm_t_wchar scm_c_titlecase (scm_t_wchar @var{c})
+
+These C functions take an integer representation of a Unicode
+codepoint and return the codepoint corresponding to its uppercase,
+lowercase, and titlecase forms respectively.  The type
+@code{scm_t_wchar} is a signed, 32-bit integer.
+@end deftypefn
+
 @node Character Sets
 @subsection Character Sets