(svn r22405) -Document: some more "random-ish" tidbits

1 files changed, 7 insertions, 4 deletions

diff --git a/src/transparency_gui.cpp b/src/transparency_gui.cpp
index cf1979e38..d7fcf082e 100644
--- a/src/transparency_gui.cpp
+++ b/src/transparency_gui.cpp
@@ -17,10 +17,10 @@
 #include "table/sprites.h"
 #include "table/strings.h"
 
-TransparencyOptionBits _transparency_opt;
-TransparencyOptionBits _transparency_lock;
-TransparencyOptionBits _invisibility_opt;
-byte _display_opt;
+TransparencyOptionBits _transparency_opt;  ///< The bits that should be transparent.
+TransparencyOptionBits _transparency_lock; ///< Prevent these bits from flipping with X.
+TransparencyOptionBits _invisibility_opt;  ///< The bits that should be invisible.
+byte _display_opt; ///< What do we want to draw/do?
 
 /** Widget numbers of the transparency window. */
 enum TransparencyToolbarWidgets {
@@ -169,6 +169,9 @@ static const WindowDesc _transparency_desc(
 	_nested_transparency_widgets, lengthof(_nested_transparency_widgets)
 );
 
+/**
+ * Show the transparency toolbar.
+ */
 void ShowTransparencyToolbar()
 {
 	AllocateWindowDescFront<TransparenciesWindow>(&_transparency_desc, 0);