← Back to branch summary

~ubuntu-branches/ubuntu/precise/aptitude/precise

« back to all changes in this revision

Viewing changes to src/gtk/views/README

  • Committer: Bazaar Package Importer
  • Author(s): Michael Vogt
  • Date: 2011-06-22 12:32:56 UTC
  • mfrom: (1.8.6 sid)
  • Revision ID: james.westby@ubuntu.com-20110622123256-8aox9w9ch3x72dci
Tags: 0.6.4-1ubuntu1
* Merge from debian unstable.  Remaining changes:
  - debian/05aptitude: never autoremove kernels
  - drop aptitude-doc to Suggests
  - 03_branding.dpatch: ubuntu branding
  - 04_changelog.dpatch: take changelogs from changelogs.ubuntu.com
  - 09_ubuntu_fortify_source.dpatch: Suppress a number of warnings (turned
    into errors by -Werror) triggered by Ubuntu's default of
    -D_FORTIFY_SOURCE=2.
  - 11_ubuntu_uses_sudo.dpatch: fix status line of 'Become root' menu entry
    to not refer to su.
  - 12_point_manpage_to_doc_package.dpatch: point Finnish manpage to the
    correct place for further info
  - 14_html2text_preferred.dpatch: switch back to html2text in favor of
    elinks, since html2text is in main and elinks isn't.
* dropped 01_intltool_update.dpatch
* updated 15_ftbfs_new_apt

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/gtk/views/README
1
 
This directory contains objects that provide "views" onto collections
2
 
of widgets, hiding the concrete widget classes involved.  For
3
 
instance, the search_entry view wraps the widgets used to enter a
4
 
search term and provide feedback to the user.  The view objects are
5
 
normally just aggregates that hold pointers to one or more widgets.
6
 
 
7
 
Code in this directory will normally have at least "controller" class
8
 
in <gtk/controller>, which provides the logic driving the view.  For
9
 
instance, the "search" controller attaches to the "search_input" view
10
 
to parse patterns that the user enters, emitting signals or error
11
 
messages as appropriate.
12
 
 
13
 
The benefits of doing this are:
14
 
 
15
 
  1) Separation of concerns, with explicit documentation of the
16
 
     interface required by each side.
17
 
 
18
 
  2) It allows the program logic to be unit-tested, by providing
19
 
     a non-interactive implementation of the view interface.
20
 
 
21
 
To keep the abstract interfaces free of references to GUI types,
22
 
implementations of these interfaces are located in <gtk/view_impls>.