X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gettext-runtime%2Flibasprintf%2Fautosprintf.info;h=435cb088ac78b8bd0c6910845d04d41a7f976966;hb=5d61132f836323aaf2879e04abc9d4056db248a2;hp=37af0bddb1a149235f2022eccaff6351e2871800;hpb=90a3363ce7c017439e9953fd5e832fbef8db0dd5;p=platform%2Fupstream%2Fgettext.git diff --git a/gettext-runtime/libasprintf/autosprintf.info b/gettext-runtime/libasprintf/autosprintf.info index 37af0bd..435cb08 100644 --- a/gettext-runtime/libasprintf/autosprintf.info +++ b/gettext-runtime/libasprintf/autosprintf.info @@ -1,32 +1,31 @@ -This is autosprintf.info, produced by makeinfo version 4.13 from +This is autosprintf.info, produced by makeinfo version 5.1 from autosprintf.texi. -INFO-DIR-SECTION C++ libraries -START-INFO-DIR-ENTRY -* autosprintf: (autosprintf). Support for printf format strings in C++. -END-INFO-DIR-ENTRY - - This file provides documentation for GNU `autosprintf' library. - - Copyright (C) 2002-2003, 2006-2007 Free Software Foundation, Inc. +Copyright (C) 2002-2003, 2006-2007 Free Software Foundation, Inc. This manual is free documentation. It is dually licensed under the -GNU FDL and the GNU GPL. This means that you can redistribute this +GNU FDL and the GNU GPL. This means that you can redistribute this manual under either of these two licenses, at your choice. - This manual is covered by the GNU FDL. Permission is granted to -copy, distribute and/or modify this document under the terms of the GNU -Free Documentation License (FDL), either version 1.2 of the License, or -(at your option) any later version published by the Free Software -Foundation (FSF); with no Invariant Sections, with no Front-Cover Text, -and with no Back-Cover Texts. A copy of the license is at -`http://www.gnu.org/licenses/fdl.html'. + This manual is covered by the GNU FDL. Permission is granted to copy, +distribute and/or modify this document under the terms of the GNU Free +Documentation License (FDL), either version 1.2 of the License, or (at +your option) any later version published by the Free Software Foundation +(FSF); with no Invariant Sections, with no Front-Cover Text, and with no +Back-Cover Texts. A copy of the license is at +. + + This manual is covered by the GNU GPL. You can redistribute it and/or +modify it under the terms of the GNU General Public License (GPL), +either version 2 of the License, or (at your option) any later version +published by the Free Software Foundation (FSF). A copy of the license +is at . +INFO-DIR-SECTION C++ libraries +START-INFO-DIR-ENTRY +* autosprintf: (autosprintf). Support for printf format strings in C++. +END-INFO-DIR-ENTRY - This manual is covered by the GNU GPL. You can redistribute it -and/or modify it under the terms of the GNU General Public License -(GPL), either version 2 of the License, or (at your option) any later -version published by the Free Software Foundation (FSF). A copy of the -license is at `http://www.gnu.org/licenses/gpl.html'. + This file provides documentation for GNU 'autosprintf' library.  File: autosprintf.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) @@ -39,8 +38,8 @@ This manual documents the GNU autosprintf class, version 1.0. * Menu: * Introduction:: Introduction -* Class autosprintf:: The `autosprintf' class -* Using autosprintf:: Using `autosprintf' in own programs +* Class autosprintf:: The 'autosprintf' class +* Using autosprintf:: Using 'autosprintf' in own programs  File: autosprintf.info, Node: Introduction, Next: Class autosprintf, Prev: Top, Up: Top @@ -48,9 +47,9 @@ File: autosprintf.info, Node: Introduction, Next: Class autosprintf, Prev: To 1 Introduction ************** -This package makes the C formatted output routines (`fprintf' et al.) -usable in C++ programs, for use with the `' strings and the -`' streams. +This package makes the C formatted output routines ('fprintf' et al.) +usable in C++ programs, for use with the '' strings and the +'' streams. It allows to write code like @@ -62,73 +61,73 @@ instead of The benefits of the autosprintf syntax are: - * It reuses the standard POSIX printf facility. Easy migration from + * It reuses the standard POSIX printf facility. Easy migration from C to C++. * English sentences are kept together. - * It makes internationalization possible. Internationalization - requires format strings, because in some cases the translator - needs to change the order of a sentence, and more generally it is - easier for the translator to work with a single string for a - sentence than with multiple string pieces. + * It makes internationalization possible. Internationalization + requires format strings, because in some cases the translator needs + to change the order of a sentence, and more generally it is easier + for the translator to work with a single string for a sentence than + with multiple string pieces. - * It reduces the risk of programming errors due to forgotten state - in the output stream (e.g. `cout << hex;' not followed by `cout << + * It reduces the risk of programming errors due to forgotten state in + the output stream (e.g. 'cout << hex;' not followed by 'cout << dec;').  File: autosprintf.info, Node: Class autosprintf, Next: Using autosprintf, Prev: Introduction, Up: Top -2 The `autosprintf' class +2 The 'autosprintf' class ************************* -An instance of class `autosprintf' just contains a string with the -formatted output result. Such an instance is usually allocated as an -automatic storage variable, i.e. on the stack, not with `new' on the +An instance of class 'autosprintf' just contains a string with the +formatted output result. Such an instance is usually allocated as an +automatic storage variable, i.e. on the stack, not with 'new' on the heap. - The constructor `autosprintf (const char *format, ...)' takes a -format string and additional arguments, like the C function `printf'. + The constructor 'autosprintf (const char *format, ...)' takes a +format string and additional arguments, like the C function 'printf'. - Conversions to `char *' and `std::string' are defined that return -the encapsulated string. The conversion to `char *' returns a freshly + Conversions to 'char *' and 'std::string' are defined that return the +encapsulated string. The conversion to 'char *' returns a freshly allocated copy of the encapsulated string; it needs to be freed using -`delete[]'. The conversion to `std::string' returns a copy of the +'delete[]'. The conversion to 'std::string' returns a copy of the encapsulated string, with automatic memory management. - The destructor `~autosprintf ()' destroys the encapsulated string. + The destructor '~autosprintf ()' destroys the encapsulated string. - An `operator <<' is provided that outputs the encapsulated string to -the given `ostream'. + An 'operator <<' is provided that outputs the encapsulated string to +the given 'ostream'.  File: autosprintf.info, Node: Using autosprintf, Prev: Class autosprintf, Up: Top -3 Using `autosprintf' in own programs +3 Using 'autosprintf' in own programs ************************************* -To use the `autosprintf' class in your programs, you need to add +To use the 'autosprintf' class in your programs, you need to add #include "autosprintf.h" using gnu::autosprintf; -to your source code. The include file defines the class `autosprintf', -in a namespace called `gnu'. The `using' statement makes it possible to -use the class without the (otherwise natural) `gnu::' prefix. +to your source code. The include file defines the class 'autosprintf', +in a namespace called 'gnu'. The 'using' statement makes it possible to +use the class without the (otherwise natural) 'gnu::' prefix. - When linking your program, you need to link with `libasprintf', -because that's where the class is defined. In projects using GNU -`autoconf', this means adding `AC_LIB_LINKFLAGS([asprintf])' to -`configure.in' or `configure.ac', and using the @LIBASPRINTF@ Makefile + When linking your program, you need to link with 'libasprintf', +because that's where the class is defined. In projects using GNU +'autoconf', this means adding 'AC_LIB_LINKFLAGS([asprintf])' to +'configure.in' or 'configure.ac', and using the @LIBASPRINTF@ Makefile variable that it provides.  Tag Table: -Node: Top1348 -Node: Introduction1708 -Node: Class autosprintf2859 -Node: Using autosprintf3869 +Node: Top1339 +Node: Introduction1699 +Node: Class autosprintf2852 +Node: Using autosprintf3863  End Tag Table