You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add documentation about library files on Windows (issue #276)
Document that .dll.a is the correct import library format for GCC
toolchains (MSYS2/MinGW, Cygwin), and that .lib files are MSVC-specific.
Also add linking examples using pkg-config and manual flags.
Closes#276
Copy file name to clipboardExpand all lines: README.md
+25Lines changed: 25 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -163,6 +163,31 @@ configure: WARNING: Building from MSYS environment. Binaries will depend on msys
163
163
164
164
Consider switching to the MinGW64 shell for native Windows binaries.
165
165
166
+
#### Library files on Windows
167
+
168
+
When building with GCC-based toolchains (MSYS2/MinGW, Cygwin), the following library files are generated:
169
+
170
+
| File | Purpose |
171
+
|------|---------|
172
+
|`libhttpserver.a`| Static library archive |
173
+
|`libhttpserver.dll`| Shared library (DLL) |
174
+
|`libhttpserver.dll.a`| Import library for linking against the DLL |
175
+
|`libhttpserver.la`| Libtool archive (used by libtool during linking) |
176
+
177
+
**Note about `.lib` files:** The `.dll.a` format is the import library format used by GCC toolchains. If you're looking for `.lib` files, those are the MSVC (Microsoft Visual C++) import library format and are only generated when building with the MSVC toolchain. The `.dll.a` file serves the same purpose as `.lib` but for GCC-based compilers.
0 commit comments