openttd-ottdgrfs: comparison src/misc

equal deleted inserted replaced

-:59cc173953ae
+:b499fdd106d5
 		/* If the last text has scrolled start anew from the start */
 		if (y < 50) WP(w, scroller_d).height = w->height - 40;
 		DoDrawStringCentered(210, w->height - 25, "Website: http://www.openttd.org", 16);
 		DrawStringCentered(210, w->height - 15, STR_00BA_COPYRIGHT_OPENTTD, 0);
-	}	break;
+	} break;
 	case WE_MOUSELOOP: // Timer to scroll the text and adjust the new top
 		if (WP(w, scroller_d).counter++ % 3 == 0) {
 			WP(w, scroller_d).height--;
 			SetWindowDirty(w);
 		}
 			break;
 	}
 }
 /** Shows a tooltip
 * @param str String to be displayed
-* @param params (optional) up to 5 pieces of additional information that may be
+* @param paramcount number of params to deal with
-* added to a tooltip; currently only supports parameters of {NUM} (integer) */
+* @param params (optional) up to 5 pieces of additional information that may be
+* added to a tooltip; currently only supports parameters of {NUM} (integer) */
 void GuiShowTooltipsWithArgs(StringID str, uint paramcount, const uint32 params[])
 {
 	char buffer[512];
 	BoundingRect br;
 	Window *w;
 }
 /**
 * Delete a character from a textbuffer, either with 'Delete' or 'Backspace'
 * The character is delete from the position the caret is at
-* @param tb @Textbuf type to be changed
+* @param tb Textbuf type to be changed
-* @param delmode Type of deletion, either @WKC_BACKSPACE or @WKC_DELETE
+* @param delmode Type of deletion, either WKC_BACKSPACE or WKC_DELETE
 * @return Return true on successfull change of Textbuf, or false otherwise
 */
 bool DeleteTextBufferChar(Textbuf *tb, int delmode)
 {
 	if (delmode == WKC_BACKSPACE && tb->caretpos != 0) {
 	return false;
 }
 /**
 * Delete every character in the textbuffer
-* @param tb @Textbuf buffer to be emptied
+* @param tb Textbuf buffer to be emptied
 */
 void DeleteTextBufferAll(Textbuf *tb)
 {
 	memset(tb->buf, 0, tb->maxlength);
 	tb->length = tb->width = 0;
 /**
 * Insert a character to a textbuffer. If maxwidth of the Textbuf is zero,
 * we don't care about the visual-length but only about the physical
 * length of the string
-* @param tb @Textbuf type to be changed
+* @param tb Textbuf type to be changed
 * @param key Character to be inserted
 * @return Return true on successfull change of Textbuf, or false otherwise
 */
 bool InsertTextBufferChar(Textbuf *tb, WChar key)
 {
 }
 /**
 * Handle text navigation with arrow keys left/right.
 * This defines where the caret will blink and the next characer interaction will occur
-* @param tb @Textbuf type where navigation occurs
+* @param tb Textbuf type where navigation occurs
-* @param navmode Direction in which navigation occurs @WKC_LEFT, @WKC_RIGHT, @WKC_END, @WKC_HOME
+* @param navmode Direction in which navigation occurs WKC_LEFT, WKC_RIGHT, WKC_END, WKC_HOME
 * @return Return true on successfull change of Textbuf, or false otherwise
 */
 bool MoveTextBufferPos(Textbuf *tb, int navmode)
 {
 	switch (navmode) {
 }
 /**
 * Initialize the textbuffer by supplying it the buffer to write into
 * and the maximum length of this buffer
-* @param tb @Textbuf type which is getting initialized
+* @param tb Textbuf type which is getting initialized
 * @param buf the buffer that will be holding the data for input
 * @param maxlength maximum length in characters of this buffer
 * @param maxwidth maximum length in pixels of this buffer. If reached, buffer
 * cannot grow, even if maxlength would allow because there is space. A length
 * of zero '0' means the buffer is only restricted by maxlength */
 	tb->caret = true;
 	UpdateTextBufferSize(tb);
 }
 /**
-* Update @Textbuf type with its actual physical character and screenlength
+* Update Textbuf type with its actual physical character and screenlength
 * Get the count of characters in the string as well as the width in pixels.
 * Useful when copying in a larger amount of text at once
-* @param tb @Textbuf type which length is calculated
+* @param tb Textbuf type which length is calculated
 */
 void UpdateTextBufferSize(Textbuf *tb)
 {
 	const char *buf = tb->buf;
 	WChar c = Utf8Consume(&buf);
 * NOTE: You cannot use BindCString as parameter for this window!
 * @param caption string shown as window caption
 * @param message string that will be shown for the window
 * @param parent pointer to parent window, if this pointer is NULL the parent becomes
 * the main window WC_MAIN_WINDOW
-* @param x,y coordinates to show the window at
+* @param callback callback function pointer to set in the window descriptor*/
-* @param yes_no_callback callback function called when window is closed through any button */
 void ShowQuery(StringID caption, StringID message, Window *parent, void (*callback)(Window*, bool))
 {
 	Window *w = AllocateWindowDesc(&_query_desc);
 	if (w == NULL) return;
 			y += 10;
 			if (y >= w->vscroll.cap * 10 + w->widget[7].top + 1) break;
 		}
 		if (_saveload_mode == SLD_SAVE_GAME || _saveload_mode == SLD_SAVE_SCENARIO) {
-			DrawEditBox(w, &WP(w,querystr_d), 10);
+			DrawEditBox(w, &WP(w, querystr_d), 10);
 		}
 		break;
 	}
 	case WE_CLICK:
 		/* This test protects against using widgets 11 and 12 which are only available
 		 * in those two saveload mode  */
 		if (!(_saveload_mode == SLD_SAVE_GAME || _saveload_mode == SLD_SAVE_SCENARIO)) break;
 		if (IsWindowWidgetLowered(w, 11)) { // Delete button clicked
-			if (!FiosDelete(WP(w,querystr_d).text.buf)) {
+			if (!FiosDelete(WP(w, querystr_d).text.buf)) {
 				ShowErrorMessage(INVALID_STRING_ID, STR_4008_UNABLE_TO_DELETE_FILE, 0, 0);
 			} else {
 				BuildFileList();
 				/* Reset file name to current date on successfull delete */
 				if (_saveload_mode == SLD_SAVE_GAME) GenerateFileName();
 			UpdateTextBufferSize(&WP(w, querystr_d).text);
 			SetWindowDirty(w);
 		} else if (IsWindowWidgetLowered(w, 12)) { // Save button clicked
 			_switch_mode = SM_SAVE;
-			FiosMakeSavegameName(_file_to_saveload.name, WP(w,querystr_d).text.buf, sizeof(_file_to_saveload.name));
+			FiosMakeSavegameName(_file_to_saveload.name, WP(w, querystr_d).text.buf, sizeof(_file_to_saveload.name));
 			/* In the editor set up the vehicle engines correctly (date might have changed) */
 			if (_game_mode == GM_EDITOR) StartupEngines();
 		}
 		break;
 	return _local_player;
 }
 /**
 * @param p1 -1 or +1 (down/up)
+* @param p2 unused
 */
 static int32 ClickChangeClimateCheat(int32 p1, int32 p2)
 {
 	if (p1 == -1) p1 = 3;
 	if (p1 ==  4) p1 = 0;
 }
 extern void EnginesMonthlyLoop();
 /**
+* @param p1 unused
 * @param p2 1 (increase) or -1 (decrease)
 */
 static int32 ClickChangeDateCheat(int32 p1, int32 p2)
 {
 	YearMonthDay ymd;

branch	noai
changeset 9601	b499fdd106d5
parent 9599	949374e83b78
child 9624	b71483f2330f