summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMario Kilies <MarioKilies@GMX.net>2011-01-29 18:21:18 +0100
committerMario Kilies <MarioKilies@GMX.net>2011-01-29 18:21:18 +0100
commit0342b083fe6d189fbe3a57bb5a01bcf9f8f7ddf3 (patch)
tree578ef5b7ec182614c40657a260522b0eee9d6ae1
parent82b730d941df3ab0e7718435dd047900b26e633a (diff)
Fixed documentation errors.
-rw-r--r--src/server_game_states.c6
1 files changed, 4 insertions, 2 deletions
diff --git a/src/server_game_states.c b/src/server_game_states.c
index c605e48..4f9268a 100644
--- a/src/server_game_states.c
+++ b/src/server_game_states.c
@@ -8,6 +8,7 @@
* Game state handler. If it is the first round, the server takes cards from the main stack and places them onto the table, as table stacks. The server then sends the table stacks to all players. After this, the hands for the players will be drawn from the main stack and sent to the players. On returning from the function, a state transition occurs.
* @param[in] client_socks The client sockets used for communication
* @param[in] round The current round of the game
+ * @param[in,out] m The used main stack
* @return STATE_SERVER_WAIT_FOR_OPEN_CARDS The next state after dealing hand cards
*/
game_state_t state_server_deal_hand_cards(const socket_list_t *client_socks, const uint8_t round, main_stack_t *m)
@@ -91,8 +92,9 @@ game_state_t state_server_wait_for_open_cards(const socket_list_t *client_socks)
/**
* Game state handler. In this state, the server tries to play all open cards. If a player's card is smaller than all the cards on the stacks, the player has to choose a stack. Receive the player's chosen stack, replace it with his open card and increment the player's score. If the player's card fits on a stack, but the stack is already full, then replace the stack with the card, and add the stack points to the player's points.
- * If the players still have hand cards, then wait for chosen open cards from players. If the players do not have anymore hand cards and the mainstack has enough cards to deal every player at least one card, then deal new hand cards. Otherwise the game has finished.
- * @param[in] sock The server socket that is read/written to
+ * If the players still have hand cards, then wait for chosen open cards from players. If the players do not have anymore hand cards and the main stack has enough cards to deal every player at least one card, then deal new hand cards. Otherwise the game has finished.
+ * @param[in] client_socks The client sockets used for communication
+ * @param[in,out] m The used main stack
* @return STATE_SERVER_WAIT_FOR_OPEN_CARDS The next state, if the players still have hand cards
* @return STATE_SERVER_DEAL_HAND_CARDS The next state, if the main stack has at least one card for each player left. The server will then deal those cards
* @return STATE_SERVER_GAME_FINISHED The next state, if the main stack is empty