[hafqa] [hafqa] [Bug 863] New: HildonFindToolbar documentation seems unfinished.

[From: bugzilla-daemon at maemo.org]

https://maemo.org/bugzilla/show_bug.cgi?id=863

           Summary: HildonFindToolbar documentation seems unfinished.
           Product: haf
           Version: sardine
          Platform: All
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: hildon-libs
        AssignedTo: michael.kostrzewa at nokia.com
        ReportedBy: murrayc at murrayc.com
         QAContact: hafqa at maemo.org


The SECTION: documentation for HildonFindToolbar seems particularly bad:

 * HildonFindToolbar is a predefined toolbar for text searching purpose. 
 * It contains a GtkListStore which has the text items that the user has 
 * searched. But once the application is terminated, or HildonFindToolbar 
 * is trashed. Programmer is responsible for getting the GtkListStore through 
 * property "list", if he/she wants to use the information in the future.
 * And through the same property, programmer is able to set the GtkListStore. 
 * Note, once the search button is pressed, string in the GtkComboxEntry is 
 * automatically added to the existing model, unless it is empty.

"But once the application is terminated, or HildonFindToolbar is trashed" seems
like an unfinished sentence. I wonder what it's trying to tell me. As for the
rest, a few more uses of "the" and "a" would make it more readable.

I strongly encourage you to have native English speakers proof-read the
documentation if possible.

-- 
Configure bugmail: https://maemo.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug, or are watching the QA contact.