bug#24603: [PATCHv5 03/11] Add support for title-casing letters (bug#24603)

[Eli Zaretskii]

> From: Michal Nazarewicz <mina86@mina86.com>
> Date: Thu,  9 Mar 2017 22:51:42 +0100
> 
>  DEFUN ("capitalize", Fcapitalize, Scapitalize, 1, 1, 0,
>         doc: /* Convert argument to capitalized form and return that.
> -This means that each word's first character is upper case
> -and the rest is lower case.
> +This means that each word's first character is upper case (more
> +precisely, if available, title case) and the rest is lower case.

I'd rephrase this:

  Convert argument to capitalized form and return that.
  This means that each word's first character is converted to either
  title case or upper case, and the rest to lower case.

IOW, I wouldn't risk confusing the reader with "more precisely" and
"if available".  I think this is not really needed.  If you think that
"title case" might not be understood, perhaps add a pointer to the
relevant manual node.

This comment is relevant, with minor variations, to all of the other
doc string changes you proposed.

Thanks.