In any case, in future it can be source of new questions and problems (like issue #5 and issue #6). In my opinion extract examples into separate source file better rather than fix comments time to time.

Thank you - I agree that having the examples in source is important (and they are, in fact: https://github.com/google/benchmark/blob/master/test/benchmark_test.cc) but having the examples in the comment in the main header makes it easier for users to find.

It's a difficult balance.

Sorry, we had to revert this merge, because it appears @Gluttton has not signed the CLA (contributor license agreement)? I'm a bit new to this here, so I might be wrong, but you'd be looking at one of the following two, as appropriate:

https://developers.google.com/open-source/cla/individual
https://developers.google.com/open-source/cla/corporate

To be clear, let us know as soon as you signed it, we'll check it's good on our side and re-integrate your commit. This is just a minor administrative setback, sorry about that.

And you only need to sign one, whichever is more appropriate for your situation.

English isn't my mother tongue, so I don't clearly understand meaning of the licence. As result, I wouldn't like to sign it (and any other document meaning of which I don't understand). But it doesn't mean that I have any claims!

In any way my changes couldn't be called as something significant and revert looks like the most simple way. I'm realy sorry that I've made your trouble. I admire the Google and your projects!