From ed4f806f1dcff2e10d2fdfb687e6bcebe9a81af3 Mon Sep 17 00:00:00 2001 From: frosch Date: Sun, 1 Aug 2010 19:22:34 +0000 Subject: (svn r20283) -Codechange: Unify start of doygen comments. --- src/smallmap_gui.cpp | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) (limited to 'src/smallmap_gui.cpp') diff --git a/src/smallmap_gui.cpp b/src/smallmap_gui.cpp index c3b7c0a3e..520e07248 100644 --- a/src/smallmap_gui.cpp +++ b/src/smallmap_gui.cpp @@ -63,7 +63,8 @@ static int _smallmap_industry_count; ///< Number of used industries /** Macro for end of list marker in arrays of LegendAndColour */ #define MKEND() {0, STR_NULL, {INVALID_INDUSTRYTYPE}, true, true, false} -/** Macro for break marker in arrays of LegendAndColour. +/** + * Macro for break marker in arrays of LegendAndColour. * It will have valid data, though */ #define MS(a, b) {a, b, {INVALID_INDUSTRYTYPE}, true, false, true} @@ -149,7 +150,8 @@ static const LegendAndColour _legend_land_owners[] = { #undef MS #undef MKEND -/** Allow room for all industries, plus a terminator entry +/** + * Allow room for all industries, plus a terminator entry * This is required in order to have the indutry slots all filled up */ static LegendAndColour _legend_from_industries[NUM_INDUSTRYTYPES + 1]; /* For connecting industry type to position in industries list(small map legend) */ @@ -631,7 +633,8 @@ class SmallMapWindow : public Window { return scroll; } - /** Initialize or change the zoom level. + /** + * Initialize or change the zoom level. * @param change Way to change the zoom level. * @param zoom_pt Position to keep fixed while zooming. * @pre \c *zoom_pt should contain a point in the smallmap display when zooming in or out. @@ -983,7 +986,8 @@ public: this->SmallMapCenterOnCurrentPos(); } - /** Compute maximal required height of the legends. + /** + * Compute maximal required height of the legends. * @return Maximally needed height for displaying the smallmap legends in pixels. */ inline uint GetMaxLegendHeight() const @@ -992,7 +996,8 @@ public: return WD_FRAMERECT_TOP + WD_FRAMERECT_BOTTOM + num_rows * FONT_HEIGHT_SMALL; } - /** Compute minimal required width of the legends. + /** + * Compute minimal required width of the legends. * @return Minimally needed width for displaying the smallmap legends in pixels. */ inline uint GetMinLegendWidth() const @@ -1000,7 +1005,8 @@ public: return WD_FRAMERECT_LEFT + this->min_number_of_columns * this->column_width; } - /** Return number of columns that can be displayed in \a width pixels. + /** + * Return number of columns that can be displayed in \a width pixels. * @return Number of columns to display. */ inline uint GetNumberColumnsLegend(uint width) const @@ -1008,7 +1014,8 @@ public: return width / this->column_width; } - /** Compute height given a width. + /** + * Compute height given a width. * @return Needed height for displaying the smallmap legends in pixels. */ uint GetLegendHeight(uint width) const -- cgit v1.2.3-54-g00ecf