[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-frameworks-devel
Subject:    Re: Experimental class in baloo
From:       David Edmundson <david () davidedmundson ! co ! uk>
Date:       2018-03-21 0:16:00
Message-ID: CAGeFrHDZE4PmHNSOVyLxz-jCkGCS+oBmeGhL4EJZ311QmzjVZw () mail ! gmail ! com
[Download RAW message or body]

On Tue, Mar 20, 2018 at 9:43 AM, Michael Heidelbach <ottwolt@gmail.com>
wrote:

> Hi!
>
> I've recently introduced a new class for baloo
> <https://cgit.kde.org/baloo.git/commit/?id=9de78becc06346a734279c2dc13d081dc5861624>.
> It is mainly for debugging. As it is accompanied with a command line tool
> it may be useful for users too.
>
> It is still in an experimental state and it's likely I'll wish to change
> the public interface.
>
> 1) Is it possible to mark that class as experimental for some time and
> have the allowance to chance the interface?
>

Once you've exported symbols in the same library as baloo...not really.

> 2) If so, what is the best way to communicate that?
>
If it's purely for debugging, stick it behind some optional CMake
definition so only users who explicitly enable it have the header
installed.


David

[Attachment #3 (text/html)]

<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Mar \
20, 2018 at 9:43 AM, Michael Heidelbach <span dir="ltr">&lt;<a \
href="mailto:ottwolt@gmail.com" target="_blank">ottwolt@gmail.com</a>&gt;</span> \
wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px \
#ccc solid;padding-left:1ex">  

    
  
  <div text="#000000" bgcolor="#FFFFFF">
    <p>Hi!</p>
    <p>I&#39;ve recently introduced <a \
href="https://cgit.kde.org/baloo.git/commit/?id=9de78becc06346a734279c2dc13d081dc5861624" \
target="_blank">a  new class for baloo</a>. It is mainly for debugging. As it is
      accompanied with a command line tool it may be useful for users
      too.<br>
    </p>
    <p>It is still in an experimental state and it&#39;s likely I&#39;ll wish to
      change the public interface.</p>
    <p>1) Is it possible to mark that class as experimental for some
      time and have the allowance to chance the \
interface?</p></div></blockquote><div><br></div><div>Once you&#39;ve exported symbols \
in the same library as baloo...not really.<br></div><blockquote class="gmail_quote" \
style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div \
text="#000000" bgcolor="#FFFFFF">  <p>2) If so, what is the best way to communicate \
that?</p></div></blockquote><div>If it&#39;s purely for debugging, stick it behind \
some optional CMake  definition so only users who explicitly enable it have the \
header  installed. <br></div><div><br></div><div><br></div><div>David<br></div></div><br></div></div>




[prev in list] [next in list] [prev in thread] [next in thread]