decoration decoration
Stories

GROKLAW
When you want to know more...
decoration
For layout only
Home
Archives
Site Map
Search
About Groklaw
Awards
Legal Research
Timelines
ApplevSamsung
ApplevSamsung p.2
ArchiveExplorer
Autozone
Bilski
Cases
Cast: Lawyers
Comes v. MS
Contracts/Documents
Courts
DRM
Gordon v MS
GPL
Grokdoc
HTML How To
IPI v RH
IV v. Google
Legal Docs
Lodsys
MS Litigations
MSvB&N
News Picks
Novell v. MS
Novell-MS Deal
ODF/OOXML
OOXML Appeals
OraclevGoogle
Patents
ProjectMonterey
Psystar
Quote Database
Red Hat v SCO
Salus Book
SCEA v Hotz
SCO Appeals
SCO Bankruptcy
SCO Financials
SCO Overview
SCO v IBM
SCO v Novell
SCO:Soup2Nuts
SCOsource
Sean Daly
Software Patents
Switch to Linux
Transcripts
Unix Books

Gear

Groklaw Gear

Click here to send an email to the editor of this weblog.


You won't find me on Facebook


Donate

Donate Paypal


No Legal Advice

The information on Groklaw is not intended to constitute legal advice. While Mark is a lawyer and he has asked other lawyers and law students to contribute articles, all of these articles are offered to help educate, not to provide specific legal advice. They are not your lawyers.

Here's Groklaw's comments policy.


What's New

STORIES
No new stories

COMMENTS last 48 hrs
No new comments


Sponsors

Hosting:
hosted by ibiblio

On servers donated to ibiblio by AMD.

Webmaster
The documentation can be treated as a separable component of the source code | 687 comments | Create New Account
Comments belong to whoever posts them. Please notify us of inappropriate comments.
The documentation can be treated as a separable component of the source code
Authored by: Anonymous on Saturday, April 28 2012 @ 08:47 AM EDT
Be careful, because "facts" as understood in US copyright law is a
term of art unless I'm sadly mistaken, which may not apply to fictional works.

That said, this does illustrate why I would not care to compare the API to
blueprints. Blueprints actually tell you how to build something. The API just
describes the outside of our black box. It hides the entire interior, so that
we're free to replace it without changing a lot of other things. I mean, a lot
of programming simply boils down to making sure that changes don't spiral out of
control, such that making one small change here requires dozens more changes
which in turn require even more changes, until you're practically rewriting your
whole program over one little bug. Encapsulation like this hopefully helps keep
it so that you don't need many changes.

As this implies, you can have an API and be told what something does while
having no idea how it does it. Suppose I gave you an API for an AI that took in
a string and returned another string with the AI's response to a Jeopardy
question. That would fully describe the API, but it wouldn't help you build a
machine like that at all. You'd have to ask IBM how they did it or figure out a
way to build your own.

Which Google did, of course, in spite of using the same APIs for compatibility.

[ Reply to This | Parent | # ]

The documentation can be treated as a separable component of the source code
Authored by: PJ on Saturday, April 28 2012 @ 05:42 PM EDT
Thanks very much!

[ Reply to This | Parent | # ]

Groklaw © Copyright 2003-2013 Pamela Jones.
All trademarks and copyrights on this page are owned by their respective owners.
Comments are owned by the individual posters.

PJ's articles are licensed under a Creative Commons License. ( Details )