rabbit 0.6.2

data/entities/mmlextra.ent

@@ -0,0 +1,122 @@
+
+<!--
+     File mmlextra.ent produced by the XSL script characters.xsl
+     from input data in unicode.xml.
+
+     Please report any errors to David Carlisle
+     via the public W3C list www-math@w3.org.
+
+     The numeric character values assigned to each entity
+     (should) match the Unicode assignments in Unicode 4.0.
+
+-->
+
+<!ENTITY % plane1D  "&#38;#38;#x1D">
+
+<!ENTITY af               "&#x02061;" ><!--character showing function application in presentation tagging -->
+<!ENTITY aopf             "%plane1D;552;" ><!-- -->
+<!ENTITY asympeq          "&#x0224D;" ><!--Old ISOAMSR asymp (for HTML compatibility) -->
+<!ENTITY bopf             "%plane1D;553;" ><!-- -->
+<!ENTITY copf             "%plane1D;554;" ><!-- -->
+<!ENTITY Cross            "&#x02A2F;" ><!--cross or vector product -->
+<!ENTITY DD               "&#x02145;" ><!--D for use in differentials, e.g., within integrals -->
+<!ENTITY dd               "&#x02146;" ><!--d for use in differentials, e.g., within integrals -->
+<!ENTITY dopf             "%plane1D;555;" ><!-- -->
+<!ENTITY DownArrowBar     "&#x02913;" ><!--down arrow to bar -->
+<!ENTITY DownBreve        " &#x00311;" ><!--breve, inverted (non-spacing) -->
+<!ENTITY DownLeftRightVector "&#x02950;" ><!--left-down-right-down harpoon -->
+<!ENTITY DownLeftTeeVector "&#x0295E;" ><!--left-down harpoon from bar -->
+<!ENTITY DownLeftVectorBar "&#x02956;" ><!--left-down harpoon to bar -->
+<!ENTITY DownRightTeeVector "&#x0295F;" ><!--right-down harpoon from bar -->
+<!ENTITY DownRightVectorBar "&#x02957;" ><!--right-down harpoon to bar -->
+<!ENTITY ee               "&#x02147;" ><!--e use for the exponential base of the natural logarithms -->
+<!ENTITY EmptySmallSquare "&#x025FB;" ><!--empty small square -->
+<!ENTITY EmptyVerySmallSquare "&#x025AB;" ><!--empty small square -->
+<!ENTITY eopf             "%plane1D;556;" ><!-- -->
+<!ENTITY Equal            "&#x02A75;" ><!--two consecutive equal signs -->
+<!ENTITY FilledSmallSquare "&#x025FC;" ><!--filled small square -->
+<!ENTITY FilledVerySmallSquare "&#x025AA;" ><!--filled very small square -->
+<!ENTITY fopf             "%plane1D;557;" ><!-- -->
+<!ENTITY gopf             "%plane1D;558;" ><!-- -->
+<!ENTITY GreaterGreater   "&#x02AA2;" ><!--alias for GT -->
+<!ENTITY Hat              "&#x0005E;" ><!--circumflex accent -->
+<!ENTITY hopf             "%plane1D;559;" ><!-- -->
+<!ENTITY HorizontalLine   "&#x02500;" ><!--short horizontal line  -->
+<!ENTITY ic               "&#x02063;" ><!--short form of  &InvisibleComma; -->
+<!ENTITY ii               "&#x02148;" ><!--i for use as a square root of -1 -->
+<!ENTITY iopf             "%plane1D;55A;" ><!-- -->
+<!ENTITY it               "&#x02062;" ><!--marks multiplication when it is understood without a mark -->
+<!ENTITY jopf             "%plane1D;55B;" ><!-- -->
+<!ENTITY kopf             "%plane1D;55C;" ><!-- -->
+<!ENTITY larrb            "&#x021E4;" ><!--leftwards arrow to bar -->
+<!ENTITY LeftDownTeeVector "&#x02961;" ><!--down-left harpoon from bar -->
+<!ENTITY LeftDownVectorBar "&#x02959;" ><!--down-left harpoon to bar -->
+<!ENTITY LeftRightVector  "&#x0294E;" ><!--left-up-right-up harpoon -->
+<!ENTITY LeftTeeVector    "&#x0295A;" ><!--left-up harpoon from bar -->
+<!ENTITY LeftTriangleBar  "&#x029CF;" ><!--left triangle, vertical bar -->
+<!ENTITY LeftUpDownVector "&#x02951;" ><!--up-left-down-left harpoon -->
+<!ENTITY LeftUpTeeVector  "&#x02960;" ><!--up-left harpoon from bar -->
+<!ENTITY LeftUpVectorBar  "&#x02958;" ><!--up-left harpoon to bar -->
+<!ENTITY LeftVectorBar    "&#x02952;" ><!--left-up harpoon to bar -->
+<!ENTITY LessLess         "&#x02AA1;" ><!--alias for Lt -->
+<!ENTITY lopf             "%plane1D;55D;" ><!-- -->
+<!ENTITY mapstodown       "&#x021A7;" ><!--downwards arrow from bar -->
+<!ENTITY mapstoleft       "&#x021A4;" ><!--leftwards arrow from bar -->
+<!ENTITY mapstoup         "&#x021A5;" ><!--upwards arrow from bar -->
+<!ENTITY MediumSpace      "&#x0205F;" ><!--space of width 4/18 em -->
+<!ENTITY mopf             "%plane1D;55E;" ><!-- -->
+<!ENTITY nbump            "&#x0224E;&#x00338;" ><!--not bumpy equals -->
+<!ENTITY nbumpe           "&#x0224F;&#x00338;" ><!--not bumpy single equals -->
+<!ENTITY nesim            "&#x02242;&#x00338;" ><!--not equal or similar -->
+<!ENTITY NewLine          "&#x0000A;" ><!--force a line break; line feed -->
+<!ENTITY NoBreak          "&#x02060;" ><!--never break line here -->
+<!ENTITY nopf             "%plane1D;55F;" ><!-- -->
+<!ENTITY NotCupCap        "&#x0226D;" ><!--alias for &nasymp; -->
+<!ENTITY NotHumpEqual     "&#x0224F;&#x00338;" ><!--alias for &nbumpe; -->
+<!ENTITY NotLeftTriangleBar "&#x029CF;&#x00338;" ><!--not left triangle, vertical bar -->
+<!ENTITY NotNestedGreaterGreater "&#x02AA2;&#x00338;" ><!--not double greater-than sign -->
+<!ENTITY NotNestedLessLess "&#x02AA1;&#x00338;" ><!--not double less-than sign -->
+<!ENTITY NotRightTriangleBar "&#x029D0;&#x00338;" ><!--not vertical bar, right triangle -->
+<!ENTITY NotSquareSubset  "&#x0228F;&#x00338;" ><!--square not subset -->
+<!ENTITY NotSquareSuperset "&#x02290;&#x00338;" ><!--negated set-like partial order operator -->
+<!ENTITY NotSucceedsTilde "&#x0227F;&#x00338;" ><!--not succeeds or similar -->
+<!ENTITY oopf             "%plane1D;560;" ><!-- -->
+<!ENTITY OverBar          "&#x000AF;" ><!--over bar -->
+<!ENTITY OverBrace        "&#x0FE37;" ><!--over brace  -->
+<!ENTITY OverBracket      "&#x023B4;" ><!--over bracket -->
+<!ENTITY OverParenthesis  "&#x0FE35;" ><!--over parenthesis -->
+<!ENTITY planckh          "&#x0210E;" ><!--the ring (skew field) of quaternions -->
+<!ENTITY popf             "%plane1D;561;" ><!-- -->
+<!ENTITY Product          "&#x0220F;" ><!--alias for &prod; -->
+<!ENTITY qopf             "%plane1D;562;" ><!-- -->
+<!ENTITY rarrb            "&#x021E5;" ><!--leftwards arrow to bar -->
+<!ENTITY RightDownTeeVector "&#x0295D;" ><!--down-right harpoon from bar -->
+<!ENTITY RightDownVectorBar "&#x02955;" ><!--down-right harpoon to bar -->
+<!ENTITY RightTeeVector   "&#x0295B;" ><!--right-up harpoon from bar -->
+<!ENTITY RightTriangleBar "&#x029D0;" ><!--vertical bar, right triangle -->
+<!ENTITY RightUpDownVector "&#x0294F;" ><!--up-right-down-right harpoon -->
+<!ENTITY RightUpTeeVector "&#x0295C;" ><!--up-right harpoon from bar -->
+<!ENTITY RightUpVectorBar "&#x02954;" ><!--up-right harpoon to bar -->
+<!ENTITY RightVectorBar   "&#x02953;" ><!--up-right harpoon to bar -->
+<!ENTITY ropf             "%plane1D;563;" ><!-- -->
+<!ENTITY RoundImplies     "&#x02970;" ><!--round implies -->
+<!ENTITY RuleDelayed      "&#x029F4;" ><!--rule-delayed (colon right arrow) -->
+<!ENTITY sopf             "%plane1D;564;" ><!-- -->
+<!ENTITY Tab              "&#x00009;" ><!--tabulator stop; horizontal tabulation -->
+<!ENTITY ThickSpace       "&#x02009;&#x0200A;&#x0200A;" ><!--space of width 5/18 em -->
+<!ENTITY topf             "%plane1D;565;" ><!-- -->
+<!ENTITY UnderBar         " &#x00332;" ><!--combining low line -->
+<!ENTITY UnderBrace       "&#x0FE38;" ><!--under brace  -->
+<!ENTITY UnderBracket     "&#x023B5;" ><!--under bracket -->
+<!ENTITY UnderParenthesis "&#x0FE36;" ><!--under parenthesis -->
+<!ENTITY uopf             "%plane1D;566;" ><!-- -->
+<!ENTITY UpArrowBar       "&#x02912;" ><!--up arrow to bar -->
+<!ENTITY Upsilon          "&#x003A5;" ><!--ISOGRK1 Ugr, HTML4 Upsilon -->
+<!ENTITY VerticalLine     "&#x0007C;" ><!--alias ISONUM verbar -->
+<!ENTITY VerticalSeparator "&#x02758;" ><!--vertical separating operator -->
+<!ENTITY vopf             "%plane1D;567;" ><!-- -->
+<!ENTITY wopf             "%plane1D;568;" ><!-- -->
+<!ENTITY xopf             "%plane1D;569;" ><!-- -->
+<!ENTITY yopf             "%plane1D;56A;" ><!-- -->
+<!ENTITY ZeroWidthSpace   "&#x0200B;" ><!--zero width space -->
+<!ENTITY zopf             "%plane1D;56B;" ><!-- -->

