libftdi Archives

Subject: Re: Parallel installation of libftdi 1.x and 0.x

From: Xiaofan Chen <xiaofanc@xxxxxxxxx>
To: libftdi@xxxxxxxxxxxxxxxxxxxxxxx
Date: Mon, 18 Jun 2012 20:50:27 +0800
On Tue, Jun 12, 2012 at 4:21 AM, Thomas Jarosch
<thomas.jarosch@xxxxxxxxxxxxx> wrote:
>
> I propose the following changes for libftdi 1.x
> ------------------------------------------------------------
> - libftdi-config -> libftdi-1.0-config
> - ftdi.h -> /usr/include/ftdi-1.0.h

Could it be libftdi-1.0/ftdi.h? The benefit is that the
older source codes do not need to change, just
need to change the include directory (CFLAGS)
and the linking option (LDFLAGS). This is especially
easy if the software is using pkg-config.

But the downside is potential confusions caused.

> - libftdi.pc -> libftdi-1.0.pc (pkgconfig file). Also "libftdipp-1.0.pc"
> - we can't do much about possible man page clashes.
>  You can't prefix them in doxygen, just redirect
>  the output to a non-default directory
> - Rename "libftdi.spec" to "libftdi-1.0.spec"
> ------------------------------------------------------------
>
> Now the big question: Should we also change the library name to "libftdi-1.0"?
> IMHO it's a good idea since broken linker flags might point to the previous
> libftdi 0.1 and result in very bogus error messages.

I think this is a good idea.

> The "-X.0" suffix is used by several projects like libxml2 or glib2.
> It will stay at "-1.0" if we increase the official version f.e. to 1.5.
> I'm not fixed on the "-X.0", I just want -any- suffix to be in there.
> We could also go for "libftdi1" instead of "libftdi-1.0".

I kind of like libftdi1 than libftdi-1.0.

> Distributions could also offer a "libftdi1-compat" package which
> provides symbolic links from the libftdi 0.x file locations to 1.x
> if libftdi-devel from 0.x is not installed in parallel.
> The APIs should be mostly compatible.
>
> Opinions? Better ideas?
>



-- 
Xiaofan

--
libftdi - see http://www.intra2net.com/en/developer/libftdi for details.
To unsubscribe send a mail to libftdi+unsubscribe@xxxxxxxxxxxxxxxxxxxxxxx

Current Thread