From f380ae524390c188de65f9dd8de3336b7ff4757a Mon Sep 17 00:00:00 2001 From: Glenn Randers-Pehrson Date: Wed, 5 Jul 2017 19:20:57 -0500 Subject: [PATCH] [libpng16] Added instructions for disabling hardware optimizations in INSTALL. --- ANNOUNCE | 5 +++-- CHANGES | 3 ++- INSTALL | 31 +++++++++++++++++++++++-------- 3 files changed, 28 insertions(+), 11 deletions(-) diff --git a/ANNOUNCE b/ANNOUNCE index e8b2ac136..69c1ff90d 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,4 +1,4 @@ -Libpng 1.6.31beta02 - July 5, 2017 +Libpng 1.6.31beta02 - July 6, 2017 This is not intended to be a public release. It will be replaced within a few weeks by a public version or by another test version. @@ -69,7 +69,8 @@ Version 1.6.31beta01 [July 5, 2017] Added "Requires: zlib" to libpng.pc.in (Pieter Neerincx). Added special case for FreeBSD in arm/filter_neon.S (Maya Rashish). -Version 1.6.31beta02 [July 5, 2017] +Version 1.6.31beta02 [July 6, 2017] + Added instructions for disabling hardware optimizations in INSTALL. Send comments/corrections/commendations to png-mng-implement at lists.sf.net (subscription required; visit diff --git a/CHANGES b/CHANGES index b06e8702e..99301a6f5 100644 --- a/CHANGES +++ b/CHANGES @@ -5864,7 +5864,8 @@ Version 1.6.31beta01 [July 5, 2017] Added "Requires: zlib" to libpng.pc.in (Pieter Neerincx). Added special case for FreeBSD in arm/filter_neon.S (Maya Rashish). -Version 1.6.31beta02 [July 5, 2017] +Version 1.6.31beta02 [July 6, 2017] + Added instructions for disabling hardware optimizations in INSTALL. Send comments/corrections/commendations to png-mng-implement at lists.sf.net (subscription required; visit diff --git a/INSTALL b/INSTALL index 48b125049..5a957a6d2 100644 --- a/INSTALL +++ b/INSTALL @@ -16,10 +16,11 @@ Contents XI. Prepending a prefix to exported symbols XII. Configuring for compiler xxx: XIII. Removing unwanted object code - XIV. Changes to the build and configuration of libpng in libpng-1.5.x - XV. Setjmp/longjmp issues - XVI. Common linking failures - XVII. Other sources of information about libpng + XIV. Enabling or disabling hardware optimizations + XV. Changes to the build and configuration of libpng in libpng-1.5.x + XVI. Setjmp/longjmp issues + XVII. Common linking failures + XVIII. Other sources of information about libpng I. Simple installation @@ -281,7 +282,21 @@ library to fail if they call functions not available in your library. The size of the library itself should not be an issue, because only those sections that are actually used will be loaded into memory. -XIV. Changes to the build and configuration of libpng in libpng-1.5.x +XIV. Enabling or disabling hardware optimizations + +Certain hardware capabilites, such as the Intel SSE instructions, +are normally detected at run time. If you wish to avoid using them, +you can disable them via configure options such as + + --enable-arm-neon=no, --enable-mips-msa=no, --enable-intel-sse=no, + --enable-powerpc-vsx=no + +or via compiler-command options such as + + CPPFLAGS += "-DPNG_ARM_NEON_OPT=0, -DPNG_MIPS_MSA_OPT=0, + -DPNG_INTEL_SSE_OPT=0, -DPNG_POWERPC_VSX_OPT=0" + +XV. Changes to the build and configuration of libpng in libpng-1.5.x Details of internal changes to the library code can be found in the CHANGES file and in the GIT repository logs. These will be of no concern to the vast @@ -372,7 +387,7 @@ $PREFIX/include directory). Do not edit pnglibconf.h after you have built libpng, because than the settings would not accurately reflect the settings that were used to build libpng. -XV. Setjmp/longjmp issues +XVI. Setjmp/longjmp issues Libpng uses setjmp()/longjmp() for error handling. Unfortunately setjmp() is known to be not thread-safe on some platforms and we don't know of @@ -390,7 +405,7 @@ This requires setjmp/longjmp, so you must either build the library with PNG_SETJMP_SUPPORTED defined, or with PNG_SIMPLIFIED_READ_SUPPORTED and PNG_SIMPLIFIED_WRITE_SUPPORTED undefined. -XVI. Common linking failures +XVII. Common linking failures If your application fails to find libpng or zlib entries while linking: @@ -402,7 +417,7 @@ If your application fails to find libpng or zlib entries while linking: If you are using the vstudio project, observe the WARNING in project/vstudio/README.txt. -XVII. Other sources of information about libpng: +XVIII. Other sources of information about libpng: Further information can be found in the README and libpng-manual.txt files, in the individual makefiles, in png.h, and the manual pages