doxygen comments for undocumented features of Fl_File_Chooser

- needed to use new doxygen comment feature in fluid to provide comments for
  the various static const char* member variables (eg add_favorites_label).
  I had not been able to work out how to add the comments "out-of-code" in
  src/Fl_File_Chooser2.cxx without getting unpredictable end-results.

- needed to add doxygen comments for newButton and previewButton to the
  "out-of-code" comments in src/Fl_File_Chooser2.cxx because the new doxygen
  comment feature in fluid doesn't extend to widget member variables :-(

- added some missing "out-of-code" comments about customization/copying.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6358 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 29 insertions, 14 deletions

diff --git a/src/Fl_File_Chooser.fl b/src/Fl_File_Chooser.fl
index beaef51c8..44f6b6499 100644
--- a/src/Fl_File_Chooser.fl
+++ b/src/Fl_File_Chooser.fl
@@ -379,33 +379,48 @@ else
   } {
     code {return window->visible();} {}
   }
-  decl {static const char *add_favorites_label;} {public
+  decl {static const char *add_favorites_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *all_files_label;} {public
+  decl {static const char *all_files_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *custom_filter_label;} {public
+  decl {static const char *custom_filter_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *existing_file_label;} {public
+  decl {static const char *existing_file_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *favorites_label;} {public
+  decl {static const char *favorites_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *filename_label;} {public
+  decl {static const char *filename_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *filesystems_label;} {public
+  decl {static const char *filesystems_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *manage_favorites_label;} {public
+  decl {static const char *manage_favorites_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *new_directory_label;} {public
+  decl {static const char *new_directory_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *new_directory_tooltip;} {public
+  decl {static const char *new_directory_tooltip;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *preview_label;} {public
+  decl {static const char *preview_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *save_label;} {public
+  decl {static const char *save_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static const char *show_label;} {public
+  decl {static const char *show_label;} {
+    comment {[standard text may be customized at run-time]} public
   }
-  decl {static Fl_File_Sort_F *sort;} {public
+  decl {static Fl_File_Sort_F *sort;} {
+    comment {the sort function that is used when loading
+the contents of a directory.} public
   }
   decl {Fl_Widget* ext_group;} {}
   decl {bool ext_managed;} {}