GCC Debugging/Draft

New content \ idea test page Posssible Book Guidelines About the book \ What is "GCC Debugging" Goals: verbose, easy to understand, manual cover troubleshooting with GCC make removing bugs a less painful \ time consuming process Intended audience: new gcc users with some experience in programming language being used Style: common language (not overly technical) Book Scope: gcc g++ gdb other compilers? Error and Warning pages should include: Verbose explanation of error message GCC Version(s) found in Earlier Versions of messages? Sample code that would cause the message to be displayed Fixes to get rid of trouble message (depending on cause) Error Page Layout 1 Notes on bottom, error causes are level 3 headings under level 2, "causes" Page Title... ==Causes== ===<Possible Error Cause>=== <syntaxhighlight lang="cpp"> // source code producing error </syntaxhighlight> ''' Solutions''' What to change... <syntaxhighlight lang="cpp"> // source code fixing error </syntaxhighlight> ==Notes== *Message found in gcc versions x.x.x to x.x.x <noinclude>{{displaytitle|title=Full Error Message}}</noinclude> {{BookCat}} example: Page Title... Causes Arguments in a function call do not match those in any function declaration For example, a function, "foo", is called from inside main with an argument that is not a perfect match for any of the currently existing implementations of "foo". void foo(int x); void foo(double x); int main () { long x = 5000; foo(x); ... Solutions Cast the argument to match a declaration int main () { long x = 5000; foo((int)x); Create a new, overloaded version of the called function to match the arguments void foo(int x); void foo(double x); void foo(long x); int main () { long x = 5000; foo(x); The same function is defined more then once Look for a misspelled or duplicate function definition/declaration Notes Message found in gcc version 4.5.1 Error Page Layout 2 Notes on top, causes are level 2 headings instead of 3 Page Title... example of error message <!-- Make below an info box? --> '''Found in:''' gcc versions x.x.x to x.x.x '''Past Versions:''' <!-- If there are any --> example of error message '''Found in:''' gcc versions x.x.x to x.x.x '''See Also:''' similar error messages? '''Causes:''' ==<Possible Error Cause>== <syntaxhighlight lang="cpp"> // source code producing error </syntaxhighlight> '''Solutions''' What to change... <syntaxhighlight lang="cpp"> // source code fixing error </syntaxhighlight> <noinclude>{{displaytitle|title=Full Error Message}}</noinclude> {{BookCat}} example: Page Title... foo.cpp:23:12 call of overloaded 'foo' is ambiguous Found in: gcc versions x.x.x to 4.5.1 Causes: Arguments in a function call do not match those in any function declaration For example, a function, "foo", is called from inside main with an argument that is not a perfect match for any of the currently existing implementations of "foo". void foo(int x); void foo(double x); int main () { long x = 5000; foo(x); ... Solutions Cast the argument to match a declaration int main () { long x = 5000; foo((int)x); Create a new, overloaded version of the called function to match the arguments void foo(int x); void foo(double x); void foo(long x); int main () { long x = 5000; foo(x); The same function is defined more then once Look for a misspelled or duplicate function definition/declaration