Browse Source

Remove comments about wordexp.

Eric Andersen 22 years ago
parent
commit
696ea9299e
3 changed files with 29 additions and 25 deletions
  1. 5 7
      docs/Glibc_vs_uClibc_Differences.txt
  2. 4 4
      docs/uClibc_vs_SuSv3.txt
  3. 20 14
      docs/uclibc.org/FAQ.html

+ 5 - 7
docs/Glibc_vs_uClibc_Differences.txt

@@ -22,7 +22,8 @@ all your binaries.
 uClibc calling malloc(0) returns a NULL.  The behavior of malloc(0) is listed
 uClibc calling malloc(0) returns a NULL.  The behavior of malloc(0) is listed
 as implementation-defined by SuSv3, so both libraries are equally correct.
 as implementation-defined by SuSv3, so both libraries are equally correct.
 This difference also applies to realloc(NULL, 0).  I personally feel glibc's
 This difference also applies to realloc(NULL, 0).  I personally feel glibc's
-behavior is not particularly safe.
+behavior is not particularly safe.  To enable glibc behavior, one has to
+explicitly enable the MALLOC_GLIBC_COMPAT option.
 
 
 4.1) glibc's malloc() implementation has behavior that is tunable via the
 4.1) glibc's malloc() implementation has behavior that is tunable via the
 MALLOC_CHECK_ environment variable.  This is primarily used to provide extra
 MALLOC_CHECK_ environment variable.  This is primarily used to provide extra
@@ -62,14 +63,11 @@ then the long double support is quite limited.
 11) uClibc's libcrypt does not support the reentrant crypt_r, setkey_r and
 11) uClibc's libcrypt does not support the reentrant crypt_r, setkey_r and
 encrypt_r, since these are not required by SuSv3.
 encrypt_r, since these are not required by SuSv3.
 
 
-12) uClibc does not implement wordexp()
+12) uClibc directly uses the kernel types to define most opaque data types.
 
 
+13) uClibc directly uses the linux kernel's arch specific 'stuct stat'.
 
 
-13) uClibc directly uses the kernel types to define most opaque data types.
+14) Add other things here as they come up......
-
-14) uClibc directly uses the linux kernel's arch specific 'stuct stat'.
-
-15) Add other things here as they come up......
 
 
 
 
 
 

+ 4 - 4
docs/uClibc_vs_SuSv3.txt

@@ -25,10 +25,10 @@ and the requirements of the SuSv3.
     call has finished.
     call has finished.
 
 
 2) Some functions required by SuSv3 are not currently implemented.
 2) Some functions required by SuSv3 are not currently implemented.
-    The function you are mostly likely to encounter is wordexp().
+    Functions listed by SuSv3 but not (yet) included in uClibc:
-    A couple of years ago, nobody used wordexp.  Now some apps do.
+
-    One of these days, someone may provide us with a well written
+	fmtmsg, ftw, nftw, <dunno for certain> 
-    patch to implement it...
+
 
 
 More to follow when we think of it...
 More to follow when we think of it...
 
 

+ 20 - 14
docs/uclibc.org/FAQ.html

@@ -109,20 +109,26 @@ to the uClibc home page.</a>
 </TD></TR>
 </TD></TR>
 <TR><TD BGCOLOR="#eeeee0">
 <TR><TD BGCOLOR="#eeeee0">
 
 
-    uClibc has been designed from the ground up to be a C library for
+    uClibc has been designed from the ground up to be a C library for embedded
-    embedded Linux.  We don't need to worry about things like MS-DOS
+    Linux.  We don't need to worry about things like MS-DOS support, or BeOS,
-    support, or BeOS, or AmigaOs any other system.  This lets us cut out
+    or AmigaOs any other system.  This lets us cut out a lot of complexity and
-    a lot of complexity and very carefully optimize for Linux.  By very
+    very carefully optimize for Linux.  By very careful design, we can also
-    careful design, we can also take a few shortcuts.  For example, glibc
+    take a few shortcuts.  
-    contains an implementation of the wordexp() function, in compliance
+<!-- FIXME
-    with the Single Unix Specification, version 3.  Well, standards are
+    For example, glibc's stdio code (handling things
-    important.  But so is pragmatism.  The wordexp function is huge, yet I
+    like printf, scanf, fopen, etc) has been evolved over many years by
-    am not aware of even one Linux application that uses it!  So uClibc
+    patching various bits of additional functionality as needed.  uClibc's
-    doesn't provide wordexp().  There are many similar examples.  In other
+    stdio code was written by just one person, and was carefully designed from
-    cases, uClibc leaves certain features (such as full C99 Math library
+    the outset to comply with the latest standards while carefully reusing code
-    support, IPV6, and RPC support) disabled by default.  Those features
+    and being as small and configurable as possible,  In this way, uClibc's
-    can be enabled for people that need them, but are otherwise disabled to
+    stdio code...
-    save space.
+
+    There are many similar examples.  
+-->
+    In other cases, uClibc
+    leaves certain features (such as full C99 Math library support, IPV6, and
+    RPC support) disabled by default.  Those features can be enabled for people
+    that need them, but are otherwise disabled to save space.
 
 
     <p>
     <p>