From 9c789b0e69d7d2e0502965f48131085ce76488d3 Mon Sep 17 00:00:00 2001
From: engelsman <engelsman>
Date: Tue, 30 Sep 2008 22:22:49 +0000
Subject: 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
---
 src/Fl_File_Chooser.fl | 43 +++++++++++++++++++++++++++++--------------
 1 file changed, 29 insertions(+), 14 deletions(-)

(limited to 'src/Fl_File_Chooser.fl')

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;} {}
-- 
cgit v1.2.3