[MTASCsft PATCH WIP5 00/33] MT-, AS- and AC-Safety docs

[Alexandre Oliva <aoliva at redhat dot com>]

Here's an updated version of the patch series that documents
Multi-Thread, Async Signal and Async Cancel safety properties of our
implementation.

A few files with functions containing lots of dependencies were
completed since the last round.  I modified the commit messages so
that stgit would indicate the files in the subject of each patch
email.  I think I have clearer definitions for
uunguard/xguargs/staticbuf, but I'm yet to complete reviewing all uses
thereof.  The new marks are tempsig, stimer, and uplugin.


Here's a summary of of the number of @deftypefu?n entries in each file
in the manual, how many @safety notes there are, how complete the
safety documentation for that file is, and how many other functions
I've (so far) noticed as not documented at all in the manual, but that
should be documented in that file (with a @safety note to go with it)

            Filename @def @saf  cmplt% undoc
   manual/stdio.texi  126  126 100.00%   0                                      
   manual/arith.texi  102  102 100.00%   0
  manual/string.texi   99   99 100.00%   1
    manual/math.texi   86   86 100.00%   0
 manual/filesys.texi   78   78 100.00%  18
    manual/llio.texi   53   53 100.00%   1
  manual/memory.texi   44   44 100.00%   0
   manual/ctype.texi   36   36 100.00%   0
 manual/process.texi   22   22 100.00%   0
 manual/charset.texi   18   18 100.00%   0
   manual/errno.texi   13   13 100.00%   0
 manual/message.texi   12   12 100.00%   0
     manual/job.texi   11   11 100.00%   0
 manual/pattern.texi   11   11 100.00%   0
   manual/crypt.texi   10   10 100.00%   0
    manual/lang.texi    7    7 100.00%   0
    manual/argp.texi    6    6 100.00%   0
  manual/locale.texi    5    5 100.00%   0
    manual/conf.texi    4    4 100.00%   0
   manual/debug.texi    3    3 100.00%   0
  manual/getopt.texi    3    3 100.00%   0
----
  manual/search.texi   15    7  46.67%   0
  manual/signal.texi   27    7  25.93%   0
manual/resource.texi   31    7  22.58%   0
manual/terminal.texi   24    5  20.83%   0
 manual/startup.texi   15    3  20.00%   0
   manual/users.texi   66   11  16.67%   0
    manual/time.texi   33    5  15.15%   0
  manual/socket.texi   59    5   8.47%   0
 manual/sysinfo.texi   22    1   4.55%   0
----
manual/platform.texi    8    0   0.00%   0
  manual/setjmp.texi    8    0   0.00%   0
  manual/syslog.texi    5    0   0.00%   0
    manual/pipe.texi    4    0   0.00%   0
 manual/threads.texi    2    0   0.00% 119
   manual/libdl.texi    0    0   0.00%   9
----
               Total 1068  800  74.91% 148

---

Alexandre Oliva (33):
      Multi Thread, Async Signal and Async Cancel safety documentation: intro
      MT-, AS- and AC-safety docs: manual/argp.texi
      MT-, AS- and AC-safety docs: manual/arith.texi
      MT-, AS- and AC-safety docs: manual/charset.texi
      MT-, AS- and AC-safety docs: manual/conf.texi
      MT-, AS- and AC-safety docs: manual/crypt.texi
      MT-, AS- and AC-safety docs: manual/ctype.texi
      MT-, AS- and AC-safety docs: manual/debug.texi
      MT-, AS- and AC-safety docs: manual/errno.texi
      MT-, AS- and AC-safety docs: manual/filesys.texi
      MT-, AS- and AC-safety docs: manual/getopt.texi
      MT-, AS- and AC-safety docs: manual/libdl.texi
      MT-, AS- and AC-safety docs: manual/math.texi
      MT-, AS- and AC-safety docs: manual/memory.texi
      MT-, AS- and AC-safety docs: manual/message.texi
      MT-, AS- and AC-safety docs: manual/job.texi
      MT-, AS- and AC-safety docs: manual/lang.texi
      MT-, AS- and AC-safety docs: manual/llio.texi
      MT-, AS- and AC-safety docs: manual/locale.texi
      MT-, AS- and AC-safety docs: manual/pattern.texi
      MT-, AS- and AC-safety docs: manual/process.texi
      MT-, AS- and AC-safety docs: manual/stdio.texi
      MT-, AS- and AC-safety docs: manual/string.texi
      MT-, AS- and AC-safety docs: manual/resource.texi
      MT-, AS- and AC-safety docs: manual/search.texi
      MT-, AS- and AC-safety docs: manual/signal.texi
      MT-, AS- and AC-safety docs: manual/socket.texi
      MT-, AS- and AC-safety docs: manual/startup.texi
      MT-, AS- and AC-safety docs: manual/sysinfo.texi
      MT-, AS- and AC-safety docs: manual/terminal.texi
      MT-, AS- and AC-safety docs: manual/threads.texi
      MT-, AS- and AC-safety docs: manual/time.texi
      MT-, AS- and AC-safety docs: manual/users.texi


 manual/argp.texi     |  181 ++++++++++++
 manual/arith.texi    |  158 +++++++++++
 manual/charset.texi  |   88 ++++++
 manual/conf.texi     |   19 +
 manual/crypt.texi    |   29 ++
 manual/ctype.texi    |   66 +++++
 manual/debug.texi    |   26 ++
 manual/errno.texi    |   43 +++
 manual/filesys.texi  |  221 +++++++++++++++
 manual/getopt.texi   |   29 ++
 manual/intro.texi    |  513 +++++++++++++++++++++++++++++++++++
 manual/job.texi      |   27 ++
 manual/lang.texi     |   14 +
 manual/libdl.texi    |   10 +
 manual/llio.texi     |  255 ++++++++++++++++++
 manual/locale.texi   |  148 ++++++++++
 manual/macros.texi   |   42 +++
 manual/math.texi     |  104 +++++++
 manual/memory.texi   |  542 +++++++++++++++++++++++++++++++++++++
 manual/message.texi  |  159 +++++++++++
 manual/pattern.texi  |  728 ++++++++++++++++++++++++++++++++++++++++++++++++++
 manual/process.texi  |   72 +++++
 manual/resource.texi |   16 +
 manual/search.texi   |   11 +
 manual/signal.texi   |    8 +
 manual/socket.texi   |    5 
 manual/startup.texi  |   26 ++
 manual/stdio.texi    |  252 +++++++++++++++++
 manual/string.texi   |  153 +++++++++--
 manual/sysinfo.texi  |    2 
 manual/terminal.texi |   35 ++
 manual/threads.texi  |  122 ++++++++
 manual/time.texi     |   19 +
 manual/users.texi    |  344 ++++++++++++++++++++++++
 34 files changed, 4444 insertions(+), 23 deletions(-)
 create mode 100644 manual/libdl.texi

-- 
Alexandre Oliva, freedom fighter    http://FSFLA.org/~lxoliva/
You must be the change you wish to see in the world. -- Gandhi
Be Free! -- http://FSFLA.org/   FSF Latin America board member
Free Software Evangelist      Red Hat Brazil Compiler Engineer