Start remoulding the Timeline display: mark deprecation (#955)

Mark parts of the timeline state handling which will certainly
not be retained: any part where the GUI widgets "hold" some kind
of model. GUI widgets shall be *mapped upon* a model representation
and *wired* with callbacks.

Especially I am suspicious when GUI presentation code "reaches into"
any kind of model data structure to find out something. It should
be the other way round (dont call us, we call you)

src/gui/panels/timeline-panel.cpp

@@ -241,6 +241,7 @@ TimelinePanel::on_sequence_list_changed()
   update_sequence_chooser();
 }
 
+/** @deprecated for #955 : move this callback \em into the model! */
 void
 TimelinePanel::on_sequence_chosen()
 {

src/gui/widgets/timeline-widget.cpp

@@ -92,12 +92,14 @@ TimelineWidget::~TimelineWidget()
 
 /* ===== Data Access ===== */
 
+/** @deprecated for #955 */
 shared_ptr<timeline::TimelineState>
 TimelineWidget::get_state()
 {
   return state;
 }
 
+/** @deprecated for #955 */
 void
 TimelineWidget::set_state(shared_ptr<timeline::TimelineState> new_state)
 { 
@@ -290,6 +292,7 @@ TimelineWidget::create_timeline_tracks()
   headerContainer->update_headers();
 }
 
+/** @deprecated for #955 */
 void
 TimelineWidget::create_timeline_tracks_from_branch(
   shared_ptr<model::Track> modelTrack)
@@ -311,6 +314,7 @@ TimelineWidget::create_timeline_tracks_from_branch(
     create_timeline_tracks_from_branch(child);
 }
 
+/** @deprecated for #955 */
 shared_ptr<timeline::Track>
 TimelineWidget::create_timeline_track_from_modelTrack(
   shared_ptr<model::Track> modelTrack)
@@ -330,6 +334,7 @@ TimelineWidget::create_timeline_track_from_modelTrack(
   return shared_ptr<timeline::Track>();
 }
 
+/** @deprecated for #955 */
 void
 TimelineWidget::remove_orphaned_tracks()
 {
@@ -353,6 +358,7 @@ TimelineWidget::remove_orphaned_tracks()
     }
 }
 
+/** @deprecated for #955 */
 void
 TimelineWidget::search_orphaned_tracks_in_branch(
     shared_ptr<model::Track> modelTrack,
@@ -371,6 +377,7 @@ TimelineWidget::search_orphaned_tracks_in_branch(
     search_orphaned_tracks_in_branch(child, orphan_track_map);
 }
 
+/** @deprecated for #955 */
 shared_ptr<timeline::Track>
 TimelineWidget::lookup_timeline_track(
   shared_ptr<model::Track> modelTrack) const
@@ -478,6 +485,7 @@ TimelineWidget::on_motion_in_body_notify_event(GdkEventMotion *event)
   return true;
 }
 
+/** @deprecated for #955 */
 shared_ptr<model::Sequence>
 TimelineWidget::sequence() const
 {

src/gui/widgets/timeline-widget.hpp

@@ -242,6 +242,7 @@ protected:
   /**
    * The state that will be used as the data source for this timeline
    * widget.
+   * @deprecated for #955
    */
   shared_ptr<timeline::TimelineState> state;
 
@@ -253,6 +254,7 @@ protected:
    * @remarks The tree structure is maintained by the model, and as the
    * widget is updated with update_tracks, timeline tracks are added and
    * removed from the map in correspondence with the tree.
+   * @deprecated for #955
    */
   std::map<shared_ptr<model::Track>
           ,shared_ptr<timeline::Track> >

src/gui/widgets/timeline/timeline-header-container.hpp

@@ -179,6 +179,7 @@ private:
    * track was found.
    * @remarks If the return value is going to be NULL, an ENSURE will
    * fail.
+   * @deprecated for #955
    */
   shared_ptr<timeline::Track>
   lookup_timeline_track (shared_ptr<model::Track> modelTrack);