This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[PATCH 00/28] Thread-, Signal- and Cancellation-safety documentation (take 3)


Here's an updated patchset for the documentation project I've been
working on.  It's all in branch lxoliva/thread-safety-docs too.

You'll see a number of additional files were completed since the last
patchset I posted on May 3rd.  I'm using stgit to email them for the
first time, so please let me know (and bear with me) if there's
something undesirable about posting them this way.

The first few patches are adjustments or fixes for issues that I found
out while reviewing the code to assess its safety properties.  Patches
for the manual documenting these properties follow; many files are
complete, but the ones starting at the locale.texi patch, 20/28, are
still work in progress, with only a few documented functions that
happened to be dependencies of those in the files that have already
been completed, or other adjustments to the documentation that I
deemed useful.

For all the documented functions, there's a @safety{} note with the
assessment that resulted from my code review.  In some cases, there
will also be comments that justify those results.  In a few cases of
deep dependency trees, textual comments weren't enough to figure out
the results, so I resorted to depicting the dependency tree through
indented comments, so that it was easier to progressively analyze a
multitude of functions that aren't part of the exposed interface and
aggregate the results as required to reach a conclusion for the top of
the tree.  I'm not entirely sure these comments belong in the manual,
but it was the convenient place for me to add them, so I left them in
the patchset for now.  I'm hesitant to just drop them on the floor,
since they may turn out to be useful as a starting point in case
significant code changes are made and the results have to be
reassessed.  Thoughts on this matter (and any other related matter,
really :-) are welcome.

So, which of these, if any, are suitable for inclusion in the
development tree?  What adjustments should be made to those that
aren't?

Thanks in advance,

---

Alexandre Oliva (28):
      Note that powerpc fpu emulation status is not thread- or signal-safe.
      Rename unused scalb to scalbn to match prototype.
      Remove unused sysdeps/ieee754/support.c.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.
      Thread safety documentation.


 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                           |   18 +
 manual/errno.texi                           |   43 ++
 manual/filesys.texi                         |  221 +++++++++++
 manual/getopt.texi                          |   29 ++
 manual/intro.texi                           |  406 +++++++++++++++++++++
 manual/job.texi                             |   27 +
 manual/lang.texi                            |   14 +
 manual/libdl.texi                           |   10 +
 manual/llio.texi                            |  255 +++++++++++++
 manual/locale.texi                          |   10 +
 manual/macros.texi                          |   42 ++
 manual/math.texi                            |    1 
 manual/resource.texi                        |   16 +
 manual/search.texi                          |   10 +
 manual/startup.texi                         |    4 
 manual/stdio.texi                           |  246 +++++++++++++
 manual/string.texi                          |    4 
 manual/terminal.texi                        |    6 
 manual/threads.texi                         |  122 ++++++
 manual/time.texi                            |    6 
 ports/sysdeps/powerpc/nofpu/sim-full.c      |    5 
 ports/sysdeps/powerpc/nofpu/soft-supp.h     |    5 
 ports/sysdeps/powerpc/soft-fp/sfp-machine.h |    5 
 sysdeps/ieee754/support.c                   |  520 ---------------------------
 30 files changed, 2044 insertions(+), 522 deletions(-)
 create mode 100644 manual/libdl.texi
 delete mode 100644 sysdeps/ieee754/support.c

-- 
Signature


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]