Bug#671106: gtkmm-documentation: Inconsistency in Simple Example in chapter-basics.html

[Thomas E. Vaughan]

Package: gtkmm-documentation
Version: 3.4.0-1
Severity: normal

Dear Maintainer,

The example source code for Simple Example in
chapter-basics.html has the line

  Gtk::ApplicationWindow window;

but, below the program listing, the line-by-line description
of the program refers to the same line as

  Gtk::Window window;

Copying the program as written to a text file causes a
run-time error:

  (gtkmm_example:23060): GLib-GIO-CRITICAL **:
  g_application_list_actions: assertion
  `application->priv->is_registered' failed

Changing the program to reflect what appears in the
line-by-line description causes the program to run without
error.

By the way, in the paragraph describing
Application::create(), there are two grammatical errors. One
is the insertion of a comma before an 'and' that joins only
two items. The other is a dangling participial phrase that
begins with 'looking'. These can be corrected by replacing

  The create() method for this object initializes gtkmm, and
  checks the arguments passed to your application on the
  command line, looking for standard options such as
  -display.

with

  The create() method for this object initializes gtkmm,
  checks the arguments passed to your application on the
  command line, and looks for standard options such as
  -display.

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages gtkmm-documentation depends on:
ii  chromium [www-browser]          18.0.1025.151~r130497-1
ii  doc-base                        0.10.3
ii  epiphany-browser [www-browser]  3.4.1-1
ii  iceweasel [www-browser]         10.0.4esr-2
ii  libgtkmm-3.0-doc                3.4.0-2
ii  lynx-cur [www-browser]          2.8.8dev.12-2

Versions of packages gtkmm-documentation recommends:
ii  libglibmm-2.4-doc  2.32.0-1

gtkmm-documentation suggests no packages.

-- no debconf information



This message and any enclosures are intended only for the addressee.  Please 

notify the sender by email if you are not the intended recipient.  If you are 

not the intended recipient, you may not use, copy, disclose, or distribute this 

message or its contents or enclosures to any other person and any such actions 

may be unlawful.  Ball reserves the right to monitor and review all messages 

and enclosures sent to or from this email address.