From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 9154 invoked by alias); 18 Mar 2009 16:37:51 -0000 Mailing-List: contact archer-commits-help@sourceware.org; run by ezmlm Sender: Precedence: bulk List-Post: List-Help: List-Subscribe: Received: (qmail 9125 invoked by uid 306); 18 Mar 2009 16:37:48 -0000 Date: Wed, 18 Mar 2009 16:37:00 -0000 Message-ID: <20090318163748.9110.qmail@sourceware.org> From: tromey@sourceware.org To: archer-commits@sourceware.org Subject: [SCM] archer-tromey-charset: Document iconv dependency X-Git-Refname: refs/heads/archer-tromey-charset X-Git-Reftype: branch X-Git-Oldrev: 10bb83dbe042456bb001c0f0bd1f891d13600d17 X-Git-Newrev: 895c727c6f70bc6e1c889e4829c2a2b2bae098dc X-SW-Source: 2009-q1/txt/msg00344.txt.bz2 List-Id: The branch, archer-tromey-charset has been updated via 895c727c6f70bc6e1c889e4829c2a2b2bae098dc (commit) from 10bb83dbe042456bb001c0f0bd1f891d13600d17 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email. - Log ----------------------------------------------------------------- commit 895c727c6f70bc6e1c889e4829c2a2b2bae098dc Author: Tom Tromey Date: Wed Mar 18 10:37:29 2009 -0600 Document iconv dependency 2009-03-18 Tom Tromey * gdb.texinfo (Requirements): Mention iconv. ----------------------------------------------------------------------- Summary of changes: gdb/NEWS | 4 +++- gdb/doc/gdb.texinfo | 18 ++++++++++++++++++ 2 files changed, 21 insertions(+), 1 deletions(-) First 500 lines of diff: diff --git a/gdb/NEWS b/gdb/NEWS index 3f084e7..a8ddd45 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -8,7 +8,9 @@ target. Strings whose character type is wchar_t, char16_t, or char32_t are now correctly printed. GDB supports wide- and unicode- literals in C, that is, L'x', L"string", u'x', u"string", U'x', and U"string" syntax. And, GDB allows the "%ls" and "%lc" formats in -`printf'. +`printf'. This feature requires iconv to work properly; if your +system does not have a working iconv, GDB can use GNU libiconv. See +the installation instructions for more information. * GDB now supports automatic retrieval of shared library files from remote targets. To use this feature, specify a system root that begins diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7a49aea..44f7b4d 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -24734,6 +24734,24 @@ The @samp{zlib} library is likely included with your operating system distribution; if it is not, you can get the latest version from @url{http://zlib.net}. +@item iconv +@value{GDBN}'s features related to character sets (@pxref{Character +Sets}) require a functioning @code{iconv} implementation. If you are +on a GNU system, then this is provided by the GNU C Library. Some +other systems also provide a working @code{iconv}. + +On systems with @code{iconv}, you can install GNU Libiconv. If you +have previously installed Libiconv, you can use the +@option{--with-libiconv-prefix} option to configure. + +@value{GDBN}'s top-level @file{configure} and @file{Makefile} will +arrange to build Libiconv if a directory named @file{libiconv} appears +in the top-most source directory. If Libiconv is built this way, and +if the operating system does not provide a suitable @code{iconv} +implementation, then the just-built library will automatically be used +by @value{GDBN}. One easy way to set this up is to download GNU +Libiconv, unpack it, and then rename the directory holding the +Libiconv source code to @samp{libiconv}. @end table @node Running Configure hooks/post-receive -- Repository for Project Archer.