Doc-es: various updates.

[lilypond.git] / lily / change-iterator.cc

diff --git a/lily/change-iterator.cc b/lily/change-iterator.cc
index 883e963e9f3d29b00a62c96f353c5bddd8fa5b6d..f70c2da47fcdd94410c1b1da34640cb403d9fc54 100644 (file)
--- a/lily/change-iterator.cc
+++ b/lily/change-iterator.cc
@@ -1,81 +1,99 @@
 /*
-  change-iterator.cc -- implement Change_iterator
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 1997 Han-Wen Nienhuys <hanwen@stack.nl>
+  LilyPond is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  LilyPond is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
 */
 
 #include "change-iterator.hh"
-#include "translator-group.hh"
-#include "change-translator.hh"
-#include "debug.hh"
 
-Change_iterator::Change_iterator (Change_translator *change_l)
-{
-  change_l_ = change_l;
-}
+#include "context.hh"
+#include "input.hh"
+#include "international.hh"
+#include "music.hh"
+#include "warn.hh"
 
 void
-Change_iterator::error (String reason)
+Change_iterator::error (const string &reason)
 {
-  String to_type = change_l_->change_to_type_str_;
-  String to_id =  change_l_->change_to_id_str_;
-
-  String warn1 = 
-    _ ("Can't change ") + to_type 
-    + _(" to ") + "`" + to_id + "\': " + reason;
-  String warn2= "Change_iterator::process_and_next (): " + report_to_l ()->type_str_ + " = `"
-    + report_to_l ()->id_str_ + "\': ";
+  string to_type = ly_symbol2string (get_music ()->get_property ("change-to-type"));
+  string to_id = ly_scm2string (get_music ()->get_property ("change-to-id"));
+
+  string warn1 = _f ("cannot change `%s' to `%s'", to_type, to_id)
+                 + ": " + reason;
+
+  /*
+    GUHG!
+  */
+  string warn2 = "Change_iterator::process (): "
+                 + get_outlet ()->context_name () + " = `"
+                 + get_outlet ()->id_string () + "': ";
   warning (warn2);
-  change_l_->warning (warn1);
+  get_music ()->origin ()->warning (warn1);
+}
+
+string
+Change_iterator::change_to (Music_iterator &it,
+                            SCM to_type,
+                            const string &to_id)
+{
+  string result; // error message
+
+  // Find the context that should have its parent changed.
+  Context *last = find_context_above_by_parent_type (it.get_outlet (), to_type);
+  if (last)
+    {
+      // Find the new parent.
+      Context *dest = find_context_near (it.get_outlet (), to_type, to_id);
+      if (dest)
+        {
+          send_stream_event (last, "ChangeParent", it.get_music ()->origin (),
+                             ly_symbol2scm ("context"), dest->self_scm ());
+        }
+      else
+        /* FIXME: constant error message.  */
+        it.get_music ()->origin ()->warning (_ ("cannot find context to switch to"));
+    }
+  else if (it.get_outlet ()->is_alias (to_type))
+    {
+      // No enclosing context of the right kind was found
+      // and the iterator's immediate context is the kind that was sought.
+
+      result = _f ("not changing to same context type: %s", ly_symbol2string (to_type).c_str ());
+    }
+  else
+    /* FIXME: incomprehensible message */
+    result = _ ("none of these in my family");
+
+  return result;
 }
 
 /*
   move to construct_children ?
- */
+*/
 void
-Change_iterator::process_and_next (Moment m)
+Change_iterator::process (Moment m)
 {
-  Translator_group * current = report_to_l ();
-  Translator_group * last = 0;
+  SCM to_type = get_music ()->get_property ("change-to-type");
+  string to_id = ly_scm2string (get_music ()->get_property ("change-to-id"));
 
-  String to_type = change_l_->change_to_type_str_;
-  String to_id =  change_l_->change_to_id_str_;
+  string msg = change_to (*this, to_type, to_id);
+  if (!msg.empty ())
+    error (msg);
 
-  /* find the type  of translator that we're changing.
-     
-     If \translator Staff = bass, then look for Staff = *
-   */
-  while  (current && current->type_str_ != to_type)
-    {
-      last = current;
-      current = current->daddy_trans_l_;
-    }
-  
-  
-  if (current) 
-    if (last)
-      {
-       Translator_group * dest = 
-         report_to_l ()->find_create_translator_l (to_type, to_id);
-       current->remove_translator_p (last);
-       dest->add (last);
-      }
-    else
-      {
-       
-       /*
-         We could change the current translator's id, but that would make 
-         errors hard to catch
-         
-          last->translator_id_str_  = change_l_->change_to_id_str_;
-       */
-       error ("I'm one myself");
-      }
-  else
-    error ("None of these in my family.");
-  Music_iterator::process_and_next (m);
+  Simple_music_iterator::process (m);
 }
 
-IMPLEMENT_IS_TYPE_B1 (Change_iterator, Music_iterator);
+IMPLEMENT_CTOR_CALLBACK (Change_iterator);