| | [ Return to Bugs & Features | Roadmap 1.1 | SVN ⇄ GIT ]
STR #1718
| Application: | FLTK Library |
|---|
| Status: | 1 - Closed w/Resolution |
|---|
| Priority: | 2 - Low, e.g. a documentation error or undocumented side-effect |
|---|
| Scope: | 3 - Applies to all machines and operating systems |
|---|
| Subsystem: | Documentation |
|---|
| Summary: | FLTK "Basics intro" docs should cover begin() and end() |
|---|
| Version: | 1.1-current |
|---|
| Created By: | greg.ercolano |
|---|
| Assigned To: | matt |
|---|
| Fix Version: | 1.1-current (SVN: v5944) |
|---|
| Update Notification: | |
|---|
Trouble Report Files:
No files
Trouble Report Comments:
| |
| #1 | greg.ercolano
13:02 Jun 27, 2007 |
| It's been brought up on the group that there's insufficient coverage
of FLTK's begin() end() in the basic docs for new users.
It seems the concept of begin() and end() is a confusing one for new users, so it really should be covered right up front in the intro docs,
specifically here:
http://fltk.org/documentation.php/doc-1.1/basics.html#3_1 | |
| |
| #2 | wilson.afn
14:03 Jun 27, 2007 |
| I am pathetically bad at reading documentation, yet somehow I managed to glean this tidbit. I think I stayed with Fluid for a good long while, and thus didn't have to learn it until much later on.
I'm not sure you want *too* much detail here because the introduction will quickly become intimidating with definitions of widget trees and children and parents and other scary stuff.
How about after "...creates a window:
Fl_Window *window = new Fl_Window(300,180);"
Add/change the sentences:
Any widgets the program creates from now on will belong to this window; they will be positioned with respect to the upper-left corner of the window.
Now, the program creates a box to go into the window with the "Hello Hello, World!" string in it: ...
Then, break out the "window->end();", and describe it:
The program tells the window no more widgets are forthcoming. (See Fl_Group::begin() and Fl_Group::end() for further details.) <- here with appropriate links. | |
| |
| #3 | matt
10:54 Oct 06, 2007 |
| Fixed in Subversion repository. | |
[ Return to Bugs & Features ]
|
| |
