Mail Archives: geda-user/2015/09/11/17:32:48
--Apple-Mail=_FD32D18C-A575-4736-84D9-3EFF4B764B2F
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
charset=windows-1252
On Sep 11, 2015, at 3:12 PM, Russell Nelson (russnelson AT gmail DOT com) [via =
geda-user AT delorie DOT com] <geda-user AT delorie DOT com> wrote:
> People with actual jobs who need to get them done don't use =
undocumented parts of APIs because they knew that will screw them the =
next time they need to get actual work done.
That=92s preferable. Unfortunately, if it weren=92t for users =
contributing software using undocumented APIs, you would never have =
heard of gEDA. Most of the gnetlist back ends, including those for =
geda-pcb, predate my attempt to document the back end APIs.=20
Incidentally, what I came up with for API documentation is pretty crude, =
but it=92s what we have. I=92d love for somebody with better knowledge =
of the internals to review and fix it. If you think Scheme is hard, you =
should look at the C<->Guile FFI and its use in gEDA sometime :(
> Do it right or do it over.
Do it with what you can get, or fail.
John Doty Noqsi Aerospace, Ltd.
http://www.noqsi.com/
jpd AT noqsi DOT com
--Apple-Mail=_FD32D18C-A575-4736-84D9-3EFF4B764B2F
Content-Transfer-Encoding: quoted-printable
Content-Type: text/html;
charset=windows-1252
<html><head><meta http-equiv=3D"Content-Type" content=3D"text/html =
charset=3Dwindows-1252"></head><body style=3D"word-wrap: break-word; =
-webkit-nbsp-mode: space; -webkit-line-break: =
after-white-space;"><br><div><div>On Sep 11, 2015, at 3:12 PM, Russell =
Nelson (<a href=3D"mailto:russnelson AT gmail DOT com">russnelson AT gmail DOT com</a>) =
[via <a href=3D"mailto:geda-user AT delorie DOT com">geda-user AT delorie DOT com</a>] =
<<a href=3D"mailto:geda-user AT delorie DOT com">geda-user AT delorie DOT com</a>>=
wrote:</div><br class=3D"Apple-interchange-newline"><blockquote =
type=3D"cite"><div dir=3D"ltr">People with actual jobs who need to get =
them done don't use undocumented parts of APIs because they knew that =
will screw them the next time they need to get actual work =
done.</div></blockquote><div><br></div>That=92s preferable. =
Unfortunately, if it weren=92t for users contributing software using =
undocumented APIs, you would never have heard of gEDA. Most of the =
gnetlist back ends, including those for geda-pcb, predate my attempt to =
document the back end APIs. </div><div><br></div><div>Incidentally, =
what I came up with for API documentation is pretty crude, but it=92s =
what we have. I=92d love for somebody with better knowledge of the =
internals to review and fix it. If you think Scheme is hard, you should =
look at the C<->Guile FFI and its use in gEDA sometime =
:(</div><div><br></div><div><blockquote type=3D"cite"><div =
dir=3D"ltr"><div>Do it right or do it =
over.</div></div></blockquote><div><br></div>Do it with what you can =
get, or fail.</div><div><br></div><div apple-content-edited=3D"true">
<span class=3D"Apple-style-span" style=3D"border-collapse: separate; =
border-spacing: 0px;"><p style=3D"margin: 0.0px 0.0px 0.0px 0.0px"><font =
face=3D"Helvetica" size=3D"3" style=3D"font: 12.0px Helvetica">John =
Doty<span class=3D"Apple-converted-space"> =
<span class=3D"Apple-converted-space"> </span><span =
class=3D"Apple-converted-tab"> <span =
class=3D"Apple-converted-space"> </span></span></span>Noqsi =
Aerospace, Ltd.</font></p><p style=3D"margin: 0.0px 0.0px 0.0px =
0.0px"><a href=3D"http://www.noqsi.com/">http://www.noqsi.com/</a></p><p =
style=3D"margin: 0.0px 0.0px 0.0px 0.0px"><font face=3D"Helvetica" =
size=3D"3" style=3D"font: 12.0px Helvetica"><a =
href=3D"mailto:jpd AT noqsi DOT com">jpd AT noqsi DOT com</a></font></p><br =
class=3D"Apple-interchange-newline"></span>
</div>
<br></body></html>=
--Apple-Mail=_FD32D18C-A575-4736-84D9-3EFF4B764B2F--
- Raw text -