data/lib/rabbit/action.rb

@@ -0,0 +1,143 @@
+require 'gtk2'
+
+module Gtk
+  class Action
+    alias _activate activate
+    def activate(&block)
+      @block = block
+      _activate
+    ensure
+      @block = nil
+    end
+
+    def block_given?
+      not @block.nil?
+    end
+
+    def call(*args, &block)
+      @block.call(*args, &block)
+    end
+  end
+end
+
+require 'rabbit/rabbit'
+require 'rabbit/stock'
+require 'rabbit/utils'
+
+module Rabbit
+  module Action
+    extend Utils
+    extend GetText
+
+    @@actions = []
+    @@toggle_actions = []
+    @@radio_actions = []
+    @@update_status_methods = []
+    class << self
+      def method_added(name)
+        case name.to_s
+        when /_config$/
+          # ignore
+        when /^act_(radio_.+)$/
+          @@radio_actions << [Utils.to_class_name($1), name]
+        when /^act_(toggle_.+)$/
+          @@toggle_actions << [Utils.to_class_name($1), name]
+        when /^act_(.+)$/
+          @@actions << [Utils.to_class_name($1), name]
+        when /^update_(.+)_status$/
+          @@update_status_methods << name
+        end
+      end
+
+      def action_group(canvas, name="Rabbit")
+        Stock.init(canvas)
+        group = Gtk::ActionGroup.new(name)
+        group.set_translate_func(&GetText.method(:_))
+        group.add_actions(to_gtk_actions(@@actions, canvas))
+        actions = to_gtk_actions(@@toggle_actions, canvas, true)
+        group.add_toggle_actions(actions)
+        add_radio_actions(group, @@radio_actions, canvas)
+        group
+      end
+
+      def update_status(canvas)
+        @@update_status_methods.each do |method|
+          __send__(method, canvas)
+        end
+      end
+
+      private
+      def to_gtk_actions(actions, canvas, toggle=false)
+        actions.collect do |name, action|
+          config = {:label => name}
+          config_method = "#{action}_config"
+          __send__(config_method, config, canvas) if respond_to?(config_method)
+          callback = method(action)
+          result = [
+            name,
+            config[:stock_id],
+            config[:label],
+            config[:accelerator],
+            config[:tooltip],
+            Proc.new do |group, act|
+              guard(canvas) do
+                callback.call(act, group, canvas)
+              end
+            end
+          ]
+          result << config[:is_active] if toggle
+          result
+        end
+      end
+
+      def add_radio_actions(group, actions, canvas)
+        actions.each do |name, action|
+          default_value = nil
+          gtk_actions = methods(false).find_all do |method_name|
+            /^#{action}_(?:.+)_config$/ =~ method_name
+          end.collect do |config_method|
+            /^act_(.*)_config$/ =~ config_method
+            action_name = Utils.to_class_name($1)
+            config = {:label => action_name}
+            __send__(config_method, config, canvas)
+            default_value = config[:value] if config[:default]
+            [
+              action_name,
+              config[:stock_id],
+              config[:label],
+              config[:accelerator],
+              config[:tooltip],
+              config[:value],
+            ]
+          end
+
+          callback = method(action)
+          group.add_radio_actions(gtk_actions, default_value) do |act, current|
+            guard(canvas) do
+              callback.call(act, current, group, canvas)
+            end
+          end
+        end
+      end
+
+      def guard(canvas)
+        begin
+          yield
+        rescue Exception
+          canvas.logger.warn($!)
+        end
+      end
+    end
+
+    dir = ::File.join("rabbit", "action")
+    require_files_under_directory_in_load_path(dir)
+
+    module_function
+    def update_processing_action_status(canvas)
+      canvas.action("ToggleIndexMode").sensitive = !canvas.processing?
+      canvas.action("CacheAllSlides").sensitive = !canvas.processing?
+      canvas.action("SaveAsImage").sensitive = !canvas.processing?
+      canvas.action("Print").sensitive = !canvas.processing?
+    end
+  end
+end

