stratagus-cvs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Stratagus-CVS] stratagus/src clone/ccl.c clone/iolib.c clone/u...


From: Russell Smith
Subject: [Stratagus-CVS] stratagus/src clone/ccl.c clone/iolib.c clone/u...
Date: Thu, 18 Sep 2003 07:59:22 -0400

CVSROOT:        /cvsroot/stratagus
Module name:    stratagus
Branch:         
Changes by:     Russell Smith <address@hidden>  03/09/18 07:59:21

Modified files:
        src/clone      : ccl.c iolib.c unit.c unit_draw.c unit_find.c 
        src/include    : unittype.h 
        src/include/etlib: dllist.h 
        src/map        : map_fog.c 
        src/network    : commands.c lowlevel.c netconnect.c network.c 
        src/pathfinder : pathfinder.c 
        src/unit       : ccl_unit.c 

Log message:
        Fixes for documentation and doxygen warnings

Patches:
Index: stratagus/src/clone/ccl.c
diff -u stratagus/src/clone/ccl.c:1.108 stratagus/src/clone/ccl.c:1.109
--- stratagus/src/clone/ccl.c:1.108     Sun Aug 17 11:57:06 2003
+++ stratagus/src/clone/ccl.c   Thu Sep 18 07:59:20 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: ccl.c,v 1.108 2003/08/17 15:57:06 n0body Exp $
+//     $Id: ccl.c,v 1.109 2003/09/18 11:59:20 mr-russ Exp $
 
 //@{
 
@@ -264,9 +264,9 @@
 /**
 **      Return of game name.
 **
-**      @param name    SCM name. (nil reports only)
+**      @param gamename        SCM name. (nil reports only)
 **
-**      @return         Old game name.
+**      @return                Old game name.
 */
 local SCM CclSetGameName(SCM gamename)
 {
@@ -1023,7 +1023,7 @@
     }
 
     fprintf(fd,";;; -----------------------------------------\n");
-    fprintf(fd,";;; $Id: ccl.c,v 1.108 2003/08/17 15:57:06 n0body Exp $\n");
+    fprintf(fd,";;; $Id: ccl.c,v 1.109 2003/09/18 11:59:20 mr-russ Exp $\n");
 
     fprintf(fd,"(set-video-resolution! %d %d)\n", VideoWidth, VideoHeight);
     
@@ -1047,7 +1047,7 @@
     }
 
     fprintf(fd,";;; -----------------------------------------\n");
