Add some comments.

diff --git a/src/wx/full_language_tag_dialog.h b/src/wx/full_language_tag_dialog.h
index 1dbdeacb1c323f3d1a3ed5ec0abd746dc2d873b2..08b8c71a3bfb25ca010dc6cd7e1e5276e8d1ee32 100644 (file)
--- a/src/wx/full_language_tag_dialog.h
+++ b/src/wx/full_language_tag_dialog.h
@@ -34,6 +34,9 @@ class wxListCtrl;
 class LanguageSubtagPanel;
 
 
+/** A dialog in which the user can make a full new language tag, made up of
+ *  language, script, region, variant and external.
+ */
 class FullLanguageTagDialog : public wxDialog
 {
 public:

diff --git a/src/wx/language_subtag_panel.h b/src/wx/language_subtag_panel.h
index e5972a92cac8f596ebd6b97bfef6da98c0e82369..6f1b5fd011c81b0952557e9c4cf9d49bb447e2b0 100644 (file)
--- a/src/wx/language_subtag_panel.h
+++ b/src/wx/language_subtag_panel.h
@@ -28,6 +28,9 @@ LIBDCP_ENABLE_WARNINGS
 #include <boost/signals2.hpp>
 
 
+/** A panel which offers a list of subtags in two columns: subtag and name, and has a search box to
+ *  limit the view to a subset.  The list contained within is a SubtagListCtrl.
+ */
 class LanguageSubtagPanel : public wxPanel
 {
 public:

diff --git a/src/wx/language_tag_dialog.h b/src/wx/language_tag_dialog.h
index b9085e97afa4cbb5276382c675a4230f5e56f7f6..34c77666faa2d29e3e5879814f36367ffe5d3342 100644 (file)
--- a/src/wx/language_tag_dialog.h
+++ b/src/wx/language_tag_dialog.h
@@ -33,6 +33,15 @@ LIBDCP_ENABLE_WARNINGS
 class wxListCtrl;
 
 
+/** A dialog to choose a language e.g.
+ *
+ *      English                en
+ *      German                 de
+ *      Portuguese for Brazil  pt-BR
+ *
+ *  It displays the full names of languages in one column, and the tag in the other,
+ *  and has a button to add a new language using FullLanguageTagDialog.
+ */
 class LanguageTagDialog : public wxDialog
 {
 public: