Author: greg.ercolano
Date: 2010-08-26 06:52:02 -0700 (Thu, 26 Aug 2010)
New Revision: 7692
Log:
Small README mods
Modified:
branches/branch-1.3/examples/README.examples
Modified: branches/branch-1.3/examples/README.examples
===================================================================
--- branches/branch-1.3/examples/README.examples 2010-08-26 13:32:30 UTC
(rev 7691)
+++ branches/branch-1.3/examples/README.examples 2010-08-26 13:52:02 UTC
(rev 7692)
@@ -15,8 +15,8 @@
o Show simple examples of how to use widgets to new users of FLTK.
- o Show intermediate or advanced examples that show particular
- techniques often misused or hard to document
+ o Show intermediate or advanced examples of techniques often
+ misused or hard to document
o Demonstrate code that are FAQs on the newsgroup forum.
(such as how to use threads, callbacks, etc)
@@ -31,13 +31,10 @@
These programs must follow FLTK coding style as defined in the FLTK
"CMP" (Configuration Management Plan/Coding Standards).
- Example code should demonstrate recommended techniques the FLTK
- developers think application programmers should use in their own
- applications.
+ Example code should have the above goals in mind. The best examples
+ are those that are as short and clear as possible; terse, but not
+ at the expense of clarity.
- The best examples are those that are as short and clear as possible;
- terse, but not at the expense of clarity.
-
To avoid cluttering up the top level directory with ancillary files
(such as image files or icons), examples that depend on more than
just a .cxx/.h file pair should have their own subdirectory.
@@ -49,12 +46,12 @@
distribution tar files small. Avoid high resolution images or
uncompressed images when possible.
- Examples that need very large data sets should not be part of the
- FLTK distribution; they can be provided as separate packages
- (eg. as articles or external links).
+ Examples that need large data sets (HD images, etc) should not
+ be part of the FLTK distribution; they can be provided as separate
+ packages (eg. as articles or external links).
- Some widgets have multiple common uses that are best demonstrated
- separately. For instance, the table widget can be used as a
+ Some widgets have multiple capabilities that are best demonstrated
+ separately. For instance, the table widget can be used as a
custom data table, or as a spreadsheet, or as a widget container.
So separate examples for each would be e.g. "table-custom-data.cxx",
"table-spreadsheet.cxx", "table-widget-container.cxx", etc.
_______________________________________________
fltk-commit mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-commit
