Skip to content

Squelch example warnings, enable CI - #3897

Merged
pks-t merged 15 commits into
libgit2:masterfrom
pks-t:pks/squelch-example-warnings
Oct 10, 2016
Merged

Squelch example warnings, enable CI#3897
pks-t merged 15 commits into
libgit2:masterfrom
pks-t:pks/squelch-example-warnings

Conversation

@pks-t

@pks-t pks-t commented Aug 16, 2016

Copy link
Copy Markdown
Member

Recently, I wanted to build our examples and was hugely annoyed by all those warnings that were spilled left and right. So I cleaned up our tests, particularly the examples/general.c one, so that no warnings get thrown anymore.

Furthermore, I've changed CI scripts to build all tests to catch errors early on. I know that the examples aren't of huge importance, but considering they might be the first contact point with libgit2 for new developers, I'd say they should be reasonably clean and, as a bare minimum, compile. So that's why I think it is only sensible to break our CI builds when changes inside libgit2 break our examples.

@pks-t
pks-t force-pushed the pks/squelch-example-warnings branch 2 times, most recently from 3360607 to b1162d2 Compare August 16, 2016 09:45
@pks-t

pks-t commented Aug 16, 2016

Copy link
Copy Markdown
Member Author

The test failure is unrelated

Comment thread examples/general.c Outdated
// Including the `git2.h` header will include all the other libgit2 headers
// that you need. It should be the only thing you need to include in order
// to compile properly and get all the libgit2 API.
/* [**libgit2**][lg] is a portable, pure C implementation of the Git core

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would hide this text from the docco output. We need C++ comments or /** here for it to show.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now that you mention docco: my patches have another problem in that they change the order of documentation. With these patches, we will not have a logical order of initializing the library, opening repo, etc., but instead first describe all functions and at long last initialize the library.

I guess I'll re-order this such that the single functions will go after the main function.

@pks-t
pks-t force-pushed the pks/squelch-example-warnings branch from b1162d2 to 683155f Compare September 1, 2016 10:50
@pks-t

pks-t commented Sep 1, 2016

Copy link
Copy Markdown
Member Author

Okay, fixed up comments such that they appear in the correct order and are evaluated as documentation.

@pks-t
pks-t force-pushed the pks/squelch-example-warnings branch from 683155f to ec3f5a9 Compare October 10, 2016 07:04
@pks-t
pks-t merged commit dcd759b into libgit2:master Oct 10, 2016
@pks-t
pks-t deleted the pks/squelch-example-warnings branch October 10, 2016 07:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants