Bug 65779 - Makefile.win32 confusingly fails to list cairo.lib as a rather important install component
Summary: Makefile.win32 confusingly fails to list cairo.lib as a rather important inst...
Status: RESOLVED MOVED
Alias: None
Product: cairo
Classification: Unclassified
Component: win32 backend (show other bugs)
Version: 1.12.14
Hardware: x86 (IA32) Windows (All)
: medium major
Assignee: cairo-bugs mailing list
QA Contact: cairo-bugs mailing list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-06-15 07:40 UTC by Andreas Mohr
Modified: 2018-08-25 13:35 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments

Description Andreas Mohr 2013-06-15 07:40:31 UTC
src/Makefile.win32 unfortunately does not provide an install target. Rather, it resorts to post-build logging of potentially all result files that are relevant to a user:


static: inform $(CFG)/cairo-static.lib
dynamic: inform $(CFG)/cairo.dll

$(CFG)/cairo.dll: $(OBJECTS)
        @$(LD) $(CAIRO_LDFLAGS) -DLL -OUT:$@ $(CAIRO_LIBS) $(PIXMAN_LIBS) $(OBJECTS)

$(CFG)/cairo-static.lib: $(OBJECTS_STATIC)
        @$(AR) $(CAIRO_ARFLAGS) -OUT:$@ $(PIXMAN_LIBS) $(OBJECTS_STATIC)

all: inform $(CFG)/cairo.dll $(CFG)/cairo-static.lib
        @echo "Built successfully!"
        @echo "You should copy the following files to a proper place now:"
        @echo ""
        @echo " cairo-version.h (NOTE: toplevel, not the src/cairo-version.h one!)"
        @echo " src/cairo-features.h"
        @for x in $(enabled_cairo_headers); do echo "   src/$$x"; done
        @echo " src/$(CFG)/cairo.dll"
        @echo " src/$(CFG)/cairo-static.lib"


To add insult to injury, this to-be-installed files list is incomplete since it fails to mention the required link-time *dynamic* .lib (likely **implicitly** produced by the $(LD) invocation for cairo.dll above - as opposed to all other openly mentioned targets - yet nonetheless crucial).

This caused interim chaos and despair (read: considerable delay) due to not having placed all required files for other people to be using (in the non-static case, i.e.: cairo.dll/cairo.lib pair).
The reason that this issue was not caught in-place is that I was directly transplanting the "official, authoritative" list into CMake install parts, rather than having a look at the result directory contents itself, where I would then possibly have wondered about that additional file.

So, it seems there's that additional line missing:
        @echo " src/$(CFG)/cairo.lib"

Severity major since it kills usability/productivity and that little effort ought to be fixed quickly.

Thanks!
Comment 1 GitLab Migration User 2018-08-25 13:35:36 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/cairo/cairo/issues/86.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.