Commit d19f036e763021aef5b101cce38bbe420143d6a7

Authored by Jay Berkenbilt
1 parent c5c1a028

Clarify wording about wchar_t in README

Showing 1 changed file with 1 additions and 1 deletions
README.md
@@ -87,7 +87,7 @@ For example, to build qpdf on a system without wchar_t, be sure that -DQPDF_NO_W @@ -87,7 +87,7 @@ For example, to build qpdf on a system without wchar_t, be sure that -DQPDF_NO_W
87 87
88 Note that, when you build code with libqpdf, it is *not necessary* to have the definition of QPDF_NO_WCHAR_T in your build match what was defined when the library was built as long as you are not calling QUtil::call_main_from_wmain in your code. In other words, if your qpdf library was built on a system without wchar_t and you are using that system to build at some later time after wchar_t was available, as long as you don't call the function that uses it, you can just build normally. 88 Note that, when you build code with libqpdf, it is *not necessary* to have the definition of QPDF_NO_WCHAR_T in your build match what was defined when the library was built as long as you are not calling QUtil::call_main_from_wmain in your code. In other words, if your qpdf library was built on a system without wchar_t and you are using that system to build at some later time after wchar_t was available, as long as you don't call the function that uses it, you can just build normally.
89 89
90 -Note that QPDF_NO_WCHAR_T is never defined by autoconf or any other automated method. There is a hard rule in qpdf that values determined by autoconf are not available in the public API. This is because there is never a guarantee or even expectation that those values will match between the system on which qpdf was build and the system on which a user is building code with libqpdf. 90 +Note qpdf will never define QPDF_NO_WCHAR_T using autoconf or any other automated method in spite of the fact that it would be easy to do so. That is because there is a hard rule in qpdf that values determined by autoconf are not available in the public API. This is because there is never a guarantee or even expectation that those values will match between the system on which qpdf was build and the system on which a user is building code with libqpdf, and qpdf's include directory should look the same across all systems.
91 91
92 # Building on Windows 92 # Building on Windows
93 93