Comments on: Designing an API http://noya.inrain.org/blog/2008/06/11/designing-an-api/ Thoughts of Sven. Tue, 10 Nov 2009 17:01:22 +0000 hourly 1 http://wordpress.org/?v=3.0.5 By: Noya http://noya.inrain.org/blog/2008/06/11/designing-an-api/comment-page-1/#comment-85 Noya Thu, 12 Jun 2008 14:24:20 +0000 http://noya.inrain.org/blog/?p=36#comment-85 Hey Murray. You're right, I didn't implement much of the API yet. What I've written above was about a document containing the API draft. I will publish it as soon as possible. Most of the code you see in trunk is undocumented stubs. I'm actively coding now, so this will change soon. Thanks for your interest. I will keep this blog up-to-date. Help and comments are highly appreciated :) . Hey Murray. You’re right, I didn’t implement much of the API yet. What I’ve written above was about a document containing the API draft. I will publish it as soon as possible.
Most of the code you see in trunk is undocumented stubs. I’m actively coding now, so this will change soon.
Thanks for your interest. I will keep this blog up-to-date. Help and comments are highly appreciated :) .

]]> By: Murray Cumming http://noya.inrain.org/blog/2008/06/11/designing-an-api/comment-page-1/#comment-83 Murray Cumming Wed, 11 Jun 2008 15:47:45 +0000 http://noya.inrain.org/blog/?p=36#comment-83 It seems rather small. I guess that you haven't started writing actual API yet. I'd be happy to review it once there's something substantial there. From what I did find: - The gpointer here is unpleasant: gpointer soylent_entity_get() - None of the functions are documented. For instance: http://svn.gnome.org/viewvc/soylent/trunk/libsoylent/soylent-entity.c?view=markup Undocumented APIs often don't make sense. It seems rather small. I guess that you haven’t started writing actual API yet. I’d be happy to review it once there’s something substantial there.

From what I did find:
- The gpointer here is unpleasant:
gpointer soylent_entity_get()

- None of the functions are documented. For instance:
http://svn.gnome.org/viewvc/soylent/trunk/libsoylent/soylent-entity.c?view=markup
Undocumented APIs often don’t make sense.

]]>