# HG changeset patch # User belugas # Date 1176841393 0 # Node ID 85ad87daf4b0c7bfee89986dec03027de789df15 # Parent 277af7b07386e99b3ab61efd9e7358ceec95d78c (svn r9662) -Documentation: Doxygen corrections and @file omissions diff -r 277af7b07386 -r 85ad87daf4b0 src/engine.cpp --- a/src/engine.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/engine.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -249,6 +249,7 @@ /** Accept an engine prototype. XXX - it is possible that the top-player * changes while you are waiting to accept the offer? Then it becomes invalid * @param tile unused + * @param flags operation to perfom * @param p1 engine-prototype offered * @param p2 unused */ @@ -350,6 +351,7 @@ /** Rename an engine. * @param tile unused + * @param flags operation to perfom * @param p1 engine ID to rename * @param p2 unused */ diff -r 277af7b07386 -r 85ad87daf4b0 src/engine.h --- a/src/engine.h Tue Apr 17 19:08:00 2007 +0000 +++ b/src/engine.h Tue Apr 17 20:23:13 2007 +0000 @@ -295,7 +295,7 @@ /** * Remove all engine replacement settings for the player. - * @param er The renewlist for a given player. + * @param erl The renewlist for a given player. * @return The new renewlist for the player. */ void RemoveAllEngineReplacement(EngineRenewList* erl); diff -r 277af7b07386 -r 85ad87daf4b0 src/fios.cpp --- a/src/fios.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/fios.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -57,7 +57,7 @@ /** * Compare two FiosItem's. Used with qsort when sorting the file list. * @param a A pointer to the first FiosItem to compare. - * @param a A pointer to the second FiosItem to compare. + * @param b A pointer to the second FiosItem to compare. * @return -1, 0 or 1, depending on how the two items should be sorted. */ int CDECL compare_FiosItems(const void *a, const void *b) @@ -200,9 +200,8 @@ typedef byte fios_getlist_callback_proc(int mode, const char *filename, const char *ext, char *title); /** Create a list of the files in a directory, according to some arbitrary rule. - * @param num Will be filled with the amount of items. * @param mode The mode we are in. Some modes don't allow 'parent'. - * @param callback The function that is called where you need to do the filtering. + * @param callback_proc The function that is called where you need to do the filtering. * @return Return the list of files. */ static FiosItem *FiosGetFileList(int mode, fios_getlist_callback_proc *callback_proc) { diff -r 277af7b07386 -r 85ad87daf4b0 src/genworld_gui.cpp --- a/src/genworld_gui.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/genworld_gui.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -899,7 +899,7 @@ /** * Set the total of a stage of the world generation. - * @param class the current class we are in. + * @param cls the current class we are in. * @param total Set the total expected items for this class. * * Warning: this function isn't clever. Don't go from class 4 to 3. Go upwards, always. @@ -914,7 +914,7 @@ /** * Increases the current stage of the world generation with one. - * @param class the current class we are in. + * @param cls the current class we are in. * * Warning: this function isn't clever. Don't go from class 4 to 3. Go upwards, always. * Also, progress works if total is zero, total works if progress is zero. diff -r 277af7b07386 -r 85ad87daf4b0 src/gfx.cpp --- a/src/gfx.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/gfx.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -275,7 +275,7 @@ /** Truncate a given string to a maximum width if neccessary. * If the string is truncated, add three dots ('...') to show this. - * @param *dest string that is checked and possibly truncated + * @param *str string that is checked and possibly truncated * @param maxw maximum width in pixels of the string * @return new width of (truncated) string */ static int TruncateString(char *str, int maxw) @@ -413,11 +413,11 @@ /** 'Correct' a string to a maximum length. Longer strings will be cut into * additional lines at whitespace characters if possible. The string parameter * is modified with terminating characters mid-string which are the - * placeholders for the newlines.
+ * placeholders for the newlines. * The string WILL be truncated if there was no whitespace for the current * line's maximum width. * - * @note To know if the the terminating '\0' is the string end or just a + * @note To know if the terminating '\0' is the string end or just a * newline, the returned 'num' value should be consulted. The num'th '\0', * starting with index 0 is the real string end. * @@ -487,7 +487,7 @@ * @param x Centre the string around this pixel width * @param y Draw the string at this pixel height (first line's bottom) * @param str String to draw - * @param max Maximum width the string can have before it is wrapped */ + * @param maxw Maximum width the string can have before it is wrapped */ void DrawStringMultiCenter(int x, int y, StringID str, int maxw) { char buffer[512]; @@ -626,7 +626,7 @@ /** Draw a string at the given coordinates with the given colour * @param string the string to draw * @param x offset from left side of the screen, if negative offset from the right side - * @param x offset from top side of the screen, if negative offset from the bottom + * @param y offset from top side of the screen, if negative offset from the bottom * @param real_color colour of the string, see _string_colormap in * table/palettes.h or docs/ottd-colourtext-palette.png * @return the x-coordinates where the drawing has finished. If nothing is drawn diff -r 277af7b07386 -r 85ad87daf4b0 src/helpers.cpp --- a/src/helpers.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/helpers.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -44,7 +44,7 @@ /** Add new item at the end of Engine List * @param el list o which to add an engine - * @param eif engine to add to the list + * @param eid engine to add to the list */ void EngList_Add(EngineList *el, EngineID eid) { @@ -81,7 +81,7 @@ * @param el list to be sorted * @param compare function for evaluation of the quicksort * @param begin start of sorting - * @param count of items to be sorted + * @param num_items count of items to be sorted */ void EngList_SortPartial(EngineList *el, EngList_SortTypeFunction compare, uint begin, uint num_items) { diff -r 277af7b07386 -r 85ad87daf4b0 src/main_gui.cpp --- a/src/main_gui.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/main_gui.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -1247,7 +1247,8 @@ /** Callback function for the scenario editor 'reset landscape' confirmation window - * @param yes_clicked boolean value, true when yes was clicked, false otherwise */ + * @param w Window unused + * @param confirmed boolean value, true when yes was clicked, false otherwise */ static void ResetLandscapeConfirmationCallback(Window *w, bool confirmed) { if (confirmed) { diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/array.hpp --- a/src/misc/array.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/array.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file array.hpp */ + #ifndef ARRAY_HPP #define ARRAY_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/autocopyptr.hpp --- a/src/misc/autocopyptr.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/autocopyptr.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file autocopyptr.hpp */ + #ifndef AUTOCOPYPTR_HPP #define AUTOCOPYPTR_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/autoptr.hpp --- a/src/misc/autoptr.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/autoptr.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file autoptr.hpp */ + #ifndef AUTOPTR_HPP #define AUTOPTR_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/binaryheap.hpp --- a/src/misc/binaryheap.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/binaryheap.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file binaryheap.hpp */ + #ifndef BINARYHEAP_HPP #define BINARYHEAP_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/blob.hpp --- a/src/misc/blob.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/blob.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file blob.hpp */ + #ifndef BLOB_HPP #define BLOB_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/countedptr.hpp --- a/src/misc/countedptr.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/countedptr.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file countedptr.hpp */ + #ifndef COUNTEDPTR_HPP #define COUNTEDPTR_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/crc32.hpp --- a/src/misc/crc32.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/crc32.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file crc32.hpp */ + #ifndef CRC32_HPP #define CRC32_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/fixedsizearray.hpp --- a/src/misc/fixedsizearray.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/fixedsizearray.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file fixedsizearray.hpp */ + #ifndef FIXEDSIZEARRAY_HPP #define FIXEDSIZEARRAY_HPP diff -r 277af7b07386 -r 85ad87daf4b0 src/misc/hashtable.hpp --- a/src/misc/hashtable.hpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc/hashtable.hpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file hashtable.hpp */ + #ifndef HASHTABLE_HPP #define HASHTABLE_HPP @@ -97,7 +99,7 @@ } }; -/** @class CHashTableT - simple hash table +/** class CHashTableT - simple hash table * of pointers allocated elsewhere. * * Supports: Add/Find/Remove of Titems. diff -r 277af7b07386 -r 85ad87daf4b0 src/misc_cmd.cpp --- a/src/misc_cmd.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc_cmd.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -38,6 +38,7 @@ /** Change the player's company-colour * @param tile unused + * @param flags operation to perform * @param p1 bitstuffed: * p1 bits 0-7 scheme to set * p1 bits 8-9 set in use state or first/second colour @@ -117,6 +118,7 @@ /** Increase the loan of your company. * @param tile unused + * @param flags operation to perform * @param p1 unused * @param p2 when set, loans the maximum amount in one go (press CTRL) */ @@ -146,6 +148,7 @@ /** Decrease the loan of your company. * @param tile unused + * @param flags operation to perform * @param p1 unused * @param p2 when set, pays back the maximum loan permitting money (press CTRL) */ @@ -186,6 +189,7 @@ /** Change the name of the company. * @param tile unused + * @param flags operation to perform * @param p1 unused * @param p2 unused */ @@ -213,6 +217,7 @@ /** Change the name of the president. * @param tile unused + * @param flags operation to perform * @param p1 unused * @param p2 unused */ @@ -251,6 +256,7 @@ * the game is unpaused. A counter is used instead of a boolean value * to have more control over the game when saving/loading, etc. * @param tile unused + * @param flags operation to perform * @param p1 0 = decrease pause counter; 1 = increase pause counter * @param p2 unused */ @@ -269,6 +275,7 @@ * This is normally only enabled in offline mode, but if there is a debug * build, you can cheat (to test). * @param tile unused + * @param flags operation to perform * @param p1 the amount of money to receive (if negative), or spend (if positive) * @param p2 unused */ @@ -286,6 +293,7 @@ * players if you have paid off your loan (either explicitely, or implicitely * given the fact that you have more money than loan). * @param tile unused + * @param flags operation to perform * @param p1 the amount of money to transfer; max 20.000.000 * @param p2 the player to transfer the money to */ @@ -317,6 +325,7 @@ * in file 'settings_gui.c' _game_setting_info[]; we'll just trust the server it knows * what to do and does this correctly * @param tile unused + * @param flags operation to perform * @param p1 the difficulty setting being changed. If it is -1, the difficulty level * itself is changed. The new value is inside p2 * @param p2 new value for a difficulty setting or difficulty level diff -r 277af7b07386 -r 85ad87daf4b0 src/misc_gui.cpp --- a/src/misc_gui.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/misc_gui.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -677,9 +677,10 @@ } /** Shows a tooltip -* @param str String to be displayed -* @param params (optional) up to 5 pieces of additional information that may be -* added to a tooltip; currently only supports parameters of {NUM} (integer) */ + * @param str String to be displayed + * @param paramcount number of params to deal with + * @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]; @@ -824,8 +825,8 @@ /** * 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 delmode Type of deletion, either @WKC_BACKSPACE or @WKC_DELETE + * @param tb Textbuf type to be changed + * @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) @@ -843,7 +844,7 @@ /** * Delete every character in the textbuffer - * @param tb @Textbuf buffer to be emptied + * @param tb Textbuf buffer to be emptied */ void DeleteTextBufferAll(Textbuf *tb) { @@ -856,7 +857,7 @@ * 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 */ @@ -880,8 +881,8 @@ /** * 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 navmode Direction in which navigation occurs @WKC_LEFT, @WKC_RIGHT, @WKC_END, @WKC_HOME + * @param tb Textbuf type where navigation occurs + * @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) @@ -924,7 +925,7 @@ /** * 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 @@ -940,10 +941,10 @@ } /** - * 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) { @@ -1271,8 +1272,7 @@ * @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 yes_no_callback callback function called when window is closed through any button */ + * @param callback callback function pointer to set in the window descriptor*/ void ShowQuery(StringID caption, StringID message, Window *parent, void (*callback)(Window*, bool)) { Window *w = AllocateWindowDesc(&_query_desc); @@ -1722,6 +1722,7 @@ /** * @param p1 -1 or +1 (down/up) + * @param p2 unused */ static int32 ClickChangeClimateCheat(int32 p1, int32 p2) { @@ -1735,6 +1736,7 @@ extern void EnginesMonthlyLoop(); /** + * @param p1 unused * @param p2 1 (increase) or -1 (decrease) */ static int32 ClickChangeDateCheat(int32 p1, int32 p2) diff -r 277af7b07386 -r 85ad87daf4b0 src/music/bemidi.cpp --- a/src/music/bemidi.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/music/bemidi.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file bemidi.cpp */ + #include "../stdafx.h" #include "../openttd.h" #include "bemidi.h" diff -r 277af7b07386 -r 85ad87daf4b0 src/music/dmusic.cpp --- a/src/music/dmusic.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/music/dmusic.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file dmusic.cpp */ + #ifdef WIN32_ENABLE_DIRECTMUSIC_SUPPORT #include "../stdafx.h" @@ -14,13 +16,13 @@ #include -// the performance object controls manipulation of the segments +/** the performance object controls manipulation of the segments */ static IDirectMusicPerformance* performance = NULL; -// the loader object can load many types of DMusic related files +/** the loader object can load many types of DMusic related files */ static IDirectMusicLoader* loader = NULL; -// the segment object is where the MIDI data is stored for playback +/** the segment object is where the MIDI data is stored for playback */ static IDirectMusicSegment* segment = NULL; static bool seeking = false; @@ -54,12 +56,12 @@ return "ole32.dll load failed"; } - // Initialize COM + /* Initialize COM */ if (FAILED(proc.CoInitialize(NULL))) { return "COM initialization failed"; } - // create the performance object + /* create the performance object */ if (FAILED(proc.CoCreateInstance( CLSID_DirectMusicPerformance, NULL, @@ -71,7 +73,7 @@ return "Failed to create the performance object"; } - // initialize it + /* initialize it */ if (FAILED(performance->Init(NULL, NULL, NULL))) { performance->Release(); performance = NULL; @@ -79,7 +81,7 @@ return "Failed to initialize performance object"; } - // choose default Windows synth + /* choose default Windows synth */ if (FAILED(performance->AddPort(NULL))) { performance->CloseDown(); performance->Release(); @@ -88,7 +90,7 @@ return "AddPort failed"; } - // create the loader object; this will be used to load the MIDI file + /* create the loader object; this will be used to load the MIDI file */ if (FAILED(proc.CoCreateInstance( CLSID_DirectMusicLoader, NULL, @@ -136,7 +138,7 @@ static void DMusicMidiPlaySong(const char* filename) { - // set up the loader object info + /* set up the loader object info */ DMUS_OBJECTDESC obj_desc; ZeroMemory(&obj_desc, sizeof(obj_desc)); obj_desc.dwSize = sizeof(obj_desc); @@ -148,13 +150,13 @@ obj_desc.wszFileName, lengthof(obj_desc.wszFileName) ); - // release the existing segment if we have any + /* release the existing segment if we have any */ if (segment != NULL) { segment->Release(); segment = NULL; } - // make a new segment + /* make a new segment */ if (FAILED(loader->GetObject( &obj_desc, IID_IDirectMusicSegment, (LPVOID*)&segment ))) { @@ -162,7 +164,7 @@ return; } - // tell the segment what kind of data it contains + /* tell the segment what kind of data it contains */ if (FAILED(segment->SetParam( GUID_StandardMIDIFile, 0xFFFFFFFF, 0, 0, performance ))) { @@ -170,13 +172,13 @@ return; } - // tell the segment to 'download' the instruments + /* tell the segment to 'download' the instruments */ if (FAILED(segment->SetParam(GUID_Download, 0xFFFFFFFF, 0, 0, performance))) { DEBUG(driver, 0, "DirectMusic: failed to download instruments"); return; } - // start playing the MIDI file + /* start playing the MIDI file */ if (FAILED(performance->PlaySegment(segment, 0, 0, NULL))) { DEBUG(driver, 0, "DirectMusic: PlaySegment failed"); return; @@ -210,8 +212,7 @@ static void DMusicMidiSetVolume(byte vol) { - // 0 - 127 -> -2000 - 0 - long db = vol * 2000 / 127 - 2000; + long db = vol * 2000 / 127 - 2000; ///< 0 - 127 -> -2000 - 0 performance->SetGlobalParam(GUID_PerfMasterVolume, &db, sizeof(db)); } diff -r 277af7b07386 -r 85ad87daf4b0 src/newgrf.cpp --- a/src/newgrf.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/newgrf.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -136,7 +136,7 @@ * loading/parsing grf files, not for runtime debug messages as there * is no file information available during that time. * @param severity debugging severity level, see debug.h - * @param debugging message in printf() format */ + * @param str message in printf() format */ void CDECL grfmsg(int severity, const char *str, ...) { char buf[1024]; @@ -234,6 +234,7 @@ /** Used when setting an object's property to map to the GRF's strings * while taking in consideration the "drift" between TTDPatch string system and OpenTTD's one + * @param grfid Id of the grf file * @param str StringID that we want to have the equivalent in OoenTTD * @return the properly adjusted StringID */ @@ -2004,8 +2005,8 @@ /** * Creates a spritegroup representing a sprite number result. - * @param value The sprite number. - * @param sprites The number of sprites per set. + * @param sprite The sprite number. + * @param num_sprites The number of sprites per set. * @return A spritegroup representing the sprite number result. */ static const SpriteGroup* NewResultSpriteGroup(SpriteID sprite, byte num_sprites) diff -r 277af7b07386 -r 85ad87daf4b0 src/newgrf_config.cpp --- a/src/newgrf_config.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/newgrf_config.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -187,7 +187,8 @@ } /** Appends an element to a list of GRFs - * @param dst the head of the list to add to */ + * @param dst the head of the list to add to + * @param el the new tail to be */ void AppendToGRFConfigList(GRFConfig **dst, GRFConfig *el) { GRFConfig **tail = dst; diff -r 277af7b07386 -r 85ad87daf4b0 src/newgrf_engine.cpp --- a/src/newgrf_engine.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/newgrf_engine.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -886,7 +886,7 @@ * @param param1 First parameter of the callback * @param param2 Second parameter of the callback * @param engine Engine type of the vehicle to evaluate the callback for - * @param vehicle The vehicle to evaluate the callback for, or NULL if it doesnt exist yet + * @param v The vehicle to evaluate the callback for, or NULL if it doesnt exist yet * @return The value the callback returned, or CALLBACK_FAILED if it failed */ uint16 GetVehicleCallback(uint16 callback, uint32 param1, uint32 param2, EngineID engine, const Vehicle *v) diff -r 277af7b07386 -r 85ad87daf4b0 src/newgrf_station.cpp --- a/src/newgrf_station.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/newgrf_station.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -61,7 +61,7 @@ /** * Allocate a station class for the given class id. - * @param classid A 32 bit value identifying the class. + * @param cls A 32 bit value identifying the class. * @return Index into station_classes of allocated class. */ StationClassID AllocateStationClass(uint32 cls) @@ -138,7 +138,7 @@ /** * Tie a station spec to its station class. - * @param spec The station spec. + * @param statspec The station spec. */ void SetCustomStationSpec(StationSpec *statspec) { @@ -614,7 +614,7 @@ /** * Allocate a StationSpec to a Station. This is called once per build operation. - * @param spec StationSpec to allocate. + * @param statspec StationSpec to allocate. * @param st Station to allocate it to. * @param exec Whether to actually allocate the spec. * @return Index within the Station's spec list, or -1 if the allocation failed. @@ -695,10 +695,12 @@ } /** Draw representation of a station tile for GUI purposes. - * @param x, y Position of image. - * @param dir Direction. + * @param x Position x of image. + * @param y Position y of image. + * @param axis Axis. * @param railtype Rail type. * @param sclass, station Type of station. + * @param station station ID * @return True if the tile was drawn (allows for fallback to default graphic) */ bool DrawStationTile(int x, int y, RailType railtype, Axis axis, StationClassID sclass, uint station) diff -r 277af7b07386 -r 85ad87daf4b0 src/newgrf_text.cpp --- a/src/newgrf_text.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/newgrf_text.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -418,8 +418,8 @@ * The array iso_codes will be used to find that match. * If not found, it will have to be standard english * This function is called after the user changed language, - * from strings.c:ReadLanguagePack - * @param iso code of current selection + * from strings.cpp:ReadLanguagePack + * @param iso_name iso code of current selection */ void SetCurrentGrfLangID(const char *iso_name) { diff -r 277af7b07386 -r 85ad87daf4b0 src/news_gui.cpp --- a/src/news_gui.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/news_gui.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -240,17 +240,17 @@ * @param flags various control bits that will show various news-types. See macro NEWS_FLAGS() * @param data_a news-specific value based on news type * @param data_b news-specific value based on news type - * @note flags exists of 4 byte-sized extra parameters.
- * 1. 0 - 7 display_mode, any of the NewsMode enums (NM_)
- * 2. 8 - 15 news flags, any of the NewsFlags enums (NF_) NF_INCOLOR are set automatically if needed
- * 3. 16 - 23 news category, any of the NewsType enums (NT_)
- * 4. 24 - 31 news callback function, any of the NewsCallback enums (DNC_)
+ * @note flags exists of 4 byte-sized extra parameters. + * 1. 0 - 7 display_mode, any of the NewsMode enums (NM_) + * 2. 8 - 15 news flags, any of the NewsFlags enums (NF_) NF_INCOLOR are set automatically if needed + * 3. 16 - 23 news category, any of the NewsType enums (NT_) + * 4. 24 - 31 news callback function, any of the NewsCallback enums (DNC_) * If the display mode is NM_CALLBACK special news is shown and parameter - * stringid has a special meaning.
+ * stringid has a special meaning. * DNC_TRAINAVAIL, DNC_ROADAVAIL, DNC_SHIPAVAIL, DNC_AIRCRAFTAVAIL: StringID is - * the index of the engine that is shown
+ * the index of the engine that is shown * DNC_BANKRUPCY: bytes 0-3 of StringID contains the player that is in trouble, - * and 4-7 contains what kind of bankrupcy message is shown, NewsBankrupcy enum (NB_)
+ * and 4-7 contains what kind of bankrupcy message is shown, NewsBankrupcy enum (NB_) * @see NewsMode * @see NewsFlags * @see NewsType diff -r 277af7b07386 -r 85ad87daf4b0 src/order_cmd.cpp --- a/src/order_cmd.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/order_cmd.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -182,6 +182,7 @@ /** Add an order to the orderlist of a vehicle. * @param tile unused + * @param flags operation to perform * @param p1 various bitstuffed elements * - p1 = (bit 0 - 15) - ID of the vehicle * - p1 = (bit 16 - 31) - the selected order (if any). If the last order is given, @@ -478,6 +479,7 @@ /** Delete an order from the orderlist of a vehicle. * @param tile unused + * @param flags operation to perform * @param p1 the ID of the vehicle * @param p2 the order to delete (max 255) */ @@ -557,6 +559,7 @@ /** Goto next order of order-list. * @param tile unused + * @param flags operation to perform * @param p1 The ID of the vehicle which order is skipped * @param p2 unused */ @@ -600,6 +603,7 @@ /** Modify an order in the orderlist of a vehicle. * @param tile unused + * @param flags operation to perform * @param p1 various bitstuffed elements * - p1 = (bit 0 - 15) - ID of the vehicle * - p1 = (bit 16 - 31) - the selected order (if any). If the last order is given, @@ -680,6 +684,8 @@ } /** Clone/share/copy an order-list of an other vehicle. + * @param tile unused + * @param flags operation to perform * @param p1 various bitstuffed elements * - p1 = (bit 0-15) - destination vehicle to clone orders to (p1 & 0xFFFF) * - p1 = (bit 16-31) - source vehicle to clone orders from, if any (none for CO_UNSHARE) @@ -812,6 +818,7 @@ /** Add/remove refit orders from an order * @param tile Not used + * @param flags operation to perform * @param p1 VehicleIndex of the vehicle having the order * @param p2 bitmask * - bit 0-7 CargoID @@ -937,6 +944,7 @@ /** Restore the current order-index of a vehicle and sets service-interval. * @param tile unused + * @param flags operation to perform * @param p1 the ID of the vehicle * @param p2 various bistuffed elements * - p2 = (bit 0-15) - current order-index (p2 & 0xFFFF) diff -r 277af7b07386 -r 85ad87daf4b0 src/spritecache.cpp --- a/src/spritecache.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/spritecache.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file spritechache.cpp */ +/** @file spritecache.cpp */ #include "stdafx.h" #include "openttd.h" diff -r 277af7b07386 -r 85ad87daf4b0 src/stdafx.h --- a/src/stdafx.h Tue Apr 17 19:08:00 2007 +0000 +++ b/src/stdafx.h Tue Apr 17 20:23:13 2007 +0000 @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file stdfax.h */ +/** @file stdafx.h */ #ifndef STDAFX_H #define STDAFX_H diff -r 277af7b07386 -r 85ad87daf4b0 src/widget.cpp --- a/src/widget.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/widget.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -36,17 +36,13 @@ return pt; } -/***************************************************** - * Special handling for the scrollbar widget type. +/** Special handling for the scrollbar widget type. * Handles the special scrolling buttons and other * scrolling. - * Parameters: - * w - Window. - * wi - Pointer to the scrollbar widget. - * x - The X coordinate of the mouse click. - * y - The Y coordinate of the mouse click. - */ - + * @param w Window on which a scroll was performed. + * @param wi Pointer to the scrollbar widget. + * @param x The X coordinate of the mouse click. + * @param y The Y coordinate of the mouse click. */ void ScrollbarClickHandler(Window *w, const Widget *wi, int x, int y) { int mi, ma, pos; @@ -128,8 +124,8 @@ /** Returns the index for the widget located at the given position * relative to the window. It includes all widget-corner pixels as well. * @param *w Window to look inside - * @param x - * @param y Window client coordinates + * @param x The Window client X coordinate + * @param y The Window client y coordinate * @return A widget index, or -1 if no widget was found. */ int GetWidgetFromPos(const Window *w, int x, int y) @@ -737,7 +733,7 @@ /** Evenly distribute some widgets when resizing horizontally (often a button row) * When only two arguments are given, the widgets are presumed to be on a line and only the ends are given - * @param w widow to modify + * @param w Window to modify * @param left The leftmost widget to resize * @param right The rightmost widget to resize. Since right side of it is used, remember to set it to RESIZE_RIGHT */ diff -r 277af7b07386 -r 85ad87daf4b0 src/window.cpp --- a/src/window.cpp Tue Apr 17 19:08:00 2007 +0000 +++ b/src/window.cpp Tue Apr 17 20:23:13 2007 +0000 @@ -1080,7 +1080,7 @@ * Both the areas of the old window and the new sized window are set dirty * ensuring proper redrawal. * @param w Window to resize - * @param x delta x-size of changed window (positive if larger, etc.( + * @param x delta x-size of changed window (positive if larger, etc.) * @param y delta y-size of changed window */ void ResizeWindow(Window *w, int x, int y) {