-    fprintf(fd,";;; $Id: ccl.c,v 1.108 2003/08/17 15:57:06 n0body Exp $\n");
+    fprintf(fd,";;; $Id: ccl.c,v 1.109 2003/09/18 11:59:20 mr-russ Exp $\n");
 
     // Global options
     if( OriginalFogOfWar ) {
@@ -1157,7 +1157,7 @@
     extern SCM oblistvar;
 
     CLprintf(file,"\n;;; -----------------------------------------\n");
-    CLprintf(file,";;; MODULE: CCL $Id: ccl.c,v 1.108 2003/08/17 15:57:06 
n0body Exp $\n\n");
+    CLprintf(file,";;; MODULE: CCL $Id: ccl.c,v 1.109 2003/09/18 11:59:20 
mr-russ Exp $\n\n");
 
     for(list = oblistvar; gh_list_p(list); list = gh_cdr(list) ) {
        SCM sym;
Index: stratagus/src/clone/iolib.c
diff -u stratagus/src/clone/iolib.c:1.51 stratagus/src/clone/iolib.c:1.52
--- stratagus/src/clone/iolib.c:1.51    Sun Aug 17 11:57:06 2003
+++ stratagus/src/clone/iolib.c Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: iolib.c,v 1.51 2003/08/17 15:57:06 n0body Exp $
+//     $Id: iolib.c,v 1.52 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -148,7 +148,10 @@
 /**
 **     CLopen          Library file open
 **
-**     @param fn       File name.
+**     @param fn               File name.
+**     @param openflags        Open read, or write and compression options
+**
+**     @return                 File Pointer
 */
 global CLFile *CLopen(const char *fn,long openflags)
 {
Index: stratagus/src/clone/unit.c
diff -u stratagus/src/clone/unit.c:1.295 stratagus/src/clone/unit.c:1.296
--- stratagus/src/clone/unit.c:1.295    Sun Sep 14 00:45:52 2003
+++ stratagus/src/clone/unit.c  Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: unit.c,v 1.295 2003/09/14 04:45:52 mr-russ Exp $
+//     $Id: unit.c,v 1.296 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -2473,7 +2473,7 @@
  **    @param px       OUT: Map X position of tile.
  **    @param py       OUT: Map Y position of tile.
  **
- **    @notes          Movement mask can be 0xFFFFFFFF to have no effect
+ **    @note           Movement mask can be 0xFFFFFFFF to have no effect
  **                    Range is not circular, but square.
  **                    Player is ignored if nil(search the entire map)
  **                    Use rvresult if you search for a til;e that doesn't
@@ -2584,11 +2584,11 @@
  **
  **    @param unit     The unit that wants to find a resource.
  **    @param x        Closest to x
- **    @param x        Closest to y
+ **    @param y        Closest to y
  **    @param range    Maximum distance to the resource.
  **    @param resource The resource id.
  **
- **    @notes          This will return an usable resource building that
+ **    @note           This will return an usable resource building that
  **                    belongs to "player" or is neutral.
  **
  **    @return         NoUnitP or resource unit
@@ -2729,12 +2729,13 @@
  **
  **    @param unit     The unit that wants to find a resource.
  **    @param x        Closest to x
- **    @param x        Closest to y
+ **    @param y        Closest to y
  **    @param range    Maximum distance to the deposit.
+ **    @param resource Resource to find deposit from.
  **
- **    @notes          This will return a reachable allied depot.
+ **    @note           This will return a reachable allied depot.
  **
- **    @return         NoUnitP or oil deposit unit
+ **    @return         NoUnitP or deposit unit
  */
 global Unit* FindDeposit(const Unit* unit,int x,int y,int range,int resource)
 {
@@ -3964,7 +3965,7 @@
     int InRun, RunStart;
 
     CLprintf(file,"\n;;; -----------------------------------------\n");
-    CLprintf(file,";;; MODULE: units $Id: unit.c,v 1.295 2003/09/14 04:45:52 
mr-russ Exp $\n\n");
+    CLprintf(file,";;; MODULE: units $Id: unit.c,v 1.296 2003/09/18 11:59:21 
mr-russ Exp $\n\n");
 
     //
     // Local variables
Index: stratagus/src/clone/unit_draw.c
diff -u stratagus/src/clone/unit_draw.c:1.159 
stratagus/src/clone/unit_draw.c:1.160
--- stratagus/src/clone/unit_draw.c:1.159       Thu Sep 11 18:07:53 2003
+++ stratagus/src/clone/unit_draw.c     Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: unit_draw.c,v 1.159 2003/09/11 22:07:53 n0body Exp $
+//     $Id: unit_draw.c,v 1.160 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -577,7 +577,7 @@
 global void SaveDecorations(CLFile* file)
 {
     CLprintf(file,"\n;;; -----------------------------------------\n");
-    CLprintf(file,";;; MODULE: decorations $Id: unit_draw.c,v 1.159 2003/09/11 
22:07:53 n0body Exp $\n\n");
+    CLprintf(file,";;; MODULE: decorations $Id: unit_draw.c,v 1.160 2003/09/18 
11:59:21 mr-russ Exp $\n\n");
 
     CLprintf(file,"(mana-sprite \"%s\"  %d %d  %d %d)\n",
        ManaSprite.File,ManaSprite.HotX,ManaSprite.HotY,
@@ -1345,10 +1345,10 @@
 /**
 **     Get the location of an unit's order.
 **     
-**     @param order    Pointer to unit.
+**     @param unit     Pointer to unit.
 **     @param order    Pointer to order.
 **     @param x        Resulting screen X cordinate.
-**     @param x        Resulting screen Y cordinate.
+**     @param y        Resulting screen Y cordinate.
 */
 local void GetOrderPosition(const Unit* unit,const Order* order,int* x,int* y)
 {
Index: stratagus/src/clone/unit_find.c
diff -u stratagus/src/clone/unit_find.c:1.56 
stratagus/src/clone/unit_find.c:1.57
--- stratagus/src/clone/unit_find.c:1.56        Fri Sep  5 14:10:55 2003
+++ stratagus/src/clone/unit_find.c     Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: unit_find.c,v 1.56 2003/09/05 18:10:55 n0body Exp $
+//     $Id: unit_find.c,v 1.57 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -382,6 +382,7 @@
 **
 **     @param tx       X position on map, tile-based.
 **     @param ty       Y position on map, tile-based.
+**     @param type     Unit Type to Find
 **
 **     @return         Returns the unit if found, or NoUnitP.
 */
Index: stratagus/src/include/etlib/dllist.h
diff -u stratagus/src/include/etlib/dllist.h:1.6 
stratagus/src/include/etlib/dllist.h:1.7
--- stratagus/src/include/etlib/dllist.h:1.6    Mon Jun 10 17:59:40 2002
+++ stratagus/src/include/etlib/dllist.h        Thu Sep 18 07:59:21 2003
@@ -1,12 +1,15 @@
-#ifndef ETLIB_DLLIST_H
-#define ETLIB_DLLIST_H
 /**
 **     @author Copyright by Edgar Toernig.
 **     @name   dllist.h                -       Double linked lists.
 **
-*      $Id: dllist.h,v 1.6 2002/06/10 21:59:40 johns Exp $
+*      $Id: dllist.h,v 1.7 2003/09/18 11:59:21 mr-russ Exp $
 */
 
+#ifndef ETLIB_DLLIST_H
+#define ETLIB_DLLIST_H
+
+//@{
+
 struct dl_node
 {
     struct dl_node *next;
@@ -60,5 +63,7 @@
 #define dl_insert_last(h, n)    (dl_insert_after((h)->last, (n)))
 #define dl_remove_first(h)      dl_remove((h)->first) // mustn't be empty!
 #define dl_remove_last(h)       dl_remove((h)->last) // mustn't be empty!
+
+//@}
 
 #endif /* ETLIB_DLLIST_H */
Index: stratagus/src/include/unittype.h
diff -u stratagus/src/include/unittype.h:1.106 
stratagus/src/include/unittype.h:1.107
--- stratagus/src/include/unittype.h:1.106      Fri Sep 12 13:44:36 2003
+++ stratagus/src/include/unittype.h    Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: unittype.h,v 1.106 2003/09/12 17:44:36 n0body Exp $
+//     $Id: unittype.h,v 1.107 2003/09/18 11:59:21 mr-russ Exp $
 
 #ifndef __UNITTYPE_H__
 #define __UNITTYPE_H__
@@ -506,6 +506,8 @@
 **             over UnitType::Sprite.  Used with OpenGL only.
 **
 **
+*/
+/**
 **
 **     @struct _resource_info_ unittype.h
 **
Index: stratagus/src/map/map_fog.c
diff -u stratagus/src/map/map_fog.c:1.104 stratagus/src/map/map_fog.c:1.105
--- stratagus/src/map/map_fog.c:1.104   Sun Sep 14 19:25:41 2003
+++ stratagus/src/map/map_fog.c Thu Sep 18 07:59:21 2003
@@ -27,7 +27,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: map_fog.c,v 1.104 2003/09/14 23:25:41 mr-russ Exp $
+//     $Id: map_fog.c,v 1.105 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -340,7 +340,8 @@
 **     @param player   player to mark the sight for (not unit owner)
 **     @param x        x location to mark
 **     @param y        y location to mark
-**
+**     @param w        width to mark, in square
+**     @param h        height to mark, in square
 **     @param range    Radius to mark.
 **     @param marker   Function to mark or unmark sight
 */
Index: stratagus/src/network/commands.c
diff -u stratagus/src/network/commands.c:1.65 
stratagus/src/network/commands.c:1.66
--- stratagus/src/network/commands.c:1.65       Fri Sep  5 14:10:56 2003
+++ stratagus/src/network/commands.c    Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: commands.c,v 1.65 2003/09/05 18:10:56 n0body Exp $
+//     $Id: commands.c,v 1.66 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -145,7 +145,7 @@
        fprintf(LogFile,"(replay-log\n");
        fprintf(LogFile,"  'comment\t\"Generated by Stratagus Version " VERSION 
"\"\n");
        fprintf(LogFile,"  'comment\t\"Visit http://Stratagus.Org for more 
information\"\n");
-       fprintf(LogFile,"  'comment\t\"$Id: commands.c,v 1.65 2003/09/05 
18:10:56 n0body Exp $\"\n");
+       fprintf(LogFile,"  'comment\t\"$Id: commands.c,v 1.66 2003/09/18 
11:59:21 mr-russ Exp $\"\n");
        if( NetworkFildes==-1 ) {
            fprintf(LogFile,"  'type\t\"%s\"\n","single-player");
            fprintf(LogFile,"  'race\t%d\n",GameSettings.Presets[0].Race);
@@ -1451,7 +1451,5 @@
            break;
     }
 }
-
-//@}
 
 //@}
Index: stratagus/src/network/lowlevel.c
diff -u stratagus/src/network/lowlevel.c:1.33 
stratagus/src/network/lowlevel.c:1.34
--- stratagus/src/network/lowlevel.c:1.33       Fri Jul 11 10:35:33 2003
+++ stratagus/src/network/lowlevel.c    Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: lowlevel.c,v 1.33 2003/07/11 14:35:33 n0body Exp $
+//     $Id: lowlevel.c,v 1.34 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -701,7 +701,5 @@
     NetLastPort=sa.sin_port;
     return NetLastSocket;
 }
-
-//@}
 
 //@}
Index: stratagus/src/network/netconnect.c
diff -u stratagus/src/network/netconnect.c:1.72 
stratagus/src/network/netconnect.c:1.73
--- stratagus/src/network/netconnect.c:1.72     Fri Jul 11 10:35:33 2003
+++ stratagus/src/network/netconnect.c  Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: netconnect.c,v 1.72 2003/07/11 14:35:33 n0body Exp $
+//     $Id: netconnect.c,v 1.73 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -1753,7 +1753,5 @@
     }
     return 0;
 }
-
-//@}
 
 //@}
Index: stratagus/src/network/network.c
diff -u stratagus/src/network/network.c:1.115 
stratagus/src/network/network.c:1.116
--- stratagus/src/network/network.c:1.115       Fri Jul 11 10:35:33 2003
+++ stratagus/src/network/network.c     Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: network.c,v 1.115 2003/07/11 14:35:33 n0body Exp $
+//     $Id: network.c,v 1.116 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -1226,7 +1226,5 @@
        }
     }
 }
-
-//@}
 
 //@}
Index: stratagus/src/pathfinder/pathfinder.c
diff -u stratagus/src/pathfinder/pathfinder.c:1.54 
stratagus/src/pathfinder/pathfinder.c:1.55
--- stratagus/src/pathfinder/pathfinder.c:1.54  Sun Sep 14 02:53:08 2003
+++ stratagus/src/pathfinder/pathfinder.c       Thu Sep 18 07:59:21 2003
@@ -28,7 +28,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: pathfinder.c,v 1.54 2003/09/14 06:53:08 mr-russ Exp $
+//     $Id: pathfinder.c,v 1.55 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -157,7 +157,7 @@
 **     @param gy       Y position of target area
 **     @param gw       Width of target area
 **     @param gh       Height of target area
-**     @param rnage    Range to search at
+**     @param range    Range to search at
 **     @param matrix   Target area marked in matrix
 **
 **     @returns        depth, -1 unreachable
Index: stratagus/src/unit/ccl_unit.c
diff -u stratagus/src/unit/ccl_unit.c:1.66 stratagus/src/unit/ccl_unit.c:1.67
--- stratagus/src/unit/ccl_unit.c:1.66  Fri Sep  5 14:10:56 2003
+++ stratagus/src/unit/ccl_unit.c       Thu Sep 18 07:59:21 2003
@@ -26,7 +26,7 @@
 //      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
 //      02111-1307, USA.
 //
-//     $Id: ccl_unit.c,v 1.66 2003/09/05 18:10:56 n0body Exp $
+//     $Id: ccl_unit.c,v 1.67 2003/09/18 11:59:21 mr-russ Exp $
 
 //@{
 
@@ -1041,8 +1041,7 @@
 **     @param type     Unit-type of the unit,
 **     @param player   Owning player number of the unit.
 **     @param quantity Number of units to kill.
-**     @param loc1     Top left corner location.
-**     @param loc2     Bottom right corner location.
+**     @param loc      Co-ordinates list (x1 y1 x2 y2)
 **
 **     @return         Returns the number of units killed.
 */




reply via email to

[Prev in Thread] Current Thread [Next in Thread]