Changes between Version 4 and Version 5 of HackingGtk


Ignore:
Timestamp:
Nov 28, 2007 10:08:34 AM (14 years ago)
Author:
alp@atoker.com
Comment:

Codify URL vs. URI public API policy

Legend:

Unmodified
Added
Removed
Modified
  • HackingGtk

    v4 v5  
    5555 * Check function parameters with g_return_if_fail() and g_return_val_if_fail()
    5656
     57 * Never use the abbreviation "URL" or "url" in any public API headers or documentation. Instead, use "URI" or "uri". This is a strong convention in GLib/GTK+ which deviates from the one used in WebCore and other WebKit ports.
     58   * Recommendation: Internally, relevant gchar* variables to be passed to or from the user should also be named "uri" until parsed into a KURL or WebCore data structure, at which point they should be called "url".
     59
    5760 * Try to cover implement several functions at the same time to get a better understanding of how they work together and to improve consistency. This is more effective than just implementing functions and signals one by one as needed.
    5861