Daniel Hain wrote:
> Sebastien Roy wrote:
>>
>>>
>>> 4.5. Interfaces
>>>
>>> 4.5.1 Exported Interfaces:
>>> Interface Status
>>> Description
>>> ------- -----
>>> ---------
>>> /usr/lib/libgs.so Volatile
>>> Ghostscript shared library
>>> /usr/lib/libgs.so.8 Volatile
>>> Ghostscript shared library
>>> /usr/lib/libgs.so.8.64 Volatile
>>> Ghostscript shared library
>>> /usr/include/ghostscript Volatile
>>> Ghostscript header files directory
>>> /usr/include/ghostscript/iapi.h Volatile
>>> Ghostscript header files
>>> /usr/include/ghostscript/ierrors.h Volatile
>>> Ghostscript header files
>>> /usr/include/ghostscript/gdevdsp.h Volatile
>>> Ghostscript header files
>>> /usr/bin/gsx Volatile
>>> GTK+ frontend to libgs.so
>>> /usr/bin/gsc Volatile
>>> command-line frontend to libgs.so
>>>
>>
>> Given that this is a Public API, where is its documentation?
>>
>
> There are no man pages for these libraries and executables. But there
> is a man page for 'gs' which has already been delivered with the
> earlier version of Ghostscript.
> The description of the 8.64 API is online at
> http://pages.cs.wisc.edu/~ghost/doc/svn/API.htm
> and is located at
> /usr/share/ghostscript/8.63/doc/API.htm
> in the existing version available on OpenSolaris.
>
> They are part of the Ghostscript package and are not modified by this
> case.
>
IMO, given the lack of documentation, and lack of any history of
interface Stability, I'd recommend making those interfaces Project
Private. Projects can still use those interfaces, but they'll need a
Contract to do so, which will allow this project to track their usage,
and work with them if future updates to the ghostscript libraries are
needed.
- Garrett