data/lib/rabbit/action/basic.rb

@@ -0,0 +1,304 @@
+module Rabbit
+  module Action
+    module_function
+    def act_next(action, group, canvas)
+      canvas.move_to_next_if_can
+    end
+    def act_next_config(config, canvas)
+      config[:label] = N_("Next")
+      config[:stock_id] = Gtk::Stock::GO_FORWARD
+    end
+
+    def act_previous(action, group, canvas)
+      canvas.move_to_previous_if_can
+    end
+    def act_previous_config(config, canvas)
+      config[:label] = N_("Previous")
+      config[:stock_id] = Gtk::Stock::GO_BACK
+    end
+
+    def act_next_slide(action, group, canvas)
+      canvas.move_to_next_slide_if_can
+    end
+    def act_next_slide_config(config, canvas)
+      config[:label] = N_("Next slide")
+      config[:stock_id] = Gtk::Stock::GO_FORWARD
+    end
+
+    def act_previous_slide(action, group, canvas)
+      canvas.move_to_previous_slide_if_can
+    end
+    def act_previous_slide_config(config, canvas)
+      config[:label] = N_("Previous slide")
+      config[:stock_id] = Gtk::Stock::GO_BACK
+    end
+
+    def act_first_slide(action, group, canvas)
+      canvas.move_to_first
+    end
+    def act_first_slide_config(config, canvas)
+      config[:label] = N_("First slide")
+      config[:stock_id] = Gtk::Stock::GOTO_FIRST
+    end
+
+    def act_last_slide(action, group, canvas)
+      canvas.move_to_last
+    end
+    def act_last_slide_config(config, canvas)
+      config[:label] = N_("Last slide")
+      config[:stock_id] = Gtk::Stock::GOTO_LAST
+    end
+
+    def act_jump_to(action, group, canvas)
+      if action.block_given?
+        canvas.move_to_if_can(action.call(action, group, canvas))
+      end
+    end
+    def act_jump_to_config(config, canvas)
+      config[:label] = N_("Jump to")
+      config[:stock_id] = Gtk::Stock::JUMP_TO
+    end
+
+    def update_move_slide_action_status(canvas)
+      canvas.action("Previous").sensitive = canvas.have_previous?
+      canvas.action("Next").sensitive = canvas.have_next?
+      canvas.action("PreviousSlide").sensitive = canvas.have_previous_slide?
+      canvas.action("NextSlide").sensitive = canvas.have_next_slide?
+      canvas.action("FirstSlide").sensitive = !canvas.first_slide?
+      canvas.action("LastSlide").sensitive = !canvas.last_slide?
+    end
+
+    def act_save_as_image(action, group, canvas)
+      canvas.save_as_image
+    end
+    def act_save_as_image_config(config, canvas)
+      config[:label] = N_("Save as image")
+      config[:stock_id] = Gtk::Stock::SAVE
+    end
+
+    def act_print(action, group, canvas)
+      canvas.print
+    end
+    def act_print_config(config, canvas)
+      config[:label] = N_("Print")
+      config[:stock_id] = Gtk::Stock::PRINT
+    end
+
+    def act_iconify(action, group, canvas)
+      canvas.iconify
+    end
+    def act_iconify_config(config, canvas)
+      config[:label] = N_("Iconify")
+      config[:stock_id] = Stock::RABBIT
+    end
+
+    def act_change_theme(action, group, canvas)
+      if action.block_given?
+        entry, block = action.call(action, group, canvas)
+        canvas.apply_theme(entry.name, &block)
+      end
+    end
+    def act_change_theme_config(config, canvas)
+      config[:label] = N_("Change theme")
+    end
+
+    def act_merge_theme(action, group, canvas)
+      if action.block_given?
+        entry, block = action.call(action, group, canvas)
+        canvas.merge_theme(entry.name, &block)
+      end
+    end
+    def act_merge_theme_config(config, canvas)
+      config[:label] = N_("Merge theme")
+    end
+
+    def act_reload_theme(action, group, canvas)
+      block = nil
+      block = action.call(action, group, canvas) if action.block_given?
+      canvas.reload_theme(&block)
+    end
+    def act_reload_theme_config(config, canvas)
+      config[:label] = N_("Reload theme")
+      config[:stock_id] = Gtk::Stock::REFRESH
+    end
+
+    def act_redraw(action, group, canvas)
+      canvas.redraw
+    end
+    def act_redraw_config(config, canvas)
+      config[:label] = N_("Redraw")
+      config[:stock_id] = Gtk::Stock::REFRESH
+    end
+
+    def act_clear_slide(action, group, canvas)
+      canvas.clear_slide
+    end
+    def act_clear_slide_config(config, canvas)
+      config[:label] = N_("Clear slide")
+      config[:stock_id] = Gtk::Stock::CLEAR
+    end
+
+    def update_theme_action_status(canvas)
+      not_applying = !canvas.applying?
+      canvas.action("ReloadTheme").sensitive = not_applying
+      canvas.action("ChangeTheme").sensitive = not_applying
+      canvas.action("MergeTheme").sensitive = not_applying
+      canvas.action("CacheAllSlides").sensitive = not_applying
+      canvas.action("ToggleFullScreen").sensitive = not_applying
+    end
+
+    @@quit_label = N_("_Quit")
+    @@quit_with_confirmation_label = N_("_Quit with confirmation")
+    def quit_action_label(canvas)
+      canvas.processing? ? @@quit_with_confirmation_label : @@quit_label
+    end
+    
+    def act_quit(action, group, canvas)
+      if !canvas.processing? or
+          canvas.confirm(_("Now processing... Do you really quit?"))
+        canvas.quit
+      end
+    end
+    def act_quit_config(config, canvas)
+      config[:label] = quit_action_label(canvas)
+      config[:stock_id] = Gtk::Stock::QUIT
+    end
+
+    def update_quit_action_status(canvas)
+      canvas.action("Quit").label = _(quit_action_label(canvas))
+    end
+
+    def act_cache_all_slides(action, group, canvas)
+      canvas.cache_all_slides
+    end
+    def act_cache_all_slides_config(config, canvas)
+      config[:label] = N_("Cache all slides")
+    end
+
+    def act_graffiti(action, group, canvas)
+      update_graffiti_action_status(canvas)
+    end
+    def act_graffiti_config(config, canvas)
+      config[:label] = N_("Graffiti")
+      config[:stock_id] = Gtk::Stock::EDIT
+    end
+
+    def act_clear_graffiti(action, group, canvas)
+      canvas.clear_graffiti
+    end
+    def act_clear_graffiti_config(config, canvas)
+      config[:label] = N_("Clear graffiti")
+      config[:stock_id] = Gtk::Stock::CLEAR
+    end
+
+    def act_undo_graffiti(action, group, canvas)
+      canvas.undo_graffiti
+    end
+    def act_undo_graffiti_config(config, canvas)
+      config[:label] = N_("Undo graffiti")
+      config[:stock_id] = Gtk::Stock::UNDO
+    end
+
+    def act_change_graffiti_color(action, group, canvas)
+      canvas.change_graffiti_color
+    end
+    def act_change_graffiti_color_config(config, canvas)
+      config[:label] = N_("Change graffiti color")
+      config[:stock_id] = Gtk::Stock::SELECT_COLOR
+    end
+
+    def update_graffiti_action_status(canvas)
+      graffiti_available = canvas.graffiti_mode? || canvas.have_graffiti?
+      canvas.action("Graffiti").sensitive = graffiti_available
+      #canvas.action("ClearGraffiti").sensitive = canvas.have_graffiti?
+      #canvas.action("UndoGraffiti").sensitive = canvas.can_undo_graffiti?
+      canvas.action("ClearGraffiti").sensitive = graffiti_available
+      canvas.action("UndoGraffiti").sensitive = graffiti_available
+      canvas.action("ChangeGraffitiColor").sensitive = graffiti_available
+    end
+
+    def act_reset_adjustment(action, group, canvas)
+      canvas.reset_adjustment
+    end
+    def act_reset_adjustment_config(config, canvas)
+      config[:label] = N_("Reset adjustment")
+      config[:stock_id] = Gtk::Stock::CLEAR
+    end
+
+    def act_reset_timer(action, group, canvas)
+      canvas.reset_timer
+    end
+    def act_reset_timer_config(config, canvas)
+      config[:label] = N_("Reset timer")
+      config[:stock_id] = Gtk::Stock::CLEAR
+    end
+
+    def act_expand_hole(action, group, canvas)
+      canvas.expand_hole
+    end
+    def act_expand_hole_config(config, canvas)
+      config[:label] = N_("Expand hole")
+    end
+
+    def act_narrow_hole(action, group, canvas)
+      canvas.narrow_hole
+    end
+    def act_narrow_hole_config(config, canvas)
+      config[:label] = N_("Narrow hole")
+    end
+
+    def act_search_slide_forward(action, group, canvas)
+      canvas.search_slide(true)
+      update_saarch_action_status(canvas)
+    end
+    def act_search_slide_forward_config(config, canvas)
+      config[:label] = N_("Search slide forward")
+    end
+
+    def act_search_slide_backward(action, group, canvas)
+      canvas.search_slide(false)
+      update_saarch_action_status(canvas)
+    end
+    def act_search_slide_backward_config(config, canvas)
+      config[:label] = N_("Search slide backward")
+    end
+
+    def act_search_slide_forward_next(action, group, canvas)
+      canvas.search_slide(true)
+      update_saarch_action_status(canvas)
+    end
+    def act_search_slide_forward_next_config(config, canvas)
+      config[:label] = N_("Search slide forward next")
+    end
+
+    def act_search_slide_backward_next(action, group, canvas)
+      canvas.search_slide(false)
+      update_saarch_action_status(canvas)
+    end
+    def act_search_slide_backward_next_config(config, canvas)
+      config[:label] = N_("Search slide backward next")
+    end
+
+    def act_stop_slide_search(action, group, canvas)
+      canvas.stop_slide_search
+      update_saarch_action_status(canvas)
+    end
+    def act_stop_slide_search_config(config, canvas)
+      config[:label] = N_("Stop slide search")
+    end
+
+    def update_saarch_action_status(canvas)
+      canvas.action("SearchSlideForward").sensitive = !canvas.searching?
+      canvas.action("SearchSlideBackward").sensitive = !canvas.searching?
+      canvas.action("SearchSlideForwardNext").sensitive = canvas.searching?
+      canvas.action("SearchSlideBackwardNext").sensitive = canvas.searching?
+      canvas.action("StopSlideSearch").sensitive = canvas.searching?
+    end
+
+    def act_log_level(action, group, canvas)
+    end
+    def act_log_level_config(config, canvas)
+      config[:label] = N_("Log Level")
+    end
+  end
+end