2009/417 [Deliver libgs.so shared library and Ghostscript header files]

[Sebastien Roy]

On Tue, 2009-07-28 at 14:19 -0700, Glenn Skinner wrote:
> Date: Tue, 28 Jul 2009 17:07:04 -0400
>     From: Sebastien Roy <Sebastien.Roy at sun.com>
>     Subject: Re: Deliver libgs.so shared library and Ghostscript
> 	    header files [PSARC/2009/417 FastTrack timeout 08/05/2009]
> 
>     On Tue, 2009-07-28 at 13:17 -0700, Daniel Hain wrote:
>     > Sebastien Roy wrote:
>     > >
>     > >>
>     > >>   4.5. Interfaces
>     > >>
>     > >>       4.5.1  Exported Interfaces:
>     > >>           Interface                              Status            Description
>     > >>           -------                                -----             ---------
>     ...
>     > >>        /usr/bin/gsx                              Volatile          GTK+ frontend to libgs.so
>     > >>        /usr/bin/gsc                              Volatile          command-line frontend to libgs.so
> 
>     ...
>     What is the intended use of /usr/bin/gsx and /usr/bin/gsc, then?
>     Are these implementation details of the API?  If so, they should
>     be Project Private.
> 
> No, that doesn't work.  If they're Project Private, they should not
> live in /usr/bin.
> 
> It comes down to the question of whether or not people are expected to
> invoke thse utilities directly.  If so, then they can't be Project
> Private.  If not, then they don't belong in /usr/bin.
> 
> I could go either way as far as the choice above ic concerned, but not
> with the middle ground of Project Private things in /usr/bin.

I concur.  If they are indeed implementation details of the API,
then /usr/bin isn't the right place.  If they are Public interfaces,
then they should be documented somehow.

-Seb