src/frontends/controllers/README

   1 This directory provides the controllers that act as an interface between the
   2 LyX kernel and the GUI-specific implementations of each popup. It also
   3 provides abstract base classes from which GUI-specific implemetations of the
   4 ButtonController and each separate popup should be derived (see
   5 ButtonControlBase.[Ch] and ViewBase.h respectively).
   6
   7 The Controller connects the GUI-specific popup to any appropriate signals and
   8 dispatches any changes in the data to the kernel. It has no knowledge of the
   9 actual instantiation of the GUI-dependent View and ButtonController, which
  10 should therefore be created elsewhere. Once created, the Controller will take
  11 care of their initialisation, management and, ultimately, destruction.
  12
  13 This leaves the GUI-specific popup (and its author!) to worry only about the
  14 data that it has been created to input/modify.
  15
  16 This concept has been instatiated for the Citation dialog only at the moment.
  17 See xforms-new/FormCitation.[Ch] for an xforms-specific View of the dialog.