diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml new file mode 100644 index 00000000..802b1ad1 --- /dev/null +++ b/.github/workflows/test.yml @@ -0,0 +1,59 @@ +name: Test + +on: + release: + types: [published] + push: + branches: [ "main" ] + workflow_dispatch: + +jobs: + test-linux: + + runs-on: ubuntu-latest + + steps: + #--------------------------------------------collect-------------------------------------------- + - uses: actions/checkout@v3 + + - name: Collect dependencies + run: | + sudo apt-get update + sudo apt-get install gcc cmake -y + + #--------------------------------------------build-------------------------------------------- + - name: Build + run : | + mkdir build + cd build + cmake .. -DENABLE_EXTRA=ON -DENABLE_TEST=ON + + #--------------------------------------------test-------------------------------------------- + - name: Test + run : | + ctest --verbose --output-on-failure + + + test-macos: + + runs-on: macos-latest + + steps: + #--------------------------------------------collect-------------------------------------------- + - uses: actions/checkout@v3 + + - name: Collect dependencies + run: | + brew install cmake -y + + #--------------------------------------------build-------------------------------------------- + - name: Build + run : | + mkdir build + cd build + cmake .. -DENABLE_EXTRA=ON -DENABLE_TEST=ON + + #--------------------------------------------test-------------------------------------------- + - name: Test + run : | + ctest --verbose --output-on-failure diff --git a/.gitignore b/.gitignore index e324378d..9c017a07 100644 --- a/.gitignore +++ b/.gitignore @@ -1,549 +1,65 @@ -## This file specifies the files and directories that can usually occur in a -## developer build of this Git repository. -## -## Reference: https://git-scm.com/docs/gitignore -## -## When we say, "files", it actually means files and directories. By -## convention, directories are marked through a trailing first and listed -## first in each category. - -# Files brought in by gnulib-tool: -/build-aux/config.libpath -/build-aux/config.rpath -/build-aux/install-reloc -/build-aux/libtool-reloc -/build-aux/reloc-ldflags -/doc/relocatable.texi -/libcharset/INSTALL.generic -/libcharset/build-aux/config.libpath -/libcharset/build-aux/libtool-reloc -/libcharset/m4/codeset.m4 -/libcharset/m4/fcntl-o.m4 -/libcharset/m4/lib-ld.m4 -/libcharset/m4/relocatable-lib.m4 -/libcharset/m4/relocatable.m4 -/libcharset/m4/visibility.m4 -/srclib/_Noreturn.h -/srclib/Makefile.gnulib -/srclib/alloca.in.h -/srclib/allocator.c -/srclib/allocator.h -/srclib/areadlink.c -/srclib/areadlink.h -/srclib/assert.in.h -/srclib/basename-lgpl.c -/srclib/basename-lgpl.h -/srclib/binary-io.c -/srclib/binary-io.h -/srclib/c-ctype.c -/srclib/c-ctype.h -/srclib/canonicalize-lgpl.c -/srclib/careadlinkat.c -/srclib/careadlinkat.h -/srclib/cdefs.h -/srclib/cloexec.c -/srclib/cloexec.h -/srclib/close.c -/srclib/dup2.c -/srclib/eloop-threshold.h -/srclib/errno.in.h -/srclib/error.c -/srclib/error.in.h -/srclib/fcntl.in.h -/srclib/fcntl.c -/srclib/fd-hook.c -/srclib/fd-hook.h -/srclib/filename.h -/srclib/free.c -/srclib/fstat.c -/srclib/getdtablesize.c -/srclib/getprogname.c -/srclib/getprogname.h -/srclib/gettext.h -/srclib/idx.h -/srclib/intprops-internal.h -/srclib/intprops.h -/srclib/inttypes.in.h -/srclib/libc-config.h -/srclib/limits.in.h -/srclib/localcharset.h -/srclib/malloc/scratch_buffer.h -/srclib/malloc/scratch_buffer_grow.c -/srclib/malloc/scratch_buffer_grow_preserve.c -/srclib/malloc/scratch_buffer_set_array_size.c -/srclib/malloc.c -/srclib/malloca.c -/srclib/malloca.h -/srclib/mempcpy.c -/srclib/minmax.h -/srclib/msvc-inval.c -/srclib/msvc-inval.h -/srclib/msvc-nothrow.c -/srclib/msvc-nothrow.h -/srclib/open.c -/srclib/pathmax.h -/srclib/progname.c -/srclib/progname.h -/srclib/progreloc.c -/srclib/raise.c -/srclib/rawmemchr.c -/srclib/rawmemchr.valgrind -/srclib/read.c -/srclib/readlink.c -/srclib/realloc.c -/srclib/relocatable.c -/srclib/relocatable.h -/srclib/relocwrapper.c -/srclib/safe-read.c -/srclib/safe-read.h -/srclib/scratch_buffer.h -/srclib/setenv.c -/srclib/signal.in.h -/srclib/sigprocmask.c -/srclib/stat.c -/srclib/stat-time.c -/srclib/stat-time.h -/srclib/stat-w32.c -/srclib/stat-w32.h -/srclib/stdckdint.in.h -/srclib/stddef.in.h -/srclib/stdint.in.h -/srclib/stdio-read.c -/srclib/stdio-write.c -/srclib/stdio.in.h -/srclib/stdlib.in.h -/srclib/streq.h -/srclib/strerror-override.c -/srclib/strerror-override.h -/srclib/strerror.c -/srclib/string.in.h -/srclib/sys-limits.h -/srclib/sys_stat.in.h -/srclib/sys_types.in.h -/srclib/time.in.h -/srclib/unictype/bitmap.h -/srclib/unistd.c -/srclib/unistd.in.h -/srclib/unitypes.in.h -/srclib/uniwidth.in.h -/srclib/unlocked-io.h -/srclib/verify.h -/srclib/wchar.in.h -/srclib/xalloc-oversized.h -/srclib/xalloc.h -/srclib/xmalloc.c -/srclib/xreadlink.c -/srclib/xreadlink.h -/srclib/xstrdup.c -/srclib/uniwidth/cjk.h -/srclib/uniwidth/width.c -/srclib/uniwidth/width0.h -/srclib/uniwidth/width2.h -/srcm4/00gnulib.m4 -/srcm4/__inline.m4 -/srcm4/absolute-header.m4 -/srcm4/alloca.m4 -/srcm4/asm-underscore.m4 -/srcm4/assert_h.m4 -/srcm4/builtin-expect.m4 -/srcm4/c-bool.m4 -/srcm4/canonicalize.m4 -/srcm4/close.m4 -/srcm4/codeset.m4 -/srcm4/double-slash-root.m4 -/srcm4/dup2.m4 -/srcm4/eealloc.m4 -/srcm4/environ.m4 -/srcm4/errno_h.m4 -/srcm4/error.m4 -/srcm4/error_h.m4 -/srcm4/extensions.m4 -/srcm4/extern-inline.m4 -/srcm4/fcntl.m4 -/srcm4/fcntl-o.m4 -/srcm4/fcntl_h.m4 -/srcm4/free.m4 -/srcm4/fstat.m4 -/srcm4/getdtablesize.m4 -/srcm4/getprogname.m4 -/srcm4/gettext.m4 -/srcm4/gnulib-common.m4 -/srcm4/gnulib-comp.m4 -/srcm4/gnulib-tool.m4 -/srcm4/host-cpu-c-abi.m4 -/srcm4/iconv.m4 -/srcm4/include_next.m4 -/srcm4/intl-thread-locale.m4 -/srcm4/intlmacosx.m4 -/srcm4/inttypes.m4 -/srcm4/largefile.m4 -/srcm4/lib-ld.m4 -/srcm4/lib-link.m4 -/srcm4/lib-prefix.m4 -/srcm4/libunistring-base.m4 -/srcm4/limits-h.m4 -/srcm4/locale-fr.m4 -/srcm4/lstat.m4 -/srcm4/malloc.m4 -/srcm4/malloca.m4 -/srcm4/mbstate_t.m4 -/srcm4/mempcpy.m4 -/srcm4/minmax.m4 -/srcm4/mode_t.m4 -/srcm4/msvc-inval.m4 -/srcm4/msvc-nothrow.m4 -/srcm4/multiarch.m4 -/srcm4/musl.m4 -/srcm4/nls.m4 -/srcm4/nocrash.m4 -/srcm4/off_t.m4 -/srcm4/open.m4 -/srcm4/open-cloexec.m4 -/srcm4/open-slash.m4 -/srcm4/pathmax.m4 -/srcm4/pid_t.m4 -/srcm4/po.m4 -/srcm4/progtest.m4 -/srcm4/raise.m4 -/srcm4/rawmemchr.m4 -/srcm4/read.m4 -/srcm4/readlink.m4 -/srcm4/realloc.m4 -/srcm4/relocatable-lib.m4 -/srcm4/relocatable.m4 -/srcm4/safe-read.m4 -/srcm4/setenv.m4 -/srcm4/signal_h.m4 -/srcm4/signalblocking.m4 -/srcm4/sigpipe.m4 -/srcm4/ssize_t.m4 -/srcm4/stat-time.m4 -/srcm4/stat.m4 -/srcm4/std-gnu11.m4 -/srcm4/stdalign.m4 -/srcm4/stddef_h.m4 -/srcm4/stdint.m4 -/srcm4/stdio_h.m4 -/srcm4/stdlib_h.m4 -/srcm4/strerror.m4 -/srcm4/string_h.m4 -/srcm4/sys_socket_h.m4 -/srcm4/sys_stat_h.m4 -/srcm4/sys_types_h.m4 -/srcm4/time_h.m4 -/srcm4/unistd_h.m4 -/srcm4/unlocked-io.m4 -/srcm4/vararrays.m4 -/srcm4/visibility.m4 -/srcm4/warn-on-use.m4 -/srcm4/wchar_h.m4 -/srcm4/wchar_t.m4 -/srcm4/wint_t.m4 -/srcm4/zzgnulib.m4 -/tests/qemu.h -# Cached parameters of gnulib-tool: -/srcm4/gnulib-cache.m4 - -# Files brought in by "automake --add-missing --copy": -/build-aux/ar-lib -/build-aux/compile -/build-aux/install-sh -/build-aux/missing -/libcharset/build-aux/install-sh -/libcharset/build-aux/mkinstalldirs - -# Other files brought in by autogen.sh: -/build-aux/config.guess -/build-aux/config.sub -/libcharset/build-aux/config.guess -/libcharset/build-aux/config.sub - -# ---------- "make -f Makefile.devel totally-clean" gets you here ---------- - -# Files generated by the autotools: -# Built by Makefile.devel. -/aclocal.m4 -/configure -/config.h.in -/srclib/Makefile.in -# Built by libcharset/Makefile.devel. -/libcharset/autoconf/aclocal.m4 -/libcharset/configure -/libcharset/config.h.in - -# Files generated by "make -f Makefile.devel" and even kept by "make maintainer-clean": -# Built by Makefile.devel. -/srclib/Makefile.gnulib -/srclib/Makefile.in -/include/iconv.h.build.in -/lib/aliases.gperf -/lib/aliases_sysaix.gperf -/lib/aliases_syshpux.gperf -/lib/aliases_sysosf1.gperf -/lib/aliases_syssolaris.gperf -/lib/aliases.h -/lib/aliases_sysaix.h -/lib/aliases_syshpux.h -/lib/aliases_sysosf1.h -/lib/aliases_syssolaris.h -/lib/aliases_aix.h -/lib/aliases_aix_sysaix.h -/lib/aliases_osf1.h -/lib/aliases_osf1_sysosf1.h -/lib/aliases_dos.h -/lib/aliases_zos.h -/lib/aliases_extra.h -/lib/canonical.h -/lib/canonical_sysaix.h -/lib/canonical_syshpux.h -/lib/canonical_sysosf1.h -/lib/canonical_syssolaris.h -/lib/canonical_aix.h -/lib/canonical_aix_sysaix.h -/lib/canonical_osf1.h -/lib/canonical_osf1_sysosf1.h -/lib/canonical_dos.h -/lib/canonical_zos.h -/lib/canonical_extra.h -/lib/canonical_local.h -/lib/canonical_local_sysaix.h -/lib/canonical_local_syshpux.h -/lib/canonical_local_sysosf1.h -/lib/canonical_local_syssolaris.h -/lib/flags.h -/lib/translit.h -/man/iconv.1.html -/man/iconv.3.html -/man/iconv_close.3.html -/man/iconv_open.3.html -/man/iconvctl.3.html -/man/iconv_open_into.3.html -# Built by libcharset/Makefile.devel. -/libcharset/include/libcharset.h.build.in -/libcharset/include/localcharset.h.build.in - -# ---------- "make maintainerclean" gets you here ---------- - -# Files generated by "make" and distributed -# (i.e. kept by "make distclean") -# (see MAINTAINERCLEANFILES in Makefile.am and, if present, Makefile.gnulib): -# Files generated by "make", using msgfmt. -/po/??.gmo -/po/pt_??.gmo -/po/zh_??.gmo -/po/??@*.gmo -po/stamp-po - -# ---------- "make distclean" ought to get you here ---------- - -# Directories generated by "make" and mistakenly distributed -# (i.e. mistakenly kept by "make distclean"): -autom4te.cache/ - -# ---------- "make distclean" gets you here ---------- - -# Files generated by "configure" and not distributed -# (i.e. erased by "make distclean"): -# Erased by Makefile. -/config.status -/config.log -/config.cache -/Makefile -/libtool -/config.h -/stamp-h1 -/lib/stamp-h2 -/include/iconv.h -/include/iconv.h.inst -# Erased by libcharset/Makefile. -/libcharset/config.status -/libcharset/config.log -/libcharset/config.cache -/libcharset/Makefile -/libcharset/config.h -/libcharset/libtool -/libcharset/include/libcharset.h -/libcharset/include/libcharset.h.inst -/libcharset/include/localcharset.h -/libcharset/include/localcharset.h.inst -# Erased by libcharset/lib/Makefile. -/libcharset/lib/Makefile -# Erased by lib/Makefile. -/lib/Makefile -/lib/config.h -# Erased by srclib/Makefile. -/srclib/Makefile -# Erased by src/Makefile. -/src/Makefile -# Erased by po/Makefile. -/po/Makefile.in -/po/Makefile -/po/POTFILES -# Erased by man/Makefile. -/man/Makefile -# Erased by tests/Makefile. -/tests/Makefile - -# Files generated by "make" and not distributed -# (i.e. erased by "make distclean"). -.dirstamp -# Erased by libcharset/Makefile. -/libcharset/include/libcharset.h - -# ---------- "make clean" gets you here ---------- - -# Files generated by "make" and erased by "make clean" -# (see CLEANFILES in Makefile.am and, if present, Makefile.gnulib): -/srclib/libicrt.a - -# ---------- "make mostlyclean" gets you here ---------- - -# Directories generated by "make all check" and erased by "make mostlyclean": -/libcharset/lib/.libs/ -/libcharset/lib/_libs/ -/lib/.libs/ -/lib/_libs/ -/src/.libs/ -/src/_libs/ -/tests/.libs/ -/tests/_libs/ - -# Files generated by "make all check" and erased by "make mostlyclean" -# (see MOSTLYCLEANFILES in Makefile.am and, if present, Makefile.gnulib): -# Erased by Makefile. -/lib/libcharset.h -/lib/libcharset.so* -/lib/localcharset.h -# Erased by libcharset/Makefile. -# Erased by libcharset/lib/Makefile. -/libcharset/lib/*.o -/libcharset/lib/*.lo -/libcharset/lib/*.a -/libcharset/lib/*.la -/libcharset/lib/*.o.lock -/libcharset/lib/core -/libcharset/lib/*.stackdump -# Erased by lib/Makefile. -/lib/*.o -/lib/*.lo -/lib/*.a -/lib/*.la -/lib/core -/lib/*.stackdump -/lib/so_locations -# Erased by srclib/Makefile. -/srclib/**/*.o -/srclib/core -/srclib/*.stackdump -/srclib/alloca.h -/srclib/alloca.h-t -/srclib/arg-nonnull.h -/srclib/arg-nonnull.h-t -/srclib/assert.h -/srclib/assert.h-t -/srclib/c++defs.h -/srclib/c++defs.h-t -/srclib/errno.h -/srclib/errno.h-t -/srclib/error.h -/srclib/error.h-t -/srclib/fcntl.h -/srclib/fcntl.h-t -/srclib/inttypes.h -/srclib/inttypes.h-t -/srclib/limits.h -/srclib/limits.h-t -/srclib/malloc/scratch_buffer.gl.h -/srclib/malloc/scratch_buffer.gl.h-t -/srclib/signal.h -/srclib/signal.h-t -/srclib/stdbool.h -/srclib/stdbool.h-t -/srclib/stdckdint.h -/srclib/stdckdint.h-t -/srclib/stddef.h -/srclib/stddef.h-t -/srclib/stdint.h -/srclib/stdint.h-t -/srclib/stdio.h -/srclib/stdio.h-t -/srclib/stdlib.h -/srclib/stdlib.h-t -/srclib/string.h -/srclib/string.h-t -/srclib/sys/stat.h -/srclib/sys/stat.h-t -/srclib/sys/time.h -/srclib/sys/time.h-t -/srclib/sys/types.h -/srclib/sys/types.h-t -/srclib/time.h -/srclib/time.h-t -/srclib/unistd.h -/srclib/unistd.h-t -/srclib/unitypes.h -/srclib/unitypes.h-t -/srclib/uniwidth.h -/srclib/uniwidth.h-t -/srclib/warn-on-use.h -/srclib/warn-on-use.h-t -/srclib/wchar.h -/srclib/wchar.h-t -# Erased by src/Makefile. -/src/*.o -/src/*.lo -/src/iconv.res -/src/iconv_no_i18n -/src/iconv_no_i18n.exe -/src/iconv -/src/iconv.exe -/src/core -/src/*.stackdump -# Erased by po/Makefile. -/po/*.mo -/po/remove-potcdate.sed -/po/stamp-poT -/po/core -/po/core.* -/po/libiconv.po -/po/libiconv.1po -/po/libiconv.2po -/po/*.new.po -/po/*.o -# Erased by man/Makefile. -# Erased by tests/Makefile. -/tests/*.o -/tests/*.lo -/tests/is-native -/tests/is-native.exe -/tests/table-from -/tests/table-from.exe -/tests/table-to -/tests/table-to.exe -/tests/test-shiftseq -/tests/test-shiftseq.exe -/tests/test-to-wchar -/tests/test-to-wchar.exe -/tests/tmp-* -/tests/genutf8 -/tests/genutf8.exe -/tests/UTF-8.TXT -/tests/gengb18030z -/tests/gengb18030z.exe -/tests/GB18030.TXT -/tests/core -/tests/*.stackdump - -# Files generated by "make dist" and erased by "make mostlyclean" -# (see MOSTLYCLEANFILES in Makefile.am): - -# ---------- "make all check" gets you here ---------- +# CMake build files +build/ +CMakeFiles +*.so +*.so.*.*.* +*.a +*.dylib +*.stackdump +*.lib +*.pdb +*.dll +*.exe +cmake_install.cmake +CMakeCache.txt +CTestTestfile.cmake +DartConfiguration.tcl +Makefile +uninstall.cmake +reiconv.hpp +CTestCostData.txt +*.inst +Testing +*.log +*.dSYM + +# Test suite runable +tests/cmp +tests/cmp.exe +tests/gengb18030z +tests/gengb18030z.exe +tests/genutf8 +tests/genutf8.exe +tests/reiconv-test +tests/reiconv-test.exe +tests/table-from +tests/table-from.exe +tests/table-to +tests/table-to.exe +tests/test-shiftseq +tests/test-shiftseq.exe +tests/uniq-u +tests/uniq-u.exe +tests/tmp-*.TXT # Patterns for all subdirectories: all kinds of automatic backup files. *.orig *.rej *~ *.kate-swp +*.swp .#* \#*# +.vscode + +# Autopull modules +build-aux/ + +# Temp tests files. +tests/data/UTF-8.TXT +tests/data/GB18030-2005.TXT +tests/data/GB18030-2022.TXT +# Dist directory and temps +cppp-reiconv-v* +__pycache__ diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index 11d805c6..00000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[subcheckout "gnulib"] - url = git://git.savannah.gnu.org/gnulib.git - path = gnulib diff --git a/ABOUT-NLS b/ABOUT-NLS deleted file mode 100644 index 0a9d56d9..00000000 --- a/ABOUT-NLS +++ /dev/null @@ -1 +0,0 @@ - diff --git a/AUTHORS b/AUTHORS deleted file mode 100644 index 8bedd794..00000000 --- a/AUTHORS +++ /dev/null @@ -1 +0,0 @@ -Bruno Haible diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 00000000..7d72a3c9 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,86 @@ +# Copyright (C) 2023 The C++ Plus Project. +# This file is part of the cppp-reiconv library. +# +# The cppp-reiconv library is free software; you can redistribute it +# and/or modify it under the terms of the GNU Lesser General Public +# License as published by the Free Software Foundation; either version 2.1 +# of the License, or (at your option) any later version. +# +# The cppp-reiconv library is distributed in the hope that it will be +# useful, but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with the cppp-reiconv library; see the file COPYING. +# If not, see . + +cmake_minimum_required(VERSION 3.12) +project(cppp-reiconv VERSION 2.0.0) + +# Define options +option(ENABLE_EXTRA "Enable extra encodings and features." OFF) + +# Set C++ standard +set(CMAKE_CXX_STANDARD 11) + +include("${CMAKE_SOURCE_DIR}/build-aux/cmake/cppp.cmake") + +check_have_visibility() + +# Generate header file for build +if(WIN32) + set(DLL_VARIABLE "__declspec(dllexport)") +elseif(HAVE_VISIBILITY) + set(DLL_VARIABLE "__attribute__((__visibility__(\"default\")))") +else() + set(DLL_VARIABLE "") +endif() +configure_file("${srcdir}/include/cppp/reiconv.hpp.in" "${output_includedir}/cppp/reiconv.hpp") + +# Generate header file for install +if(WIN32) + set(DLL_VARIABLE "__declspec(dllimport)") +else() + set(DLL_VARIABLE "") +endif() +configure_file("${srcdir}/include/cppp/reiconv.hpp.in" "${output_includedir}/cppp/reiconv.hpp.inst") + +# Add includes +include_directories("${srcdir}/lib") +include_directories("${srcdir}/lib/generated") +include_directories("${output_includedir}") + +# Add definitions +if(ENABLE_EXTRA) + message(STATUS "Extra encodings and features enabled.") + add_compile_definitions(ENABLE_EXTRA=1) +endif() + +# Add library +cppp_build_library(${PROJECT_NAME} "${srcdir}/lib/iconv.cpp" TRUE TRUE "${srcdir}/windows/libcppp-reiconv.rc") + +# Include test suite. +include("tests/tests.cmake") + +# Install +# Static +# PERMISSIONS 0644 +install(TARGETS libcppp-reiconv.static + DESTINATION "${install_staticdir}" + PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ WORLD_READ ) + +# Shared +# PERMISSIONS 0755 +install(TARGETS libcppp-reiconv.shared + EXPORT libcppp-reiconv-export + DESTINATION "${install_shareddir}" + PERMISSIONS OWNER_READ OWNER_WRITE OWNER_EXECUTE GROUP_READ GROUP_EXECUTE WORLD_READ WORLD_EXECUTE ) + +# Includes +# install includes +# PERMISSIONS 0644 +install(FILES "${output_includedir}/cppp/reiconv.hpp.inst" + DESTINATION "${install_includedir}" + RENAME "cppp/reiconv.hpp" + PERMISSIONS OWNER_READ OWNER_WRITE GROUP_READ WORLD_READ ) diff --git a/COPYING b/COPYING index 94a9ed02..0a041280 100644 --- a/COPYING +++ b/COPYING @@ -1,674 +1,165 @@ - GNU GENERAL PUBLIC LICENSE + GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 - Copyright (C) 2007 Free Software Foundation, Inc. + Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program. If not, see . - -Also add information on how to contact you by electronic and paper mail. - - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: - - Copyright (C) - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". - - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. - - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + You may place library facilities that are a work based on the +Library side by side in a single library together with other library +facilities that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU Lesser General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Library as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. diff --git a/COPYING.LIB b/COPYING.LIB deleted file mode 100644 index 4362b491..00000000 --- a/COPYING.LIB +++ /dev/null @@ -1,502 +0,0 @@ - GNU LESSER GENERAL PUBLIC LICENSE - Version 2.1, February 1999 - - Copyright (C) 1991, 1999 Free Software Foundation, Inc. - 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - -[This is the first released version of the Lesser GPL. It also counts - as the successor of the GNU Library Public License, version 2, hence - the version number 2.1.] - - Preamble - - The licenses for most software are designed to take away your -freedom to share and change it. By contrast, the GNU General Public -Licenses are intended to guarantee your freedom to share and change -free software--to make sure the software is free for all its users. - - This license, the Lesser General Public License, applies to some -specially designated software packages--typically libraries--of the -Free Software Foundation and other authors who decide to use it. You -can use it too, but we suggest you first think carefully about whether -this license or the ordinary General Public License is the better -strategy to use in any particular case, based on the explanations below. - - When we speak of free software, we are referring to freedom of use, -not price. Our General Public Licenses are designed to make sure that -you have the freedom to distribute copies of free software (and charge -for this service if you wish); that you receive source code or can get -it if you want it; that you can change the software and use pieces of -it in new free programs; and that you are informed that you can do -these things. - - To protect your rights, we need to make restrictions that forbid -distributors to deny you these rights or to ask you to surrender these -rights. These restrictions translate to certain responsibilities for -you if you distribute copies of the library or if you modify it. - - For example, if you distribute copies of the library, whether gratis -or for a fee, you must give the recipients all the rights that we gave -you. You must make sure that they, too, receive or can get the source -code. If you link other code with the library, you must provide -complete object files to the recipients, so that they can relink them -with the library after making changes to the library and recompiling -it. And you must show them these terms so they know their rights. - - We protect your rights with a two-step method: (1) we copyright the -library, and (2) we offer you this license, which gives you legal -permission to copy, distribute and/or modify the library. - - To protect each distributor, we want to make it very clear that -there is no warranty for the free library. Also, if the library is -modified by someone else and passed on, the recipients should know -that what they have is not the original version, so that the original -author's reputation will not be affected by problems that might be -introduced by others. - - Finally, software patents pose a constant threat to the existence of -any free program. We wish to make sure that a company cannot -effectively restrict the users of a free program by obtaining a -restrictive license from a patent holder. Therefore, we insist that -any patent license obtained for a version of the library must be -consistent with the full freedom of use specified in this license. - - Most GNU software, including some libraries, is covered by the -ordinary GNU General Public License. This license, the GNU Lesser -General Public License, applies to certain designated libraries, and -is quite different from the ordinary General Public License. We use -this license for certain libraries in order to permit linking those -libraries into non-free programs. - - When a program is linked with a library, whether statically or using -a shared library, the combination of the two is legally speaking a -combined work, a derivative of the original library. The ordinary -General Public License therefore permits such linking only if the -entire combination fits its criteria of freedom. The Lesser General -Public License permits more lax criteria for linking other code with -the library. - - We call this license the "Lesser" General Public License because it -does Less to protect the user's freedom than the ordinary General -Public License. It also provides other free software developers Less -of an advantage over competing non-free programs. These disadvantages -are the reason we use the ordinary General Public License for many -libraries. However, the Lesser license provides advantages in certain -special circumstances. - - For example, on rare occasions, there may be a special need to -encourage the widest possible use of a certain library, so that it becomes -a de-facto standard. To achieve this, non-free programs must be -allowed to use the library. A more frequent case is that a free -library does the same job as widely used non-free libraries. In this -case, there is little to gain by limiting the free library to free -software only, so we use the Lesser General Public License. - - In other cases, permission to use a particular library in non-free -programs enables a greater number of people to use a large body of -free software. For example, permission to use the GNU C Library in -non-free programs enables many more people to use the whole GNU -operating system, as well as its variant, the GNU/Linux operating -system. - - Although the Lesser General Public License is Less protective of the -users' freedom, it does ensure that the user of a program that is -linked with the Library has the freedom and the wherewithal to run -that program using a modified version of the Library. - - The precise terms and conditions for copying, distribution and -modification follow. Pay close attention to the difference between a -"work based on the library" and a "work that uses the library". The -former contains code derived from the library, whereas the latter must -be combined with the library in order to run. - - GNU LESSER GENERAL PUBLIC LICENSE - TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION - - 0. This License Agreement applies to any software library or other -program which contains a notice placed by the copyright holder or -other authorized party saying it may be distributed under the terms of -this Lesser General Public License (also called "this License"). -Each licensee is addressed as "you". - - A "library" means a collection of software functions and/or data -prepared so as to be conveniently linked with application programs -(which use some of those functions and data) to form executables. - - The "Library", below, refers to any such software library or work -which has been distributed under these terms. A "work based on the -Library" means either the Library or any derivative work under -copyright law: that is to say, a work containing the Library or a -portion of it, either verbatim or with modifications and/or translated -straightforwardly into another language. (Hereinafter, translation is -included without limitation in the term "modification".) - - "Source code" for a work means the preferred form of the work for -making modifications to it. For a library, complete source code means -all the source code for all modules it contains, plus any associated -interface definition files, plus the scripts used to control compilation -and installation of the library. - - Activities other than copying, distribution and modification are not -covered by this License; they are outside its scope. The act of -running a program using the Library is not restricted, and output from -such a program is covered only if its contents constitute a work based -on the Library (independent of the use of the Library in a tool for -writing it). Whether that is true depends on what the Library does -and what the program that uses the Library does. - - 1. You may copy and distribute verbatim copies of the Library's -complete source code as you receive it, in any medium, provided that -you conspicuously and appropriately publish on each copy an -appropriate copyright notice and disclaimer of warranty; keep intact -all the notices that refer to this License and to the absence of any -warranty; and distribute a copy of this License along with the -Library. - - You may charge a fee for the physical act of transferring a copy, -and you may at your option offer warranty protection in exchange for a -fee. - - 2. You may modify your copy or copies of the Library or any portion -of it, thus forming a work based on the Library, and copy and -distribute such modifications or work under the terms of Section 1 -above, provided that you also meet all of these conditions: - - a) The modified work must itself be a software library. - - b) You must cause the files modified to carry prominent notices - stating that you changed the files and the date of any change. - - c) You must cause the whole of the work to be licensed at no - charge to all third parties under the terms of this License. - - d) If a facility in the modified Library refers to a function or a - table of data to be supplied by an application program that uses - the facility, other than as an argument passed when the facility - is invoked, then you must make a good faith effort to ensure that, - in the event an application does not supply such function or - table, the facility still operates, and performs whatever part of - its purpose remains meaningful. - - (For example, a function in a library to compute square roots has - a purpose that is entirely well-defined independent of the - application. Therefore, Subsection 2d requires that any - application-supplied function or table used by this function must - be optional: if the application does not supply it, the square - root function must still compute square roots.) - -These requirements apply to the modified work as a whole. If -identifiable sections of that work are not derived from the Library, -and can be reasonably considered independent and separate works in -themselves, then this License, and its terms, do not apply to those -sections when you distribute them as separate works. But when you -distribute the same sections as part of a whole which is a work based -on the Library, the distribution of the whole must be on the terms of -this License, whose permissions for other licensees extend to the -entire whole, and thus to each and every part regardless of who wrote -it. - -Thus, it is not the intent of this section to claim rights or contest -your rights to work written entirely by you; rather, the intent is to -exercise the right to control the distribution of derivative or -collective works based on the Library. - -In addition, mere aggregation of another work not based on the Library -with the Library (or with a work based on the Library) on a volume of -a storage or distribution medium does not bring the other work under -the scope of this License. - - 3. You may opt to apply the terms of the ordinary GNU General Public -License instead of this License to a given copy of the Library. To do -this, you must alter all the notices that refer to this License, so -that they refer to the ordinary GNU General Public License, version 2, -instead of to this License. (If a newer version than version 2 of the -ordinary GNU General Public License has appeared, then you can specify -that version instead if you wish.) Do not make any other change in -these notices. - - Once this change is made in a given copy, it is irreversible for -that copy, so the ordinary GNU General Public License applies to all -subsequent copies and derivative works made from that copy. - - This option is useful when you wish to copy part of the code of -the Library into a program that is not a library. - - 4. You may copy and distribute the Library (or a portion or -derivative of it, under Section 2) in object code or executable form -under the terms of Sections 1 and 2 above provided that you accompany -it with the complete corresponding machine-readable source code, which -must be distributed under the terms of Sections 1 and 2 above on a -medium customarily used for software interchange. - - If distribution of object code is made by offering access to copy -from a designated place, then offering equivalent access to copy the -source code from the same place satisfies the requirement to -distribute the source code, even though third parties are not -compelled to copy the source along with the object code. - - 5. A program that contains no derivative of any portion of the -Library, but is designed to work with the Library by being compiled or -linked with it, is called a "work that uses the Library". Such a -work, in isolation, is not a derivative work of the Library, and -therefore falls outside the scope of this License. - - However, linking a "work that uses the Library" with the Library -creates an executable that is a derivative of the Library (because it -contains portions of the Library), rather than a "work that uses the -library". The executable is therefore covered by this License. -Section 6 states terms for distribution of such executables. - - When a "work that uses the Library" uses material from a header file -that is part of the Library, the object code for the work may be a -derivative work of the Library even though the source code is not. -Whether this is true is especially significant if the work can be -linked without the Library, or if the work is itself a library. The -threshold for this to be true is not precisely defined by law. - - If such an object file uses only numerical parameters, data -structure layouts and accessors, and small macros and small inline -functions (ten lines or less in length), then the use of the object -file is unrestricted, regardless of whether it is legally a derivative -work. (Executables containing this object code plus portions of the -Library will still fall under Section 6.) - - Otherwise, if the work is a derivative of the Library, you may -distribute the object code for the work under the terms of Section 6. -Any executables containing that work also fall under Section 6, -whether or not they are linked directly with the Library itself. - - 6. As an exception to the Sections above, you may also combine or -link a "work that uses the Library" with the Library to produce a -work containing portions of the Library, and distribute that work -under terms of your choice, provided that the terms permit -modification of the work for the customer's own use and reverse -engineering for debugging such modifications. - - You must give prominent notice with each copy of the work that the -Library is used in it and that the Library and its use are covered by -this License. You must supply a copy of this License. If the work -during execution displays copyright notices, you must include the -copyright notice for the Library among them, as well as a reference -directing the user to the copy of this License. Also, you must do one -of these things: - - a) Accompany the work with the complete corresponding - machine-readable source code for the Library including whatever - changes were used in the work (which must be distributed under - Sections 1 and 2 above); and, if the work is an executable linked - with the Library, with the complete machine-readable "work that - uses the Library", as object code and/or source code, so that the - user can modify the Library and then relink to produce a modified - executable containing the modified Library. (It is understood - that the user who changes the contents of definitions files in the - Library will not necessarily be able to recompile the application - to use the modified definitions.) - - b) Use a suitable shared library mechanism for linking with the - Library. A suitable mechanism is one that (1) uses at run time a - copy of the library already present on the user's computer system, - rather than copying library functions into the executable, and (2) - will operate properly with a modified version of the library, if - the user installs one, as long as the modified version is - interface-compatible with the version that the work was made with. - - c) Accompany the work with a written offer, valid for at - least three years, to give the same user the materials - specified in Subsection 6a, above, for a charge no more - than the cost of performing this distribution. - - d) If distribution of the work is made by offering access to copy - from a designated place, offer equivalent access to copy the above - specified materials from the same place. - - e) Verify that the user has already received a copy of these - materials or that you have already sent this user a copy. - - For an executable, the required form of the "work that uses the -Library" must include any data and utility programs needed for -reproducing the executable from it. However, as a special exception, -the materials to be distributed need not include anything that is -normally distributed (in either source or binary form) with the major -components (compiler, kernel, and so on) of the operating system on -which the executable runs, unless that component itself accompanies -the executable. - - It may happen that this requirement contradicts the license -restrictions of other proprietary libraries that do not normally -accompany the operating system. Such a contradiction means you cannot -use both them and the Library together in an executable that you -distribute. - - 7. You may place library facilities that are a work based on the -Library side-by-side in a single library together with other library -facilities not covered by this License, and distribute such a combined -library, provided that the separate distribution of the work based on -the Library and of the other library facilities is otherwise -permitted, and provided that you do these two things: - - a) Accompany the combined library with a copy of the same work - based on the Library, uncombined with any other library - facilities. This must be distributed under the terms of the - Sections above. - - b) Give prominent notice with the combined library of the fact - that part of it is a work based on the Library, and explaining - where to find the accompanying uncombined form of the same work. - - 8. You may not copy, modify, sublicense, link with, or distribute -the Library except as expressly provided under this License. Any -attempt otherwise to copy, modify, sublicense, link with, or -distribute the Library is void, and will automatically terminate your -rights under this License. However, parties who have received copies, -or rights, from you under this License will not have their licenses -terminated so long as such parties remain in full compliance. - - 9. You are not required to accept this License, since you have not -signed it. However, nothing else grants you permission to modify or -distribute the Library or its derivative works. These actions are -prohibited by law if you do not accept this License. Therefore, by -modifying or distributing the Library (or any work based on the -Library), you indicate your acceptance of this License to do so, and -all its terms and conditions for copying, distributing or modifying -the Library or works based on it. - - 10. Each time you redistribute the Library (or any work based on the -Library), the recipient automatically receives a license from the -original licensor to copy, distribute, link with or modify the Library -subject to these terms and conditions. You may not impose any further -restrictions on the recipients' exercise of the rights granted herein. -You are not responsible for enforcing compliance by third parties with -this License. - - 11. If, as a consequence of a court judgment or allegation of patent -infringement or for any other reason (not limited to patent issues), -conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot -distribute so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you -may not distribute the Library at all. For example, if a patent -license would not permit royalty-free redistribution of the Library by -all those who receive copies directly or indirectly through you, then -the only way you could satisfy both it and this License would be to -refrain entirely from distribution of the Library. - -If any portion of this section is held invalid or unenforceable under any -particular circumstance, the balance of the section is intended to apply, -and the section as a whole is intended to apply in other circumstances. - -It is not the purpose of this section to induce you to infringe any -patents or other property right claims or to contest validity of any -such claims; this section has the sole purpose of protecting the -integrity of the free software distribution system which is -implemented by public license practices. Many people have made -generous contributions to the wide range of software distributed -through that system in reliance on consistent application of that -system; it is up to the author/donor to decide if he or she is willing -to distribute software through any other system and a licensee cannot -impose that choice. - -This section is intended to make thoroughly clear what is believed to -be a consequence of the rest of this License. - - 12. If the distribution and/or use of the Library is restricted in -certain countries either by patents or by copyrighted interfaces, the -original copyright holder who places the Library under this License may add -an explicit geographical distribution limitation excluding those countries, -so that distribution is permitted only in or among countries not thus -excluded. In such case, this License incorporates the limitation as if -written in the body of this License. - - 13. The Free Software Foundation may publish revised and/or new -versions of the Lesser General Public License from time to time. -Such new versions will be similar in spirit to the present version, -but may differ in detail to address new problems or concerns. - -Each version is given a distinguishing version number. If the Library -specifies a version number of this License which applies to it and -"any later version", you have the option of following the terms and -conditions either of that version or of any later version published by -the Free Software Foundation. If the Library does not specify a -license version number, you may choose any version ever published by -the Free Software Foundation. - - 14. If you wish to incorporate parts of the Library into other free -programs whose distribution conditions are incompatible with these, -write to the author to ask for permission. For software which is -copyrighted by the Free Software Foundation, write to the Free -Software Foundation; we sometimes make exceptions for this. Our -decision will be guided by the two goals of preserving the free status -of all derivatives of our free software and of promoting the sharing -and reuse of software generally. - - NO WARRANTY - - 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO -WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. -EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR -OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY -KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE -LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME -THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN -WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY -AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU -FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR -CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE -LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING -RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A -FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF -SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH -DAMAGES. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Libraries - - If you develop a new library, and you want it to be of the greatest -possible use to the public, we recommend making it free software that -everyone can redistribute and change. You can do so by permitting -redistribution under these terms (or, alternatively, under the terms of the -ordinary General Public License). - - To apply these terms, attach the following notices to the library. It is -safest to attach them to the start of each source file to most effectively -convey the exclusion of warranty; and each file should have at least the -"copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA - -Also add information on how to contact you by electronic and paper mail. - -You should also get your employer (if you work as a programmer) or your -school, if any, to sign a "copyright disclaimer" for the library, if -necessary. Here is a sample; alter the names: - - Yoyodyne, Inc., hereby disclaims all copyright interest in the - library `Frob' (a library for tweaking knobs) written by James Random Hacker. - - , 1 April 1990 - Ty Coon, President of Vice - -That's all there is to it! diff --git a/CPPPPKG b/CPPPPKG new file mode 100644 index 00000000..9391fda6 --- /dev/null +++ b/CPPPPKG @@ -0,0 +1,23 @@ +{ + "name" : "cppp-reiconv", + "version" : "2.0.0", + "list_file_path": "FILELIST", + "description": "C++ Plus character set conversion library", + "authors": [ + "The C++ Plus Project", + "Bruno Haible", + "ChenPi11", + "Sam Steingold", + "Ben Noordhuis", + "Mike Fulton", + "Daiki Ueno", + "KO Myung-Hun" + ], + "webpage": "https://github.com/cppp-project/cppp-reiconv", + "subpackages": { + "build-aux": "build-aux" + }, + "license": [ + "LGPLv3" + ] +} diff --git a/ChangeLog b/ChangeLog index 59c0b914..66cdc677 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,33 @@ +2023-07-07 ChenPi11 + + Perfect the documents. + +2023-07-03 ChenPi11 + + Add 'GB18030' tests. + Add C++ Plus dist utils and change version info. + Remove function 'iconv_open_into'. + +2023-07-02 ChenPi11 + + Add C++ Plus dist utils. + +2023-07-01 ChenPi11 + + Remove src, srclib, gnulib, po, man, tools. + Remove unused things. + Change 'COPYING.LIB' to 'COPYING'. + Redist 'GNU LIBICONV' to 'cppp-reiconv'. + Remove 'CHAR' and 'WCHAR_T' encoding. + Remove libcharset. + Preparing to transition to C++. + Remove autoconf buildsystem support. + Add CMake support. + Move generated file into 'lib/generated'. + Move cppp-reiconv to a C++ library. + Remove translit support. + Remove 'LIBICONV_PLUG'. + 2023-06-29 Bruno Haible Update the installation instructions for Windows. diff --git a/DEPENDENCIES b/DEPENDENCIES deleted file mode 100644 index 748fb83e..00000000 --- a/DEPENDENCIES +++ /dev/null @@ -1,76 +0,0 @@ -The following packages should be installed before GNU libiconv is installed -(runtime dependencies that are also build dependencies): - -None. - - -The following packages should be installed when GNU libiconv is installed -(runtime dependencies, but not build dependencies): - -None. - - -The following should be installed when GNU libiconv is built, but are not -needed later, once it is installed (build dependencies, but not runtime -dependencies): - -* A C runtime, compiler, linker, etc. - + Mandatory. - Either the platform's native 'cc', or GCC 3.1 or newer. - + GCC Homepage: - https://gcc.gnu.org/ - + Download: - https://ftp.gnu.org/gnu/gcc/ - -* A 'make' utility. - + Mandatory. - Either the platform's native 'make' (for in-tree builds only), - or GNU Make 3.79.1 or newer. - + GNU Make Homepage: - https://www.gnu.org/software/make/ - + Download: - https://ftp.gnu.org/gnu/make/ - -* A shell - + Mandatory. - Either the platform's native 'sh', or Bash. - + Homepage: - https://www.gnu.org/software/bash/ - + Download: - https://ftp.gnu.org/gnu/bash/ - -* Core POSIX utilities, including: - [ basename cat chgrp chmod chown cp dd echo expand expr - false hostname install kill ln ls md5sum mkdir mkfifo - mknod mv printenv pwd rm rmdir sleep sort tee test touch - true uname - + Mandatory. - Either the platform's native utilities, or GNU coreutils. - + Homepage: - https://www.gnu.org/software/coreutils/ - + Download: - https://ftp.gnu.org/gnu/coreutils/ - -* The comparison utilities 'cmp' and 'diff'. - + Mandatory. - Either the platform's native utilities, or GNU diffutils. - + Homepage: - https://www.gnu.org/software/diffutils/ - + Download: - https://ftp.gnu.org/gnu/diffutils/ - -* Grep. - + Mandatory. - Either the platform's native grep, or GNU grep. - + Homepage: - https://www.gnu.org/software/grep/ - + Download: - https://ftp.gnu.org/gnu/grep/ - -* Awk. - + Mandatory. - Either the platform's native awk, mawk, or nawk, or GNU awk. - + Homepage: - https://www.gnu.org/software/gawk/ - + Download: - https://ftp.gnu.org/gnu/gawk/ diff --git a/DESIGN b/DESIGN deleted file mode 100644 index 9ff2ad3a..00000000 --- a/DESIGN +++ /dev/null @@ -1,64 +0,0 @@ -While some other iconv(3) implementations - like FreeBSD iconv(3) - choose -the "many small shared libraries" and dlopen(3) approach, this implementation -packs everything into a single shared library. Here is a comparison of the -two designs. - -* Run-time efficiency - 1. A dlopen() based approach needs a cache of loaded shared libraries. - Otherwise, every iconv_open() call will result in a call to dlopen() - and thus to file system related system calls - which is prohibitive - because some applications use the iconv_open/iconv/iconv_close sequence - for every single filename, string, or piece of text. - 2. In terms of virtual memory use, both approaches are on par. Being shared - libraries, the tables are shared between any processes that use them. - And because of the demand loading used by Unix systems (and because libiconv - does not have initialization functions), only those parts of the tables - which are needed (typically very few kilobytes) will be read from disk and - paged into main memory. - 3. Even with a cache of loaded shared libraries, the dlopen() based approach - makes more system calls, because it has to load one or two shared libraries - for every encoding in use. - -* Total size - In the dlopen(3) approach, every shared library has a symbol table and - relocation offset. All together, FreeBSD iconv installs more than 200 shared - libraries with a total size of 2.3 MB. Whereas libiconv installs 0.45 MB. - -* Extensibility - The dlopen(3) approach is good for guaranteeing extensibility if the iconv - implementation is distributed without source. (Or when, as in glibc, you - cannot rebuild iconv without rebuilding your libc, thus possibly - destabilizing your system.) - The libiconv package achieves extensibility through the LGPL license: - Every user has access to the source of the package and can extend and - replace just libiconv.so. - The places which have to be modified when a new encoding is added are as - follows: add an #include statement in iconv.c, add an entry in the table in - iconv.c, and of course, update the README and iconv_open.3 manual page. - -* Use within other packages - If you want to incorporate an iconv implementation into another package - (such as a mail user agent or web browser), the single library approach - is easier, because: - 1. In the shared library approach you have to provide the right directory - prefix which will be used at run time. - 2. Incorporating iconv as a static library into the executable is easy - - it won't need dynamic loading. (This assumes that your package is under - the LGPL or GPL license.) - - -All conversions go through Unicode. This is possible because most of the -world's characters have already been allocated in the Unicode standard. -Therefore we have for each encoding two functions: -- For conversion from the encoding to Unicode, a function called xxx_mbtowc. -- For conversion from Unicode to the encoding, a function called xxx_wctomb, - and for stateful encodings, a function called xxx_reset which returns to - the initial shift state. - - -All our functions operate on a single Unicode character at a time. This is -obviously less efficient than operating on an entire buffer of characters at -a time, but it makes the coding considerably easier and less bug-prone. Those -who wish best performance should install the Real Thing (TM): GNU libc 2.1 -or newer. - diff --git a/FILELIST b/FILELIST new file mode 100644 index 00000000..a09b6d54 --- /dev/null +++ b/FILELIST @@ -0,0 +1,555 @@ +lib/utf32.h +lib/iso8859_16.h +lib/iso8859_6.h +lib/cp1256.h +lib/ucs4le.h +lib/euc_jisx0213.h +lib/cp1163.h +lib/dec_hanyu.h +lib/cns11643_4b.h +lib/encodings_zos.def +lib/euc_cn.h +lib/cns11643_7.h +lib/gb18030uni.h +lib/cp950.h +lib/cp50221_0208_ext.h +lib/cp855.h +lib/ebcdic1154.h +lib/encodings_aix.def +lib/cns11643_3.h +lib/ebcdic280.h +lib/iso8859_14.h +lib/mac_roman.h +lib/cp850.h +lib/big5_2003.h +lib/isoir165ext.h +lib/cp950ext.h +lib/ebcdic282.h +lib/rk1048.h +lib/sjis.h +lib/georgian_academy.h +lib/iso2022_jp2.h +lib/cns11643.h +lib/cp865.h +lib/gbkext2.h +lib/iso8859_3.h +lib/mac_hebrew.h +lib/gbk.h +lib/mac_croatian.h +lib/ksc5601.h +lib/ebcdic273.h +lib/gb18030ext.h +lib/ebcdic1156.h +lib/ebcdic880.h +lib/atarist.h +lib/ebcdic838.h +lib/iso8859_2.h +lib/ebcdic1142.h +lib/cp1125.h +lib/euc_tw.h +lib/mac_thai.h +lib/koi8_r.h +lib/iso8859_11.h +lib/cp856.h +lib/ebcdic1140.h +lib/iso2022_kr.h +lib/iso2022_jp1.h +lib/utf16be.h +lib/gb18030_2022.h +lib/iso2022_jp3.h +lib/cns11643_5.h +lib/ebcdic285.h +lib/ascii.h +lib/ebcdic924.h +lib/cp922.h +lib/cns11643_inv.h +lib/ebcdic500.h +lib/iconv.cpp +lib/converters.h +lib/cp1252.h +lib/ebcdic1047.h +lib/jisx0213.h +lib/gb12345.h +lib/aliases2.h +lib/c99.h +lib/cp866.h +lib/ebcdic278.h +lib/ucs4internal.h +lib/mulelao.h +lib/ucs4swapped.h +lib/cp1162.h +lib/cns11643_4a.h +lib/flushwc.h +lib/mac_romania.h +lib/utf32le.h +lib/hz.h +lib/cp1255.h +lib/tcvn.h +lib/ebcdic1123.h +lib/ebcdic1158.h +lib/ucs2be.h +lib/genaliases2.c +lib/ebcdic425.h +lib/cp1253.h +lib/iconv_open1.h +lib/ces_big5.h +lib/cp857.h +lib/cp949.h +lib/ebcdic1137.h +lib/genflags.c +lib/iso8859_10.h +lib/gb2312.h +lib/cp936.h +lib/ebcdic1153.h +lib/mac_cyrillic.h +lib/cns11643_4.h +lib/cp932.h +lib/koi8_u.h +lib/cns11643_15.h +lib/armscii_8.h +lib/ebcdic1097.h +lib/cp775.h +lib/cp50221_0212_ext.h +lib/jisx0201.h +lib/cp737.h +lib/viscii.h +lib/ebcdic870.h +lib/big5hkscs2004.h +lib/euc_jp.h +lib/hkscs2008.h +lib/mac_centraleurope.h +lib/cp1129.h +lib/generated/canonical.h +lib/generated/canonical_syssolaris.h +lib/generated/flags.h +lib/generated/aliases_sysosf1.h +lib/generated/canonical_sysaix.h +lib/generated/aliases_osf1_sysosf1.h +lib/generated/canonical_extra.h +lib/generated/aliases_aix_sysaix.h +lib/generated/canonical_osf1.h +lib/generated/aliases.h +lib/generated/aliases.gperf +lib/generated/canonical_osf1_sysosf1.h +lib/generated/aliases_syssolaris.h +lib/generated/aliases_sysosf1.gperf +lib/generated/canonical_sysosf1.h +lib/generated/aliases_syssolaris.gperf +lib/generated/aliases_syshpux.gperf +lib/generated/aliases_extra.h +lib/generated/canonical_local_syshpux.h +lib/generated/canonical_local_sysosf1.h +lib/generated/canonical_local_sysaix.h +lib/generated/aliases_aix.h +lib/generated/canonical_dos.h +lib/generated/canonical_local.h +lib/generated/aliases_sysaix.h +lib/generated/aliases_sysaix.gperf +lib/generated/aliases_syshpux.h +lib/generated/aliases_zos.h +lib/generated/canonical_syshpux.h +lib/generated/canonical_zos.h +lib/generated/aliases_dos.h +lib/generated/canonical_aix.h +lib/generated/canonical_local_syssolaris.h +lib/generated/aliases_osf1.h +lib/generated/canonical_aix_sysaix.h +lib/ebcdic12712.h +lib/uhc_2.h +lib/iso8859_1.h +lib/cp858.h +lib/iso8859_8.h +lib/cp936ext.h +lib/cp1133.h +lib/mac_iceland.h +lib/ebcdic1149.h +lib/iso2022_cn.h +lib/ebcdic1025.h +lib/johab.h +lib/ucs4.h +lib/cns11643_2.h +lib/pt154.h +lib/ucs4be.h +lib/cp1257.h +lib/big5hkscs2008.h +lib/ebcdic905.h +lib/cns11643_6.h +lib/ebcdic1122.h +lib/isoir165.h +lib/cp864.h +lib/iso8859_15.h +lib/genaliases.c +lib/mac_turkish.h +lib/ebcdic424.h +lib/uhc_1.h +lib/cp869.h +lib/iso8859_13.h +lib/utf8.h +lib/ebcdic875.h +lib/iso8859_9.h +lib/ces_gbk.h +lib/ebcdic1155.h +lib/dec_kanji.h +lib/cp1131.h +lib/cp1124.h +lib/java.h +lib/ebcdic1130.h +lib/euc_kr.h +lib/encodings_dos.def +lib/iso8859_7.h +lib/ebcdic1146.h +lib/hkscs2004.h +lib/mac_arabic.h +lib/iso646_jp.h +lib/cp1161.h +lib/ebcdic037.h +lib/ebcdic871.h +lib/ucs2le.h +lib/iso646_cn.h +lib/shift_jisx0213.h +lib/ebcdic1132.h +lib/ebcdic1112.h +lib/cp853.h +lib/big5hkscs1999.h +lib/ebcdic1145.h +lib/cp1254.h +lib/big5.h +lib/cp1046.h +lib/mac_greek.h +lib/ebcdic4971.h +lib/gb18030_2005.h +lib/cp862.h +lib/ebcdic1160.h +lib/jisx0212.h +lib/hkscs1999.h +lib/gbkext_inv.h +lib/cp860.h +lib/hkscs2001.h +lib/koi8_ru.h +lib/utf7.h +lib/cp437.h +lib/ebcdic1141.h +lib/cp874.h +lib/ebcdic284.h +lib/ebcdic297.h +lib/ebcdic277.h +lib/jisx0208.h +lib/cp1250.h +lib/big5hkscs2001.h +lib/ebcdic423.h +lib/georgian_ps.h +lib/ebcdic1165.h +lib/koi8_t.h +lib/cns11643_1.h +lib/hp_roman8.h +lib/tis620.h +lib/iso8859_4.h +lib/loops.h +lib/utf32be.h +lib/encodings_osf1.def +lib/cp943.h +lib/ebcdic1148.h +lib/ebcdic1147.h +lib/cjk_variants.h +lib/johab_hangul.h +lib/utf16le.h +lib/encodings_extra.def +lib/gbkext1.h +lib/ucs2.h +lib/ebcdic1164.h +lib/iso2022_cnext.h +lib/iso8859_5.h +lib/utf16.h +lib/ebcdic1026.h +lib/ebcdic1144.h +lib/iso2022_jp.h +lib/vietcomb.h +lib/mac_ukraine.h +lib/ebcdic1166.h +lib/cp863.h +lib/cp852.h +lib/cp1258.h +lib/cp1251.h +lib/nextstep.h +lib/ebcdic16804.h +lib/iso2022_jpms.h +lib/riscos1.h +lib/iconv_open2.h +lib/ucs2internal.h +lib/loop_unicode.h +lib/ebcdic1143.h +lib/cp861.h +lib/ebcdic1157.h +lib/ucs2swapped.h +lib/encodings.def +lib/tds565.h +lib/cp932ext.h +lib/gb12345ext.h +lib/loop_wchar.h +tests/table-from.cpp +tests/cmp.cpp +tests/check-stateless +tests/tests.cmake +tests/uniq-u.cpp +tests/reiconv-test.cpp +tests/table-to.cpp +tests/check-stateful +tests/genutf8.cpp +tests/data/IBM-284.TXT +tests/data/IBM-1112.TXT +tests/data/IBM-1146.TXT +tests/data/ISO-8859-2.TXT +tests/data/SHIFT_JIS.TXT +tests/data/ISO-8859-9.TXT +tests/data/CP1163.IRREVERSIBLE.TXT +tests/data/UCS-4LE-snippet +tests/data/CP850.TXT +tests/data/CP1161.TXT +tests/data/CP737.TXT +tests/data/IBM-285.TXT +tests/data/UTF-32BE-snippet +tests/data/CP865.TXT +tests/data/IBM-870.TXT +tests/data/ISO-2022-JP-1-snippet +tests/data/CP862.TXT +tests/data/BIG5-HKSCS-2008-snippet.UTF-8 +tests/data/ISO-2022-CN-snippet.UTF-8 +tests/data/GB18030-2005-BMP.TXT +tests/data/NEXTSTEP.TXT +tests/data/MacThai.TXT +tests/data/MuleLao-1.TXT +tests/data/IBM-1155.TXT +tests/data/ISO-2022-JP-3-snippet +tests/data/ISO-2022-KR-snippet.UTF-8 +tests/data/BIG5-2003.TXT +tests/data/CP874.TXT +tests/data/MacIceland.TXT +tests/data/IBM-1148.TXT +tests/data/IBM-037.TXT +tests/data/IBM-1145.TXT +tests/data/MacCyrillic.TXT +tests/data/CP1163.TXT +tests/data/ISO-2022-JP-snippet.UTF-8 +tests/data/JOHAB.TXT +tests/data/IBM-1160.IRREVERSIBLE.TXT +tests/data/BIG5-HKSCS-1999.TXT +tests/data/MacRoman.TXT +tests/data/IBM-12712.TXT +tests/data/ISO-2022-JP-MS-snippet.UTF-8 +tests/data/CP922.TXT +tests/data/CP1255-snippet.UTF-8 +tests/data/EUC-JISX0213.TXT +tests/data/DEC-HANYU.TXT +tests/data/IBM-1147.TXT +tests/data/MacCroatian.TXT +tests/data/IBM-424.TXT +tests/data/IBM-1157.TXT +tests/data/IBM-277.TXT +tests/data/UCS-4BE-snippet.UTF-8 +tests/data/ISO-IR-165.TXT +tests/data/EUC-CN.TXT +tests/data/IBM-871.TXT +tests/data/CP1258.TXT +tests/data/IBM-1160.TXT +tests/data/ISO-8859-6.TXT +tests/data/CP853.TXT +tests/data/IBM-924.TXT +tests/data/IBM-1026.TXT +tests/data/CP861.TXT +tests/data/EUC-JP.TXT +tests/data/CP1253.TXT +tests/data/IBM-1137.TXT +tests/data/MacTurkish.TXT +tests/data/JIS_X0201.TXT +tests/data/CP1255.TXT +tests/data/MacHebrew.TXT +tests/data/EUC-TW.TXT +tests/data/BIG5-HKSCS-2001-snippet +tests/data/CP949.TXT +tests/data/UTF-7-snippet +tests/data/KOI8-R.TXT +tests/data/UTF-16-snippet.UTF-8 +tests/data/CP1131.TXT +tests/data/BIG5-HKSCS-2004-snippet.UTF-8 +tests/data/BIG5-HKSCS-2008.TXT +tests/data/ISO-2022-CN-EXT-snippet +tests/data/IBM-16804.TXT +tests/data/CP858.TXT +tests/data/IBM-1165.TXT +tests/data/IBM-1149.TXT +tests/data/IBM-1097.TXT +tests/data/IBM-280.TXT +tests/data/BIG5-HKSCS-2001.IRREVERSIBLE.TXT +tests/data/IBM-1141.TXT +tests/data/BIG5-HKSCS-2004-snippet +tests/data/ISO-8859-5.TXT +tests/data/BIG5-HKSCS-2001.TXT +tests/data/CP1250.TXT +tests/data/ISO-2022-JP-3-snippet.UTF-8 +tests/data/IBM-1142.TXT +tests/data/ISO-8859-8.TXT +tests/data/ISO-2022-JP-1-snippet.UTF-8 +tests/data/BIG5-HKSCS-2001-snippet.UTF-8 +tests/data/IBM-1156.TXT +tests/data/CP932.IRREVERSIBLE.TXT +tests/data/KOI8-RU.TXT +tests/data/RISCOS-LATIN1.TXT +tests/data/ISO-2022-JP-2-snippet.UTF-8 +tests/data/CP855.TXT +tests/data/CP1161.IRREVERSIBLE.TXT +tests/data/IBM-1166.TXT +tests/data/MacCentralEurope.TXT +tests/data/ISO-IR-165.IRREVERSIBLE.TXT +tests/data/HZ-snippet.UTF-8 +tests/data/ISO-8859-10.TXT +tests/data/UTF-16LE-snippet +tests/data/ISO-8859-15.TXT +tests/data/BIG5-HKSCS-1999.IRREVERSIBLE.TXT +tests/data/Georgian-PS.TXT +tests/data/UCS-2BE-snippet +tests/data/GB18030-2005.IRREVERSIBLE.TXT +tests/data/CP863.TXT +tests/data/ISO-8859-7.TXT +tests/data/TCVN-snippet.UTF-8 +tests/data/IBM-500.TXT +tests/data/ISO-8859-14.TXT +tests/data/MacRomania.TXT +tests/data/PT154.TXT +tests/data/UTF-16-snippet +tests/data/ISO646-JP.TXT +tests/data/IBM-1123.TXT +tests/data/IBM-1164.TXT +tests/data/UTF-16BE-snippet.UTF-8 +tests/data/ISO-2022-KR-snippet +tests/data/DEC-HANYU.IRREVERSIBLE.TXT +tests/data/HP-ROMAN8.TXT +tests/data/IBM-1153.TXT +tests/data/UCS-2LE-snippet +tests/data/ISO-2022-CN-snippet +tests/data/TIS-620.TXT +tests/data/HZ-snippet +tests/data/CP1129.TXT +tests/data/TDS565.TXT +tests/data/MacGreek.TXT +tests/data/ISO-8859-11.TXT +tests/data/ASCII.TXT +tests/data/ISO646-CN.TXT +tests/data/SHIFT_JISX0213.TXT +tests/data/CP1124.TXT +tests/data/UCS-2LE-snippet.UTF-8 +tests/data/EUC-TW.IRREVERSIBLE.TXT +tests/data/UTF-32LE-snippet.UTF-8 +tests/data/CP1255-snippet +tests/data/Translit1.ISO-8859-1 +tests/data/IBM-905.TXT +tests/data/UTF-16BE-snippet +tests/data/UTF-32-snippet.UTF-8 +tests/data/CP950.IRREVERSIBLE.TXT +tests/data/ISO-8859-13.TXT +tests/data/Quotes.ASCII +tests/data/BIG5-HKSCS-1999-snippet +tests/data/ATARIST.TXT +tests/data/IBM-1154.TXT +tests/data/CP1251.TXT +tests/data/CP1258-snippet +tests/data/TCVN.IRREVERSIBLE.TXT +tests/data/CP1125.TXT +tests/data/CP866.TXT +tests/data/UTF-7-snippet.UTF-8 +tests/data/CP1162.TXT +tests/data/CP1254.TXT +tests/data/TCVN.TXT +tests/data/CP950.TXT +tests/data/EUC-JP.IRREVERSIBLE.TXT +tests/data/UCS-4LE-snippet.UTF-8 +tests/data/IBM-1122.TXT +tests/data/CP1252.TXT +tests/data/CP1133.TXT +tests/data/IBM-838.IRREVERSIBLE.TXT +tests/data/IBM-1140.TXT +tests/data/ISO-8859-3.TXT +tests/data/IBM-1025.TXT +tests/data/CP1258-snippet.UTF-8 +tests/data/BIG5.TXT +tests/data/CP852.TXT +tests/data/CP856.TXT +tests/data/EUC-KR.TXT +tests/data/BIG5-HKSCS-2004.IRREVERSIBLE.TXT +tests/data/BIG5-HKSCS-1999-snippet.UTF-8 +tests/data/CP936.TXT +tests/data/KOI8-U.TXT +tests/data/CP932.TXT +tests/data/IBM-4971.TXT +tests/data/IBM-880.TXT +tests/data/DEC-KANJI.TXT +tests/data/UCS-4BE-snippet +tests/data/IBM-875.TXT +tests/data/CP857.TXT +tests/data/Georgian-Academy.TXT +tests/data/CP1256.TXT +tests/data/UTF-32-snippet +tests/data/IBM-838.TXT +tests/data/MacUkraine.TXT +tests/data/UTF-32BE-snippet.UTF-8 +tests/data/ISO-2022-JP-snippet +tests/data/IBM-1130.TXT +tests/data/BIG5-HKSCS-2008-snippet +tests/data/BIG5-HKSCS-2004.TXT +tests/data/ISO-2022-JP-MS-snippet +tests/data/CP775.TXT +tests/data/IBM-425.TXT +tests/data/ARMSCII-8.IRREVERSIBLE.TXT +tests/data/UCS-2BE-snippet.UTF-8 +tests/data/ISO-8859-16.TXT +tests/data/IBM-423.TXT +tests/data/ISO-2022-CN-EXT-snippet.UTF-8 +tests/data/CP1255.IRREVERSIBLE.TXT +tests/data/IBM-1144.TXT +tests/data/IBM-297.TXT +tests/data/ISO-2022-JP-MS-snippet.alt +tests/data/TCVN-snippet +tests/data/CP1257.TXT +tests/data/GBK.TXT +tests/data/BIG5-HKSCS-2008.IRREVERSIBLE.TXT +tests/data/CP864.TXT +tests/data/CP869.TXT +tests/data/ISO-8859-4.TXT +tests/data/Translit1.ASCII +tests/data/Quotes.ISO-8859-1 +tests/data/UTF-32LE-snippet +tests/data/Quotes.UTF-8 +tests/data/RK1048.TXT +tests/data/IBM-282.TXT +tests/data/ISO-2022-JP-2-snippet +tests/data/IBM-273.TXT +tests/data/KOI8-T.TXT +tests/data/MacArabic.TXT +tests/data/VISCII.TXT +tests/data/UTF-16LE-snippet.UTF-8 +tests/data/IBM-1132.TXT +tests/data/CP437.TXT +tests/data/ISO-8859-1.TXT +tests/data/CP860.TXT +tests/data/IBM-1047.TXT +tests/data/CP1046.TXT +tests/data/IBM-1143.TXT +tests/data/IBM-278.TXT +tests/data/CP1258.IRREVERSIBLE.TXT +tests/data/ARMSCII-8.TXT +tests/data/GB18030-2022-BMP.TXT +tests/data/IBM-1158.TXT +tests/data/BIG5-2003.IRREVERSIBLE.TXT +tests/test-shiftseq.cpp +tests/test-to-wchar.cpp +tests/gengb18030z.cpp +COPYING +Makefile.devel +include/cppp/reiconv.hpp.in +CMakeLists.txt +README.md +FILELIST +CPPPPKG +cpppdist.py +ChangeLog +windows/libcppp-reiconv.rc +NEWS.md diff --git a/HACKING b/HACKING deleted file mode 100644 index fe28688d..00000000 --- a/HACKING +++ /dev/null @@ -1,72 +0,0 @@ -All you need to know when hacking (modifying) GNU libiconv or when building -it off the Git repository. - - -Requirements -============ - -You will need reasonably recent versions of the build tools: - - * A C compiler. Such as GNU GCC. - + Homepage: - https://gcc.gnu.org/ - - * GNU automake 1.16.x - + Homepage: - https://www.gnu.org/software/automake/ - - * GNU autoconf 2.69 or newer - + Homepage: - https://www.gnu.org/software/autoconf/ - - * GNU m4 - + Homepage: - https://www.gnu.org/software/m4/ - - * GNU gperf - + Homepage: - https://www.gnu.org/software/gperf/ - - * GNU groff 1.17 or newer - + Homepage: - https://www.gnu.org/software/groff/ - - * Perl - + Homepage: - https://www.perl.org/ - - * Either an internet connection or a recent copy of GNU gnulib. - + Homepage: - https://www.gnu.org/software/gnulib/ - -And, of course, the packages listed in the DEPENDENCIES file. - - -Building off the Git repository -=============================== - -Access to the Git repository is described at -https://savannah.gnu.org/git/?group=libiconv . - -After fetching the sources from the Git repository, peek at the comments in -autogen.sh, then run - ./autopull.sh - ./autogen.sh -Then you can proceed with "./configure" as usual. - -Each time you want to update the source, do not only "git pull". Instead do - git pull && ./autopull.sh - ./autogen.sh - - -Adding new encodings -==================== - -For an indication which encodings are acceptable in the official version of -GNU libiconv, take a look at NOTES. - -For an indication which files need to be modified when adding a new encoding, -look for example at the 2007-05-25 ChangeLog entry for RK1048. The lib/*.h -file for an encoding is usually generated by one of the tools in the tools/ -directory. All you need to provide is the conversion table in the format of -the many *.TXT files. diff --git a/INSTALL.generic b/INSTALL.generic deleted file mode 100644 index ad36ed04..00000000 --- a/INSTALL.generic +++ /dev/null @@ -1,262 +0,0 @@ -Basic Installation -================== - - These are generic installation instructions. - - The ‘configure’ shell script attempts to guess correct values for -various system-dependent variables used during compilation. It uses -those values to create a ‘Makefile’ in each directory of the package. -It may also create one or more ‘.h’ files containing system-dependent -definitions. Finally, it creates a shell script ‘config.status’ that -you can run in the future to recreate the current configuration, a file -‘config.cache’ that saves the results of its tests to speed up -reconfiguring, and a file ‘config.log’ containing compiler output -(useful mainly for debugging ‘configure’). - - If you need to do unusual things to compile the package, please try -to figure out how ‘configure’ could check whether to do them, and mail -diffs or instructions to the address given in the ‘README’ so they can -be considered for the next release. If at some point ‘config.cache’ -contains results you don't want to keep, you may remove or edit it. - - The file ‘configure.ac’ is used to create ‘configure’ by a program -called ‘autoconf’. You only need ‘configure.ac’ if you want to change -it or regenerate ‘configure’ using a newer version of ‘autoconf’. - -The simplest way to compile this package is: - - 1. ‘cd’ to the directory containing the package's source code and type - ‘./configure’ to configure the package for your system. If you're - using ‘csh’ on an old version of System V, you might need to type - ‘sh ./configure’ instead to prevent ‘csh’ from trying to execute - ‘configure’ itself. - - Running ‘configure’ takes awhile. While running, it prints some - messages telling which features it is checking for. - - 2. Type ‘make’ to compile the package. - - 3. Optionally, type ‘make check’ to run any self-tests that come with - the package. - - 4. Type ‘make install’ to install the programs and any data files and - documentation. - - 5. You can remove the program binaries and object files from the - source code directory by typing ‘make clean’. To also remove the - files that ‘configure’ created (so you can compile the package for - a different kind of computer), type ‘make distclean’. There is - also a ‘make maintainer-clean’ target, but that is intended mainly - for the package's developers. If you use it, you may have to get - all sorts of other programs in order to regenerate files that came - with the distribution. - -Compilers and Options -===================== - - Some systems require unusual options for compilation or linking that -the ‘configure’ script does not know about. You can give ‘configure’ -initial values for variables by setting them in the environment. Using -a Bourne-compatible shell, you can do that on the command line like -this: - CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure - -Or on systems that have the ‘env’ program, you can do it like this: - env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure - -Compiling For Multiple Architectures -==================================== - - You can compile the package for more than one kind of computer at the -same time, by placing the object files for each architecture in their -own directory. To do this, you must use a version of ‘make’ that -supports the ‘VPATH’ variable, such as GNU ‘make’. ‘cd’ to the -directory where you want the object files and executables to go and run -the ‘configure’ script. ‘configure’ automatically checks for the -source code in the directory that ‘configure’ is in and in ‘..’. - - If you have to use a ‘make’ that does not supports the ‘VPATH’ -variable, you have to compile the package for one architecture at a time -in the source code directory. After you have installed the package for -one architecture, use ‘make distclean’ before reconfiguring for another -architecture. - - On MacOS X 10.5 and later systems, you can create libraries and -executables that work on multiple system types--known as "fat" or -"universal" binaries--by specifying multiple '-arch' options to the -compiler but only a single '-arch' option to the preprocessor. Like -this: - - ./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \ - CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \ - CPP="gcc -E" CXXCPP="g++ -E" - - This is not guaranteed to produce working output in all cases. You -may have to build one architecture at a time and combine the results -using the 'lipo' tool if you have problems. - -Installation Names -================== - - By default, ‘make install’ will install the package's files in -‘/usr/local/bin’, ‘/usr/local/man’, etc. You can specify an -installation prefix other than ‘/usr/local’ by giving ‘configure’ the -option ‘--prefix=PATH’. - - You can specify separate installation prefixes for -architecture-specific files and architecture-independent files. If you -give ‘configure’ the option ‘--exec-prefix=PATH’, the package will use -PATH as the prefix for installing programs and libraries. -Documentation and other data files will still use the regular prefix. - - In addition, if you use an unusual directory layout you can give -options like ‘--bindir=PATH’ to specify different values for particular -kinds of files. Run ‘configure --help’ for a list of the directories -you can set and what kinds of files go in them. - - If the package supports it, you can cause programs to be installed -with an extra prefix or suffix on their names by giving ‘configure’ the -option ‘--program-prefix=PREFIX’ or ‘--program-suffix=SUFFIX’. - -Relocatable Installation -======================== - - By default, ‘make install’ will install a package with hardwired -file names, and the package will not work correctly when copied or -moved to a different location in the filesystem. - - Some packages pay attention to the ‘--enable-relocatable’ option to -‘configure’. This option makes the entire installed package -relocatable. This means, it can be moved or copied to a different -location on the filesystem. It is possible to make symlinks to the -installed and moved programs, and invoke them through the symlink. It -is possible to do the same thing with a hard link _only_ if the hard -linked file is in the same directory as the real program. - - For reliability it is best to give together with --enable-relocatable -a ‘--prefix’ option pointing to an otherwise unused (and never used -again) directory, for example, ‘--prefix=/tmp/inst$$’. This is -recommended because on some OSes the executables remember the location -of shared libraries (and prefer them over LD_LIBRARY_PATH !), therefore -such an executable will look for its shared libraries first in the -original installation directory and only then in the current -installation directory. - - Installation with ‘--enable-relocatable’ will not work for setuid / -setgid executables. (This is because such an executable kills its -LD_LIBRARY_PATH variable when it is launched.) - - The runtime penalty and size penalty are nearly zero on Linux 2.2 or -newer (just one system call more when an executable is launched), and -small on other systems (the wrapper program just sets an environment -variable and execs the real program). - -Optional Features -================= - - Some packages pay attention to ‘--enable-FEATURE’ options to -‘configure’, where FEATURE indicates an optional part of the package. -They may also pay attention to ‘--with-PACKAGE’ options, where PACKAGE -is something like ‘gnu-as’ or ‘x’ (for the X Window System). The -‘README’ should mention any ‘--enable-’ and ‘--with-’ options that the -package recognizes. - - For packages that use the X Window System, ‘configure’ can usually -find the X include and library files automatically, but if it doesn't, -you can use the ‘configure’ options ‘--x-includes=DIR’ and -‘--x-libraries=DIR’ to specify their locations. - - For packages that use the GNU libiconv library, you can use the -‘configure’ option ‘--with-libiconv-prefix’ to specify the prefix you -used while installing GNU libiconv. This option is not necessary if -that other prefix is the same as the one now specified through --prefix. - - For packages that use the GNU libintl library, you can use the -‘configure’ option ‘--with-libintl-prefix’ to specify the prefix you -used while installing GNU gettext-runtime. This option is not necessary if -that other prefix is the same as the one now specified through --prefix. - -Particular Systems -================== - - On HP-UX, the default C compiler is not ANSI C compatible. If GNU CC -is not installed, it is recommended to use the following options in order -to use an ANSI C compiler: - - ./configure CC="cc -Ae -D_XOPEN_SOURCE=500" - -and if that doesn't work, install pre-built binaries of GCC for HP-UX. - - On AIX 3, the C include files by default don't define some necessary -prototype declarations. If GNU CC is not installed, it is recommended to -use the following options: - - ./configure CC="xlc -D_ALL_SOURCE" - - On BeOS, user installed software goes in /boot/home/config, not -/usr/local. It is recommended to use the following options: - - ./configure --prefix=/boot/home/config - -Specifying the System Type -========================== - - There may be some features ‘configure’ can not figure out -automatically, but needs to determine by the type of host the package -will run on. Usually ‘configure’ can figure that out, but if it prints -a message saying it can not guess the host type, give it the -‘--host=TYPE’ option. TYPE can either be a short name for the system -type, such as ‘sun4’, or a canonical name with three fields: - CPU-COMPANY-SYSTEM - -See the file ‘config.sub’ for the possible values of each field. If -‘config.sub’ isn't included in this package, then this package doesn't -need to know the host type. - - If you are building compiler tools for cross-compiling, you can also -use the ‘--target=TYPE’ option to select the type of system they will -produce code for and the ‘--build=TYPE’ option to select the type of -system on which you are compiling the package. - -Sharing Defaults -================ - - If you want to set default values for ‘configure’ scripts to share, -you can create a site shell script called ‘config.site’ that gives -default values for variables like ‘CC’, ‘cache_file’, and ‘prefix’. -‘configure’ looks for ‘PREFIX/share/config.site’ if it exists, then -‘PREFIX/etc/config.site’ if it exists. Or, you can set the -‘CONFIG_SITE’ environment variable to the location of the site script. -A warning: not all ‘configure’ scripts look for a site script. - -Operation Controls -================== - - ‘configure’ recognizes the following options to control how it -operates. - -‘--cache-file=FILE’ - Use and save the results of the tests in FILE instead of - ‘./config.cache’. Set FILE to ‘/dev/null’ to disable caching, for - debugging ‘configure’. - -‘--help’ - Print a summary of the options to ‘configure’, and exit. - -‘--quiet’ -‘--silent’ -‘-q’ - Do not print messages saying which checks are being made. To - suppress all normal output, redirect it to ‘/dev/null’ (any error - messages will still be shown). - -‘--srcdir=DIR’ - Look for the package's source code in directory DIR. Usually - ‘configure’ can determine that directory automatically. - -‘--version’ - Print the version of Autoconf used to generate the ‘configure’ - script, and exit. - -‘configure’ also accepts some other, not widely useful, options. - diff --git a/INSTALL.windows b/INSTALL.windows deleted file mode 100644 index b41d0123..00000000 --- a/INSTALL.windows +++ /dev/null @@ -1,262 +0,0 @@ -Installation on Microsoft Windows: - -There are three ways to create binaries of this package for Microsoft Windows: -1) Native binaries, built using the mingw tool chain. -2) Native binaries, built using the MS Visual C/C++ tool chain. -3) Binaries for the Cygwin environment. - -=============================================================================== -1) Native binaries, built using the mingw tool chain. - - I recommend to use the Cygwin environment as the development environment (*) - and mingw only as the target (runtime, deployment) environment. - For this, you need to install - * Cygwin (from https://cygwin.com/), - * some packages available from the Cygwin package installer: - make - * the mingw cross-compilation tools and runtime package, available from - the Cygwin package installer (setup-x86_64.exe): - - for creating 32-bit binaries: packages - mingw64-i686-gcc-core, - mingw64-i686-headers, - mingw64-i686-runtime - - for creating 64-bit binaries: packages - mingw64-x86_64-gcc-core, - mingw64-x86_64-headers, - mingw64-x86_64-runtime - - Building 32-bit binaries for mingw is achieved through the following - preparation, configure, and build commands: - - PATH=/usr/local/mingw32/bin:$PATH - export PATH - ./configure --host=i686-w64-mingw32 --prefix=/usr/local/mingw32 \ - CC=i686-w64-mingw32-gcc \ - CPPFLAGS="-I/usr/local/mingw32/include -Wall" \ - LDFLAGS="-L/usr/local/mingw32/lib" - make - make check - - Building 64-bit binaries for mingw is achieved through the following - preparation, configure, and build commands: - - PATH=/usr/local/mingw64/bin:$PATH - export PATH - ./configure --host=x86_64-w64-mingw32 --prefix=/usr/local/mingw64 \ - CC=x86_64-w64-mingw32-gcc \ - CPPFLAGS="-I/usr/local/mingw64/include -Wall" \ - LDFLAGS="-L/usr/local/mingw64/lib" - make - make check - - Installation: - - make install - - (*) Note: The MSYS2 environment as a development environment is *not* - supported. This environment contains an ignoble and ignominious hack: - In a program invocation, the program *by default* receives different - arguments than the ones that the caller has passed. See - . - All program invocations in this environment are therefore unreliable. - -=============================================================================== -2) Native binaries, built using the MS Visual C/C++ tool chain. - - Note that binaries created with MSVC have a distribution constraint: They - depend on a closed-source library ('msvcr90.dll' for MSVC 9.0, - 'vcruntime140.dll' for MSVC 14.0, and so on) which is not normally part of - a Windows installation. - You cannot distribute 'vcruntime*.dll' with the binaries - this would be a - violation of the GPL and of the Microsoft EULA. - You can distribute the binaries without including 'vcruntime*.dll'. Users - who don't have this library on their system will require to pull some files - (api-ms-win*.dll) through the Windows Update mechanism, see - https://support.microsoft.com/en-us/kb/2999226 . - - This recipe requires MS Visual C/C++ 9.0 or newer. - You don't need the Visual Studio IDE, just the C/C++ tool chain. - As of 2016, you can install the MS Visual C/C++ 14.0 tool chain from - http://landinghub.visualstudio.com/visual-cpp-build-tools (it's the file - visualcppbuildtools_full.exe). - - This recipe requires also a Cygwin environment (with 'bash', the common POSIX - commands, and 'make') as a build environment. Building with 'nmake' is not - supported. - For this, you need to install - * Cygwin (from https://cygwin.com/), - * some packages available from the Cygwin package installer: - make - - You also need the scripts 'ar-lib' and 'compile' from - https://git.savannah.gnu.org/gitweb/?p=automake.git;a=blob_plain;f=lib/ar-lib;hb=HEAD - https://git.savannah.gnu.org/gitweb/?p=automake.git;a=blob_plain;f=lib/compile;hb=HEAD - respectively. - They may also be included in this package, in directory 'build-aux/'. - Save them; the instructions below assume that you stored them in $HOME/msvc/. - Make them executable: - chmod a+x ar-lib compile - - Start a bash (from Cygwin). - - Make sure that the MSVC tools ("cl" etc.) are found in PATH and the - environment variables INCLUDE and LIB are set appropriately. - In a typical MSVC 9.0 installation, it can be achieved by running - C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\vsvars32.bat - In a typical MSVC 14.0 installation on Windows 10, it can be achieved - - for creating 32-bit binaries: through the following bash commands: - - # Set environment variables for using MSVC 14, - # for creating native 32-bit Windows executables. - - # Windows C library headers and libraries. - WindowsCrtIncludeDir='C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt' - WindowsCrtLibDir='C:\Program Files (x86)\Windows Kits\10\Lib\10.0.10240.0\ucrt\' - INCLUDE="${WindowsCrtIncludeDir};$INCLUDE" - LIB="${WindowsCrtLibDir}x86;$LIB" - - # Windows API headers and libraries. - WindowsSdkIncludeDir='C:\Program Files (x86)\Windows Kits\8.1\Include\' - WindowsSdkLibDir='C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\' - INCLUDE="${WindowsSdkIncludeDir}um;${WindowsSdkIncludeDir}shared;$INCLUDE" - LIB="${WindowsSdkLibDir}x86;$LIB" - - # Visual C++ tools, headers and libraries. - VSINSTALLDIR='C:\Program Files (x86)\Microsoft Visual Studio 14.0' - VCINSTALLDIR="${VSINSTALLDIR}"'\VC' - PATH=`cygpath -u "${VCINSTALLDIR}"`/bin:"$PATH" - INCLUDE="${VCINSTALLDIR}"'\include;'"${INCLUDE}" - LIB="${VCINSTALLDIR}"'\lib;'"${LIB}" - - export INCLUDE LIB - - - for creating 64-bit binaries: through the following bash commands: - - # Set environment variables for using MSVC 14, - # for creating native 64-bit Windows executables. - - # Windows C library headers and libraries. - WindowsCrtIncludeDir='C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt' - WindowsCrtLibDir='C:\Program Files (x86)\Windows Kits\10\Lib\10.0.10240.0\ucrt\' - INCLUDE="${WindowsCrtIncludeDir};$INCLUDE" - LIB="${WindowsCrtLibDir}x64;$LIB" - - # Windows API headers and libraries. - WindowsSdkIncludeDir='C:\Program Files (x86)\Windows Kits\8.1\Include\' - WindowsSdkLibDir='C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\' - INCLUDE="${WindowsSdkIncludeDir}um;${WindowsSdkIncludeDir}shared;$INCLUDE" - LIB="${WindowsSdkLibDir}x64;$LIB" - - # Visual C++ tools, headers and libraries. - VSINSTALLDIR='C:\Program Files (x86)\Microsoft Visual Studio 14.0' - VCINSTALLDIR="${VSINSTALLDIR}"'\VC' - PATH=`cygpath -u "${VCINSTALLDIR}"`/bin/amd64:"$PATH" - INCLUDE="${VCINSTALLDIR}"'\include;'"${INCLUDE}" - LIB="${VCINSTALLDIR}"'\lib\amd64;'"${LIB}" - - export INCLUDE LIB - - Building 32-bit binaries with MSVC is achieved through the following - preparation, configure, and build commands: - - PATH=/usr/local/msvc32/bin:$PATH - export PATH - - win32_target=_WIN32_WINNT_WINXP # for MSVC 9.0 - win32_target=_WIN32_WINNT_VISTA # possibly for MSVC >= 10.0 - win32_target=_WIN32_WINNT_WIN7 # possibly for MSVC >= 10.0 - win32_target=_WIN32_WINNT_WIN8 # possibly for MSVC >= 10.0 - - ./configure --host=i686-w64-mingw32 --prefix=/usr/local/msvc32 \ - CC="$HOME/msvc/compile cl -nologo" \ - CFLAGS="-MD" \ - CXX="$HOME/msvc/compile cl -nologo" \ - CXXFLAGS="-MD" \ - CPPFLAGS="-D_WIN32_WINNT=$win32_target -I/usr/local/msvc32/include" \ - LDFLAGS="-L/usr/local/msvc32/lib" \ - LD="link" \ - NM="dumpbin -symbols" \ - STRIP=":" \ - AR="$HOME/msvc/ar-lib lib" \ - RANLIB=":" - make - make check - - Building 64-bit binaries with MSVC is achieved through the following - preparation, configure, and build commands: - - PATH=/usr/local/msvc64/bin:$PATH - export PATH - - win32_target=_WIN32_WINNT_WINXP # for MSVC 9.0 - win32_target=_WIN32_WINNT_VISTA # possibly for MSVC >= 10.0 - win32_target=_WIN32_WINNT_WIN7 # possibly for MSVC >= 10.0 - win32_target=_WIN32_WINNT_WIN8 # possibly for MSVC >= 10.0 - - ./configure --host=x86_64-w64-mingw32 --prefix=/usr/local/msvc64 \ - CC="$HOME/msvc/compile cl -nologo" \ - CFLAGS="-MD" \ - CXX="$HOME/msvc/compile cl -nologo" \ - CXXFLAGS="-MD" \ - CPPFLAGS="-D_WIN32_WINNT=$win32_target -I/usr/local/msvc64/include" \ - LDFLAGS="-L/usr/local/msvc64/lib" \ - LD="link" \ - NM="dumpbin -symbols" \ - STRIP=":" \ - AR="$HOME/msvc/ar-lib lib" \ - RANLIB=":" - make - make check - - Installation: - - make install - -=============================================================================== -3) Binaries for the Cygwin environment. - - The generic instructions in the INSTALL file apply. But here are more - specific ones. - - You need to install - * Cygwin (from https://cygwin.com/), - * some packages available from the Cygwin package installer: - make - * the Cygwin [cross-]compilation tools package, available from - the Cygwin package installer (setup-x86_64.exe): - - for creating 32-bit binaries: packages - cygwin32-gcc-core, - cygwin32 - - for creating 64-bit binaries: packages - gcc-core - - Building 32-bit binaries for Cygwin must be done in a directory *outside* - the Cygwin /home and /usr hierarchies. It is achieved through the following - preparation, configure, and build commands: - - PATH=/usr/local/cygwin32/bin:/usr/i686-pc-cygwin/sys-root/usr/bin:$PATH - export PATH - ./configure --host=i686-pc-cygwin --prefix=/usr/local/cygwin32 \ - CC=i686-pc-cygwin-gcc \ - CPPFLAGS="-I/usr/local/cygwin32/include -Wall" \ - LDFLAGS="-L/usr/local/cygwin32/lib" - make - make check - - Building 64-bit binaries for Cygwin is achieved through the following - preparation, configure, and build commands: - - PATH=/usr/local/cygwin64/bin:$PATH - export PATH - ./configure --host=x86_64-pc-cygwin --prefix=/usr/local/cygwin64 \ - CC=x86_64-pc-cygwin-gcc \ - CPPFLAGS="-I/usr/local/cygwin64/include -Wall" \ - LDFLAGS="-L/usr/local/cygwin64/lib" - make - make check - - Installation: - - make install - -=============================================================================== diff --git a/JOIN-GNU b/JOIN-GNU deleted file mode 100644 index 559b4e82..00000000 --- a/JOIN-GNU +++ /dev/null @@ -1,19 +0,0 @@ -Join the GNU Project -==================== - -GNU libiconv is part of the GNU Operating System, developed by the GNU Project. - -If you are the author of an awesome program and want to join us in -writing Free (libre) Software, please consider making it an official -GNU program and become a GNU Maintainer. Instructions on how to do -this are here: - https://www.gnu.org/help/evaluation -We are looking forward to hacking with you! - -Don't have a program to contribute? Look at all the other ways to help: - https://www.gnu.org/help/help.html - -And to learn more about Free (libre) Software in general, please read -and share this page: - https://gnu.org/philosophy/free-sw.html - diff --git a/Makefile.devel b/Makefile.devel index f20755f2..17c46a78 100644 --- a/Makefile.devel +++ b/Makefile.devel @@ -10,271 +10,126 @@ This makefile requires GNU Make. endif SHELL = /bin/sh -MAKE = make -AUTOCONF = autoconf -AUTOHEADER = autoheader -AUTOMAKE = automake-1.16 -ACLOCAL = aclocal-1.16 GPERF = gperf - -# Ignore the built-in default for CC. Also ignore $(CC) if it is empty. -# https://www.gnu.org/software/make/manual/html_node/Implicit-Variables.html -# https://www.gnu.org/software/make/manual/html_node/Origin-Function.html -# https://www.gnu.org/software/make/manual/html_node/Text-Functions.html#index-findstring -# https://www.gnu.org/software/make/manual/html_node/Text-Functions.html#index-stripping-whitespace -# https://www.gnu.org/software/make/manual/html_node/Conditional-Functions.html#index-or -# https://www.gnu.org/software/make/manual/html_node/Override-Directive.html -ifneq ($(or $(findstring $(origin CC), undefined default),$(if $(strip $(CC)),,empty)),) -override CC = gcc -Wall -endif - -# Ignore the built-in default for CFLAGS. -# https://www.gnu.org/software/make/manual/html_node/Implicit-Variables.html -# https://www.gnu.org/software/make/manual/html_node/Origin-Function.html -# https://www.gnu.org/software/make/manual/html_node/Text-Functions.html#index-findstring -ifneq ($(findstring $(origin CFLAGS), undefined default),) -CFLAGS = -O -endif - -MAN2HTML = groff -mandoc -Thtml -CP = cp +MKDIR = mkdir -p RM = rm -f +all : lib/generated \ + lib/generated/aliases.h lib/generated/aliases_sysaix.h lib/generated/aliases_syshpux.h lib/generated/aliases_sysosf1.h lib/generated/aliases_syssolaris.h \ + lib/generated/aliases_aix.h lib/generated/aliases_aix_sysaix.h \ + lib/generated/aliases_osf1.h lib/generated/aliases_osf1_sysosf1.h \ + lib/generated/aliases_dos.h \ + lib/generated/aliases_zos.h \ + lib/generated/aliases_extra.h \ + lib/generated/flags.h -all : srclib/Makefile.in \ - configures config.h.in \ - include/iconv.h.build.in \ - lib/aliases.h lib/aliases_sysaix.h lib/aliases_syshpux.h lib/aliases_sysosf1.h lib/aliases_syssolaris.h \ - lib/aliases_aix.h lib/aliases_aix_sysaix.h \ - lib/aliases_osf1.h lib/aliases_osf1_sysosf1.h \ - lib/aliases_dos.h \ - lib/aliases_zos.h \ - lib/aliases_extra.h \ - lib/flags.h lib/translit.h \ - man/iconv.1.html man/iconv.3.html man/iconv_close.3.html man/iconv_open.3.html man/iconvctl.3.html man/iconv_open_into.3.html \ - force - cd libcharset && $(MAKE) -f Makefile.devel all - - -# Before making a new release: -# - check that the encoding lists in README and man/iconv_open.3 are up to date, -# - check that the files in libcharset/lib/ are in sync with the gnulib module -# 'localcharset', -# - increment the version number in -# configure.ac -# include/iconv.h.in -# README -# - update the version info in lib/Makefile.in, -# - $ ./autogen.sh -# Making a new release: -# - $ ./configure CPPFLAGS=-Wall; make; make check -# - $ make dist - - -GNULIB_MODULES = \ - binary-io \ - error \ - gettext \ - gettext-h \ - lib-symbol-visibility \ - mbstate \ - progname \ - relocatable-prog \ - safe-read \ - sigpipe \ - stdbool \ - stdio \ - stdlib \ - strerror \ - unistd \ - uniwidth/width \ - unlocked-io \ - xalloc \ - libiconv-misc - -srclib/Makefile.gnulib : - if test -n "$$GNULIB_TOOL"; then \ - $$GNULIB_TOOL --copy-file m4/codeset.m4 srcm4/codeset.m4 || exit $$?; \ - $$GNULIB_TOOL --lib=libicrt --source-base=srclib --m4-base=srcm4 --makefile-name=Makefile.gnulib --no-libtool --local-dir=gnulib-local --no-vc-files \ - --import $(GNULIB_MODULES); \ - fi - -gnulib-imported-files : force - if test -n "$$GNULIB_TOOL"; then \ - for file in config.guess config.sub; do \ - $$GNULIB_TOOL --copy-file build-aux/$$file || exit $$?; \ - chmod a+x build-aux/$$file || exit $$?; \ - done; \ - $$GNULIB_TOOL --copy-file tests/qemu.h || exit $$?; \ - fi - -srclib/Makefile.in : srclib/Makefile.am srclib/Makefile.gnulib aclocal.m4 -# Make sure we get new versions of files brought in by automake. - (cd build-aux && rm -f depcomp install-sh mdate-sh missing test-driver) - $(AUTOMAKE) --gnits --add-missing --copy srclib/Makefile && rm -rf autom4te.cache - - -CONFIGURES = configure -CONFIGURES_IN = configure.ac - -aclocal.m4 : $(CONFIGURES_IN) srclib/Makefile.gnulib $(wildcard m4/*.m4) $(wildcard srcm4/*.m4) - $(ACLOCAL) -I m4 -I srcm4 --output=$@ && touch $@ && rm -rf autom4te.cache - -configures : $(CONFIGURES) +lib/generated : + $(MKDIR) lib/generated -AUTOCONF_FILES = aclocal.m4 $(wildcard m4/*.m4) $(wildcard srcm4/*.m4) - -configure : configure.ac $(AUTOCONF_FILES) - $(AUTOCONF) && rm -rf autom4te.cache - -check-configures : $(CONFIGURES) - set -e; for f in $(CONFIGURES); do bash -x -n $$f; done - -config.h.in : configure.ac $(AUTOCONF_FILES) - $(AUTOHEADER) && rm -rf autom4te.cache - touch $@ - - -include/iconv.h.build.in : include/iconv.h.in include/export.h - sed -e 's/extern \([^"]\)/extern LIBICONV_DLL_EXPORTED \1/' \ - -e '/_LIBICONV_VERSION/r include/export.h' \ - < $< > $@ - - -lib/aliases.h lib/canonical.h lib/canonical_local.h : lib/encodings.def lib/encodings_local.def lib/genaliases.c +lib/generated/aliases.h lib/generated/canonical.h lib/generated/canonical_local.h : lib/encodings.def lib/genaliases.c $(CC) $(CFLAGS) lib/genaliases.c -o genaliases - ./genaliases lib/aliases.gperf canonical.sh canonical_local.sh + ./genaliases lib/generated/aliases.gperf canonical.sh canonical_local.sh $(RM) genaliases - $(GPERF) -m 10 lib/aliases.gperf > tmp.h - sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/aliases.h - sh canonical.sh > lib/canonical.h - sh canonical_local.sh > lib/canonical_local.h + $(GPERF) -m 10 lib/generated/aliases.gperf > tmp.h + sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/generated/aliases.h + sh canonical.sh > lib/generated/canonical.h + sh canonical_local.sh > lib/generated/canonical_local.h $(RM) tmp.h canonical.sh canonical_local.sh -lib/aliases_sysaix.h lib/canonical_sysaix.h lib/canonical_local_sysaix.h : lib/encodings.def lib/encodings_local.def lib/genaliases.c +lib/generated/aliases_sysaix.h lib/generated/canonical_sysaix.h lib/generated/canonical_local_sysaix.h : lib/encodings.def lib/genaliases.c $(CC) $(CFLAGS) -DUSE_AIX_ALIASES lib/genaliases.c -o genaliases - ./genaliases lib/aliases_sysaix.gperf canonical.sh canonical_local.sh + ./genaliases lib/generated/aliases_sysaix.gperf canonical.sh canonical_local.sh $(RM) genaliases - $(GPERF) -m 10 lib/aliases_sysaix.gperf > tmp.h - sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/aliases_sysaix.h - sh canonical.sh > lib/canonical_sysaix.h - sh canonical_local.sh > lib/canonical_local_sysaix.h + $(GPERF) -m 10 lib/generated/aliases_sysaix.gperf > tmp.h + sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/generated/aliases_sysaix.h + sh canonical.sh > lib/generated/canonical_sysaix.h + sh canonical_local.sh > lib/generated/canonical_local_sysaix.h $(RM) tmp.h canonical.sh canonical_local.sh -lib/aliases_syshpux.h lib/canonical_syshpux.h lib/canonical_local_syshpux.h : lib/encodings.def lib/encodings_local.def lib/genaliases.c +lib/generated/aliases_syshpux.h lib/generated/canonical_syshpux.h lib/generated/canonical_local_syshpux.h : lib/encodings.def lib/genaliases.c $(CC) $(CFLAGS) -DUSE_HPUX_ALIASES lib/genaliases.c -o genaliases - ./genaliases lib/aliases_syshpux.gperf canonical.sh canonical_local.sh + ./genaliases lib/generated/aliases_syshpux.gperf canonical.sh canonical_local.sh $(RM) genaliases - $(GPERF) -m 10 lib/aliases_syshpux.gperf > tmp.h - sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/aliases_syshpux.h - sh canonical.sh > lib/canonical_syshpux.h - sh canonical_local.sh > lib/canonical_local_syshpux.h + $(GPERF) -m 10 lib/generated/aliases_syshpux.gperf > tmp.h + sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/generated/aliases_syshpux.h + sh canonical.sh > lib/generated/canonical_syshpux.h + sh canonical_local.sh > lib/generated/canonical_local_syshpux.h $(RM) tmp.h canonical.sh canonical_local.sh -lib/aliases_sysosf1.h lib/canonical_sysosf1.h lib/canonical_local_sysosf1.h : lib/encodings.def lib/encodings_local.def lib/genaliases.c +lib/generated/aliases_sysosf1.h lib/generated/canonical_sysosf1.h lib/generated/canonical_local_sysosf1.h : lib/encodings.def lib/genaliases.c $(CC) $(CFLAGS) -DUSE_OSF1_ALIASES lib/genaliases.c -o genaliases - ./genaliases lib/aliases_sysosf1.gperf canonical.sh canonical_local.sh + ./genaliases lib/generated/aliases_sysosf1.gperf canonical.sh canonical_local.sh $(RM) genaliases - $(GPERF) -m 10 lib/aliases_sysosf1.gperf > tmp.h - sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/aliases_sysosf1.h - sh canonical.sh > lib/canonical_sysosf1.h - sh canonical_local.sh > lib/canonical_local_sysosf1.h + $(GPERF) -m 10 lib/generated/aliases_sysosf1.gperf > tmp.h + sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/generated/aliases_sysosf1.h + sh canonical.sh > lib/generated/canonical_sysosf1.h + sh canonical_local.sh > lib/generated/canonical_local_sysosf1.h $(RM) tmp.h canonical.sh canonical_local.sh -lib/aliases_syssolaris.h lib/canonical_syssolaris.h lib/canonical_local_syssolaris.h : lib/encodings.def lib/encodings_local.def lib/genaliases.c +lib/generated/aliases_syssolaris.h lib/generated/canonical_syssolaris.h lib/generated/canonical_local_syssolaris.h : lib/encodings.def lib/genaliases.c $(CC) $(CFLAGS) -DUSE_SOLARIS_ALIASES lib/genaliases.c -o genaliases - ./genaliases lib/aliases_syssolaris.gperf canonical.sh canonical_local.sh + ./genaliases lib/generated/aliases_syssolaris.gperf canonical.sh canonical_local.sh $(RM) genaliases - $(GPERF) -m 10 lib/aliases_syssolaris.gperf > tmp.h - sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/aliases_syssolaris.h - sh canonical.sh > lib/canonical_syssolaris.h - sh canonical_local.sh > lib/canonical_local_syssolaris.h + $(GPERF) -m 10 lib/generated/aliases_syssolaris.gperf > tmp.h + sed -e 's/^\(const struct alias \)/static \1/' < tmp.h > lib/generated/aliases_syssolaris.h + sh canonical.sh > lib/generated/canonical_syssolaris.h + sh canonical_local.sh > lib/generated/canonical_local_syssolaris.h $(RM) tmp.h canonical.sh canonical_local.sh -lib/aliases_aix.h lib/canonical_aix.h : lib/encodings_aix.def lib/genaliases2.c +lib/generated/aliases_aix.h lib/generated/canonical_aix.h : lib/encodings_aix.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_AIX lib/genaliases2.c -o genaliases - ./genaliases aix lib/aliases_aix.h lib/canonical_aix.h + ./genaliases aix lib/generated/aliases_aix.h lib/generated/canonical_aix.h $(RM) genaliases -lib/aliases_aix_sysaix.h lib/canonical_aix_sysaix.h : lib/encodings_aix.def lib/genaliases2.c +lib/generated/aliases_aix_sysaix.h lib/generated/canonical_aix_sysaix.h : lib/encodings_aix.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_AIX -DUSE_AIX_ALIASES lib/genaliases2.c -o genaliases - ./genaliases aix lib/aliases_aix_sysaix.h lib/canonical_aix_sysaix.h + ./genaliases aix lib/generated/aliases_aix_sysaix.h lib/generated/canonical_aix_sysaix.h $(RM) genaliases -lib/aliases_osf1.h lib/canonical_osf1.h : lib/encodings_osf1.def lib/genaliases2.c +lib/generated/aliases_osf1.h lib/generated/canonical_osf1.h : lib/encodings_osf1.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_OSF1 lib/genaliases2.c -o genaliases - ./genaliases osf1 lib/aliases_osf1.h lib/canonical_osf1.h + ./genaliases osf1 lib/generated/aliases_osf1.h lib/generated/canonical_osf1.h $(RM) genaliases -lib/aliases_osf1_sysosf1.h lib/canonical_osf1_sysosf1.h : lib/encodings_osf1.def lib/genaliases2.c +lib/generated/aliases_osf1_sysosf1.h lib/generated/canonical_osf1_sysosf1.h : lib/encodings_osf1.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_OSF1 -DUSE_OSF1_ALIASES lib/genaliases2.c -o genaliases - ./genaliases osf1 lib/aliases_osf1_sysosf1.h lib/canonical_osf1_sysosf1.h + ./genaliases osf1 lib/generated/aliases_osf1_sysosf1.h lib/generated/canonical_osf1_sysosf1.h $(RM) genaliases -lib/aliases_dos.h lib/canonical_dos.h : lib/encodings_dos.def lib/genaliases2.c +lib/generated/aliases_dos.h lib/generated/canonical_dos.h : lib/encodings_dos.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_DOS lib/genaliases2.c -o genaliases - ./genaliases dos lib/aliases_dos.h lib/canonical_dos.h + ./genaliases dos lib/generated/aliases_dos.h lib/generated/canonical_dos.h $(RM) genaliases -lib/aliases_zos.h lib/canonical_zos.h : lib/encodings_zos.def lib/genaliases2.c +lib/generated/aliases_zos.h lib/generated/canonical_zos.h : lib/encodings_zos.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_ZOS lib/genaliases2.c -o genaliases - ./genaliases zos lib/aliases_zos.h lib/canonical_zos.h + ./genaliases zos lib/generated/aliases_zos.h lib/generated/canonical_zos.h $(RM) genaliases -lib/aliases_extra.h lib/canonical_extra.h : lib/encodings_extra.def lib/genaliases2.c +lib/generated/aliases_extra.h lib/generated/canonical_extra.h : lib/encodings_extra.def lib/genaliases2.c $(CC) $(CFLAGS) -DUSE_EXTRA lib/genaliases2.c -o genaliases - ./genaliases extra lib/aliases_extra.h lib/canonical_extra.h + ./genaliases extra lib/generated/aliases_extra.h lib/generated/canonical_extra.h $(RM) genaliases -lib/flags.h : lib/encodings.def lib/encodings_aix.def lib/encodings_osf1.def lib/encodings_dos.def lib/encodings_zos.def lib/encodings_extra.def lib/converters.h lib/genflags.c +lib/generated/flags.h : lib/encodings.def lib/encodings_aix.def lib/encodings_osf1.def lib/encodings_dos.def lib/encodings_zos.def lib/encodings_extra.def lib/converters.h lib/genflags.c $(CC) $(CFLAGS) lib/genflags.c -o genflags - ./genflags > lib/flags.h + ./genflags > lib/generated/flags.h $(RM) genflags - -lib/translit.h : lib/translit.def lib/gentranslit.c - $(CC) $(CFLAGS) lib/gentranslit.c -o gentranslit - ./gentranslit < lib/translit.def > lib/translit.h - $(RM) gentranslit - - -man/%.html : man/% - $(MAN2HTML) $< > $@-t - grep -v '