[patch v1] manual: add remaining CPU_* macros

[DJ Delorie]

Florian Weimer <fweimer@redhat.com> writes:
> * DJ Delorie:
>
> As a general comment, I think the fixed-size macros should be
> deprecated.  Machines with more than 1024 CPUs are making a comeback.
> The fixed-size cpu_set_t type does not work for them.

I reworked much of it to make the dynamically allocated sets more
prevalent.

> Perhaps even quote the code in the first patch as an example in the
> manual?

I didn't like that example, so wrote my own.  It may be a silly example
but it uses more of the range of macros.

> Maybe mention explicitly that the argument is *not* the result of
> CPU_ALLOC_SIZE?

Done.

> If the allocation happens via malloc, why require that CPU_FREE must be
> used?  Maybe drop the malloc reference in the visible text?

Done.

> I think it would make sense to mention the *_S macros first and

I mentioned them earlier but didn't move the documentation; that would
require full docs for all the *_S macros and stubs for the others, the
opposite of what's there now.