qiurui
/
glibc
mirror of git://sourceware.org/git/glibc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update. 

1999-01-12  Andreas Jaeger  <aj@arthur.rhein-neckar.de>

	* manual/charset.texi: Fix some typos.
This commit is contained in:
Ulrich Drepper 1999-01-12 08:12:19 +00:00
parent 281631fba8
commit c1b2d47280
2 changed files with 24 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@ -1,3 +1,7 @@
1999-01-12 Andreas Jaeger <aj@arthur.rhein-neckar.de>
* manual/charset.texi: Fix some typos.
1999-01-12 Ulrich Drepper <drepper@cygnus.com> 1999-01-12 Ulrich Drepper <drepper@cygnus.com>
* login/programs/pt_chown.c (main): Update copyright year. * login/programs/pt_chown.c (main): Update copyright year.

40
manual/charset.texi
View File

@ -582,7 +582,7 @@ There also is a function for the conversion in the other direction.
@comment ISO @comment ISO
@deftypefun int wctob (wint_t @var{c}) @deftypefun int wctob (wint_t @var{c})
The @code{wctob} function (``wide character to byte'') takes as the The @code{wctob} function (``wide character to byte'') takes as the
paremeter a valid wide character. If the multibyte representation for parameter a valid wide character. If the multibyte representation for
this character in the initial state is exactly one byte long the return this character in the initial state is exactly one byte long the return
value of this function is this character. Otherwise the return value is value of this function is this character. Otherwise the return value is
@code{EOF}. @code{EOF}.
@ -770,7 +770,7 @@ Please note that the @code{mbslen} function is quite inefficient. The
implementation of @code{mbstouwcs} implemented using @code{mbslen} would implementation of @code{mbstouwcs} implemented using @code{mbslen} would
have to perform the conversion of the multibyte character input string have to perform the conversion of the multibyte character input string
twice and this conversion might be quite expensive. So it is necessary twice and this conversion might be quite expensive. So it is necessary
to think about the consequences of using the easier but inprecise method to think about the consequences of using the easier but imprecise method
before doing the work twice. before doing the work twice.
@comment wchar.h @comment wchar.h
@ -1581,7 +1581,7 @@ The first step is the function to create a handle.
@deftypefun iconv_t iconv_open (const char *@var{tocode}, const char *@var{fromcode}) @deftypefun iconv_t iconv_open (const char *@var{tocode}, const char *@var{fromcode})
The @code{iconv_open} function has to be used before starting a The @code{iconv_open} function has to be used before starting a
conversion. The two parameters this function takes determine the conversion. The two parameters this function takes determine the
sources and destination character set for the conversion and if the source and destination character set for the conversion and if the
implementation has the possibility to perform such a conversion the implementation has the possibility to perform such a conversion the
function returns a handle. function returns a handle.
@ -1606,7 +1606,7 @@ with the descriptor there is information about the conversion state.
This must of course not be messed up by using it in different This must of course not be messed up by using it in different
conversions. conversions.
An @code{iconv} descriptor is just a file descriptor as for every use a An @code{iconv} descriptor is like a file descriptor as for every use a
new descriptor must be created. The descriptor does not stand for all new descriptor must be created. The descriptor does not stand for all
of the conversions from @var{fromset} to @var{toset}. of the conversions from @var{fromset} to @var{toset}.
@ -1708,7 +1708,7 @@ performed if some protocol requires this for the output text.
The conversion stops for three reasons. The first is that all The conversion stops for three reasons. The first is that all
characters from the input buffer are converted. This actually can mean characters from the input buffer are converted. This actually can mean
two things: really all bytes from the input buffer are consumed or the two things: really all bytes from the input buffer are consumed or
there are some bytes at the end of the buffer which possibly can form a there are some bytes at the end of the buffer which possibly can form a
complete character but the input is incomplete. The second reason for a complete character but the input is incomplete. The second reason for a
stop is when the output buffer is full. And the third reason is that stop is when the output buffer is full. And the third reason is that
@ -1729,7 +1729,7 @@ desirable solution. Therefore future versions will provide better ones
but they are not yet finished. but they are not yet finished.
If all input from the input buffer is successfully converted and stored If all input from the input buffer is successfully converted and stored
in the output buffer the function returns the number of conversion in the output buffer the function returns the number of conversions
performed. In all other cases the return value is @code{(size_t) -1} performed. In all other cases the return value is @code{(size_t) -1}
and @code{errno} is set appropriately. In this case the value pointed and @code{errno} is set appropriately. In this case the value pointed
to by @var{inbytesleft} is nonzero. to by @var{inbytesleft} is nonzero.
@ -1889,7 +1889,7 @@ above case the input parameter to the function is a @code{wchar_t}
pointer this is the case (unless the user violates alignment when pointer this is the case (unless the user violates alignment when
computing the parameter). But in other situations, especially when computing the parameter). But in other situations, especially when
writing generic functions where one does not know what type of character writing generic functions where one does not know what type of character
set on uses and therefore treats text as a sequence of bytes, it might set one uses and therefore treats text as a sequence of bytes, it might
become tricky. become tricky.
@ -1936,7 +1936,7 @@ Some implementations in commercial Unices implement a mixture of these
possibilities, the majority only the second solution. This often leads possibilities, the majority only the second solution. This often leads
to problems, though. Since the modules with the conversion modules must to problems, though. Since the modules with the conversion modules must
be dynamically loaded the system must have this possibility for all be dynamically loaded the system must have this possibility for all
programs. But this is not the case. At least some platforms (if no programs. But this is not the case. At least some platforms (if not
all) are not able to dynamically load objects if the program is linked all) are not able to dynamically load objects if the program is linked
statically. This is often solved by outlawing static linking entirely statically. This is often solved by outlawing static linking entirely
but sure it is a weak solution. The GNU C library does not have this but sure it is a weak solution. The GNU C library does not have this
@ -1945,7 +1945,7 @@ get acquainted with this and forgets about the restriction on other
systems. systems.
A second thing to know about other @code{iconv} implementations is that A second thing to know about other @code{iconv} implementations is that
the number of available conversion is often very limited. Some the number of available conversions is often very limited. Some
implementations provide in the standard release (not the special implementations provide in the standard release (not the special
international release, if something exists) at most 100 to 200 international release, if something exists) at most 100 to 200
conversion possibilities. This does not mean 200 different character conversion possibilities. This does not mean 200 different character
@ -1957,7 +1957,7 @@ of conversions which renders them useless for almost all uses.
This directly leads to a third and probably the most problematic point. This directly leads to a third and probably the most problematic point.
The way the @code{iconv} conversion functions are implemented on all The way the @code{iconv} conversion functions are implemented on all
known Unix system the availability of the conversion functions from known Unix system and the availability of the conversion functions from
character set @math{@cal{A}} to @math{@cal{B}} and the conversion from character set @math{@cal{A}} to @math{@cal{B}} and the conversion from
@math{@cal{B}} to @math{@cal{C}} does @emph{not} imply that the @math{@cal{B}} to @math{@cal{C}} does @emph{not} imply that the
conversion from @math{@cal{A}} to @math{@cal{C}} is available. conversion from @math{@cal{A}} to @math{@cal{C}} is available.
@ -2034,20 +2034,20 @@ well documented (see below) and it therefore is easy to write new
conversion modules. The drawback of using loadable object is not a conversion modules. The drawback of using loadable object is not a
problem in the GNU C library, at least on ELF systems. Since the problem in the GNU C library, at least on ELF systems. Since the
library is able to load shared objects even in statically linked library is able to load shared objects even in statically linked
binaries this means that static linking must not be forbidden in case binaries this means that static linking needs not to be forbidden in case
one wants to use @code{iconv}. one wants to use @code{iconv}.
The second mentioned problems is the number of supported conversions. The second mentioned problems is the number of supported conversions.
First, the GNU C library supports more then 150 character. And the was First, the GNU C library supports more than 150 character sets. And the
the implementation is designed the number of supported conversions is way the implementation is designed the number of supported conversions
greater than 22350 (@math{150} times @math{149}). If any conversion is greater than 22350 (@math{150} times @math{149}). If any conversion
from or to a character set is missing it can easily be added. from or to a character set is missing it can easily be added.
This high number is due to the fact that the GNU C library This high number is due to the fact that the GNU C library
implementation of @code{iconv} does not have the third problem mentioned implementation of @code{iconv} does not have the third problem mentioned
above. I.e., whenever there is a conversion from a character set above. I.e., whenever there is a conversion from a character set
@math{@cal{A}} to @math{@cal{B}} and from @math{@cal{B}} to @math{@cal{A}} to @math{@cal{B}} and from @math{@cal{B}} to
@math{@cal{C}} it always is possible to convert from @math{@cal{A}} to @math{@cal{C}} it is always possible to convert from @math{@cal{A}} to
@math{@cal{C}} directly. If the @code{iconv_open} returns an error and @math{@cal{C}} directly. If the @code{iconv_open} returns an error and
sets @code{errno} to @code{EINVAL} this really means there is no known sets @code{errno} to @code{EINVAL} this really means there is no known
way, directly or indirectly, to perform the wanted conversion. way, directly or indirectly, to perform the wanted conversion.
@ -2059,8 +2059,8 @@ intermediate representation it is possible to ``triangulate''.
There is no inherent requirement to provide a conversion to @w{ISO There is no inherent requirement to provide a conversion to @w{ISO
10646} for a new character set and it is also possible to provide other 10646} for a new character set and it is also possible to provide other
conversion where neither source not destination character set is @w{ISO conversions where neither source not destination character set is @w{ISO
10646}. The currently existing set of conversion is simply meant to 10646}. The currently existing set of conversions is simply meant to
convert all conversions which might be of interest. What could be done convert all conversions which might be of interest. What could be done
in future is improving the speed of certain conversions. in future is improving the speed of certain conversions.
@ -2087,7 +2087,7 @@ text files, where each of the lines has one of the following formats:
@itemize @bullet @itemize @bullet
@item @item
If the first non-whitespace character is a @kbd{#} the line contains If the first non-whitespace character is a @kbd{#} the line contains
only comments is is ignored. only comments and is ignored.
@item @item
Lines starting with @code{alias} define an alias name for a character Lines starting with @code{alias} define an alias name for a character
@ -2105,7 +2105,7 @@ sets specified by the ISO have an alias of the form
@code{ISO-IR-@var{nnn}} where @var{nnn} is the registration number. @code{ISO-IR-@var{nnn}} where @var{nnn} is the registration number.
This allows programs which know about the registration number to This allows programs which know about the registration number to
construct character set names and use them in @code{iconv_open} calls. construct character set names and use them in @code{iconv_open} calls.
More on the available names and alias follows below. More on the available names and aliases follows below.
@item @item
Lines starting with @code{module} introduce an available conversion Lines starting with @code{module} introduce an available conversion
@ -2353,7 +2353,7 @@ This element must never be modified.
@item mbstate_t *statep @item mbstate_t *statep
The @code{statep} element points to an object of type @code{mbstate_t} The @code{statep} element points to an object of type @code{mbstate_t}
(@pxref{Keeping the state}). The conversion of an stateful charater (@pxref{Keeping the state}). The conversion of an stateful character
set must use the object pointed to by this element to store information set must use the object pointed to by this element to store information
about the conversion state. The @code{statep} element itself must never about the conversion state. The @code{statep} element itself must never
be modified. be modified.