Commit 438ec699 authored by Jonathan Michalon's avatar Jonathan Michalon

Fix/workaround doc issues (warnings, gtkdoc requirement, .PHONY html)

parent 544aa2be
...@@ -29,4 +29,9 @@ AC_DEFUN([OVCC_VALADOC_CHECK], ...@@ -29,4 +29,9 @@ AC_DEFUN([OVCC_VALADOC_CHECK],
[AS_IF([test "x$enable_valadoc" = xyes], [AS_IF([test "x$enable_valadoc" = xyes],
[AC_MSG_ERROR([valadoc not found or too old])])])]) [AC_MSG_ERROR([valadoc not found or too old])])])])
AM_CONDITIONAL([ENABLE_VALADOC], [test "x$have_valadoc" = xyes]) AM_CONDITIONAL([ENABLE_VALADOC], [test "x$have_valadoc" = xyes])
# check for gtkdoc needed by gtkdoc doclet
AS_IF([test "x$have_valadoc" = xyes],
[AC_PATH_PROG([GTKDOC], [gtkdoc-scan], [NONE])])
AM_CONDITIONAL([ENABLE_VALADOC_GTKDOC], [test "x$GTKDOC" != xNONE])
]) ])
...@@ -19,10 +19,10 @@ valadoc_real_flags = --no-protected \ ...@@ -19,10 +19,10 @@ valadoc_real_flags = --no-protected \
--package-version $(VALADOC_MODULE_VERSION) \ --package-version $(VALADOC_MODULE_VERSION) \
$(VALADOC_FILES) $(VALADOC_FILES)
EXTRA_DIST = html devhelp gtkdoc EXTRA_DIST = valadoc devhelp gtkdoc
doc: html devhelp gtkdoc doc: valadoc devhelp gtkdoc
dist-hook: html devhelp gtkdoc dist-hook: valadoc devhelp gtkdoc
# Removing the target before building the documentation avoids conflicts # Removing the target before building the documentation avoids conflicts
# between doclet and directory names, since valadoc first tries to find the # between doclet and directory names, since valadoc first tries to find the
...@@ -30,32 +30,37 @@ dist-hook: html devhelp gtkdoc ...@@ -30,32 +30,37 @@ dist-hook: html devhelp gtkdoc
# For the gtkdoc doclet, it also prevents leftover files to be used and # For the gtkdoc doclet, it also prevents leftover files to be used and
# produce wrong results, e.g. if a file got renamed. # produce wrong results, e.g. if a file got renamed.
html: $(VALADOC_FILES) valadoc: $(VALADOC_FILES)
$(RM) -r $@ $(AM_V_at)$(RM) -r $@
$(VALADOC) \ $(AM_V_GEN)$(VALADOC) \
-o $@ \ -o $@ \
--doclet html \ --doclet html \
$(valadoc_real_flags) $(valadoc_real_flags)
devhelp: $(VALADOC_FILES) devhelp: $(VALADOC_FILES)
$(RM) -r $@ $(AM_V_at)$(RM) -r $@
$(VALADOC) \ $(AM_V_GEN)$(VALADOC) \
-o $@ \ -o $@ \
--doclet devhelp \ --doclet devhelp \
$(valadoc_real_flags) $(valadoc_real_flags)
if ENABLE_VALADOC_GTKDOC
gtkdoc: $(VALADOC_FILES) gtkdoc: $(VALADOC_FILES)
$(RM) -r $@ $(AM_V_at)$(RM) -r $@
$(VALADOC) \ $(AM_V_GEN)$(VALADOC) \
-X -l -X $(VALADOC_LIB) \ -X -l -X $(VALADOC_LIB) \
-X $(VALADOC_CHEADER) \ -X $(VALADOC_CHEADER) \
-o $@ \ -o $@ \
--doclet gtkdoc \ --doclet gtkdoc \
$(valadoc_real_flags) $(valadoc_real_flags)
else
gtkdoc:
$(AM_V_at)mkdir $@
endif
clean-local: clean-local:
$(RM) -r html devhelp gtkdoc $(RM) -r valadoc devhelp gtkdoc
uninstall-doc-devhelp: uninstall-doc-devhelp:
$(RM) -r $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME) $(RM) -r $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME)
...@@ -65,12 +70,20 @@ install-doc-devhelp: devhelp ...@@ -65,12 +70,20 @@ install-doc-devhelp: devhelp
$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME) devhelp/$(VALADOC_MODULE_NAME)/*.* $(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME) devhelp/$(VALADOC_MODULE_NAME)/*.*
$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME)/img devhelp/$(VALADOC_MODULE_NAME)/img/* $(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME)/img devhelp/$(VALADOC_MODULE_NAME)/img/*
if ENABLE_VALADOC_GTKDOC
uninstall-doc-gtkdoc: uninstall-doc-gtkdoc:
$(RM) -r $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) $(RM) -r $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME)
else
uninstall-doc-gtkdoc:
endif
if ENABLE_VALADOC_GTKDOC
install-doc-gtkdoc: gtkdoc install-doc-gtkdoc: gtkdoc
$(MKDIR_P) $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) $(MKDIR_P) $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME)
$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) gtkdoc/html/*.* $(INSTALL_DATA) -t $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) gtkdoc/html/*.*
else
install-doc-gtkdoc:
endif
uninstall-hook: uninstall-doc-devhelp uninstall-doc-gtkdoc uninstall-hook: uninstall-doc-devhelp uninstall-doc-gtkdoc
......
...@@ -168,12 +168,12 @@ namespace OVCC ...@@ -168,12 +168,12 @@ namespace OVCC
/** /**
* Checks whether a tile is placeable on the board * Checks whether a tile is placeable on the board
* *
* @param tile a tile * @param tile a {@link tile}
* @return true if the tile can be placed, false otherwise. * @return true if the tile can be placed, false otherwise.
*/ */
public bool is_tile_placeable (Tile t) public bool is_tile_placeable (Tile tile)
{ {
var tile = t.dup(); var tiledup = tile.dup();
return false == this.foreach ((b, p, t) => { return false == this.foreach ((b, p, t) => {
for (var i = 0; i < 4; i++) { for (var i = 0; i < 4; i++) {
var npos = p; var npos = p;
...@@ -185,10 +185,10 @@ namespace OVCC ...@@ -185,10 +185,10 @@ namespace OVCC
case 3: npos.x--; break; /* left */ case 3: npos.x--; break; /* left */
} }
for (var j = 0; j < 4; j++) { for (var j = 0; j < 4; j++) {
if (this.add_tile_check (tile, npos)) { if (this.add_tile_check (tiledup, npos)) {
return false; return false;
} else { } else {
tile.rotate (1); tiledup.rotate (1);
} }
} }
} }
......
...@@ -23,10 +23,10 @@ namespace OVCC ...@@ -23,10 +23,10 @@ namespace OVCC
/** /**
* The errors of the GameError domain. * The errors of the GameError domain.
* *
* @param STARTED The game is started and the action therefore cannot be done. * || STARTED || The game is started and the action therefore cannot be done. ||
* @param PLAYER_ALREADY_ADDED Player is already on the game. * || PLAYER_ALREADY_ADDED || Player is already on the game. ||
* @param DUPLICATED_NICK Player have the same nick than an another player. * || DUPLICATED_NICK || Player have the same nick than an another player. ||
* @param FAILED Something failed... * || FAILED || Something failed... ||
*/ */
public errordomain GameError public errordomain GameError
{ {
...@@ -40,11 +40,11 @@ namespace OVCC ...@@ -40,11 +40,11 @@ namespace OVCC
* Possible states of a game. * Possible states of a game.
* Only one state at a time. "Flags" type is used for filtering only. * Only one state at a time. "Flags" type is used for filtering only.
* *
* @param NEW The game is just created but no player joined * || NEW || The game is just created but no player joined ||
* @param PLAYER_WAITING The game has players but is not started yet * || PLAYER_WAITING || The game has players but is not started yet ||
* @param STARTED The game is started * || STARTED || The game is started ||
* @param FINISHED The game is finished * || FINISHED || The game is finished ||
* @param ABORTED The game is stopped, but not finished * || ABORTED || The game is stopped, but not finished ||
*/ */
[Flags] [Flags]
public enum GameState public enum GameState
......
...@@ -29,4 +29,9 @@ AC_DEFUN([OVCC_VALADOC_CHECK], ...@@ -29,4 +29,9 @@ AC_DEFUN([OVCC_VALADOC_CHECK],
[AS_IF([test "x$enable_valadoc" = xyes], [AS_IF([test "x$enable_valadoc" = xyes],
[AC_MSG_ERROR([valadoc not found or too old])])])]) [AC_MSG_ERROR([valadoc not found or too old])])])])
AM_CONDITIONAL([ENABLE_VALADOC], [test "x$have_valadoc" = xyes]) AM_CONDITIONAL([ENABLE_VALADOC], [test "x$have_valadoc" = xyes])
# check for gtkdoc needed by gtkdoc doclet
AS_IF([test "x$have_valadoc" = xyes],
[AC_PATH_PROG([GTKDOC], [gtkdoc-scan], [NONE])])
AM_CONDITIONAL([ENABLE_VALADOC_GTKDOC], [test "x$GTKDOC" != xNONE])
]) ])
...@@ -19,10 +19,10 @@ valadoc_real_flags = --no-protected \ ...@@ -19,10 +19,10 @@ valadoc_real_flags = --no-protected \
--package-version $(VALADOC_MODULE_VERSION) \ --package-version $(VALADOC_MODULE_VERSION) \
$(VALADOC_FILES) $(VALADOC_FILES)
EXTRA_DIST = html devhelp gtkdoc EXTRA_DIST = valadoc devhelp gtkdoc
doc: html devhelp gtkdoc doc: valadoc devhelp gtkdoc
dist-hook: html devhelp gtkdoc dist-hook: valadoc devhelp gtkdoc
# Removing the target before building the documentation avoids conflicts # Removing the target before building the documentation avoids conflicts
# between doclet and directory names, since valadoc first tries to find the # between doclet and directory names, since valadoc first tries to find the
...@@ -30,32 +30,37 @@ dist-hook: html devhelp gtkdoc ...@@ -30,32 +30,37 @@ dist-hook: html devhelp gtkdoc
# For the gtkdoc doclet, it also prevents leftover files to be used and # For the gtkdoc doclet, it also prevents leftover files to be used and
# produce wrong results, e.g. if a file got renamed. # produce wrong results, e.g. if a file got renamed.
html: $(VALADOC_FILES) valadoc: $(VALADOC_FILES)
$(RM) -r $@ $(AM_V_at)$(RM) -r $@
$(VALADOC) \ $(AM_V_GEN)$(VALADOC) \
-o $@ \ -o $@ \
--doclet html \ --doclet html \
$(valadoc_real_flags) $(valadoc_real_flags)
devhelp: $(VALADOC_FILES) devhelp: $(VALADOC_FILES)
$(RM) -r $@ $(AM_V_at)$(RM) -r $@
$(VALADOC) \ $(AM_V_GEN)$(VALADOC) \
-o $@ \ -o $@ \
--doclet devhelp \ --doclet devhelp \
$(valadoc_real_flags) $(valadoc_real_flags)
if ENABLE_VALADOC_GTKDOC
gtkdoc: $(VALADOC_FILES) gtkdoc: $(VALADOC_FILES)
$(RM) -r $@ $(AM_V_at)$(RM) -r $@
$(VALADOC) \ $(AM_V_GEN)$(VALADOC) \
-X -l -X $(VALADOC_LIB) \ -X -l -X $(VALADOC_LIB) \
-X $(VALADOC_CHEADER) \ -X $(VALADOC_CHEADER) \
-o $@ \ -o $@ \
--doclet gtkdoc \ --doclet gtkdoc \
$(valadoc_real_flags) $(valadoc_real_flags)
else
gtkdoc:
$(AM_V_at)mkdir $@
endif
clean-local: clean-local:
$(RM) -r html devhelp gtkdoc $(RM) -r valadoc devhelp gtkdoc
uninstall-doc-devhelp: uninstall-doc-devhelp:
$(RM) -r $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME) $(RM) -r $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME)
...@@ -65,12 +70,20 @@ install-doc-devhelp: devhelp ...@@ -65,12 +70,20 @@ install-doc-devhelp: devhelp
$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME) devhelp/$(VALADOC_MODULE_NAME)/*.* $(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME) devhelp/$(VALADOC_MODULE_NAME)/*.*
$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME)/img devhelp/$(VALADOC_MODULE_NAME)/img/* $(INSTALL_DATA) -t $(DESTDIR)$(datadir)/devhelp/books/$(VALADOC_MODULE_NAME)/img devhelp/$(VALADOC_MODULE_NAME)/img/*
if ENABLE_VALADOC_GTKDOC
uninstall-doc-gtkdoc: uninstall-doc-gtkdoc:
$(RM) -r $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) $(RM) -r $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME)
else
uninstall-doc-gtkdoc:
endif
if ENABLE_VALADOC_GTKDOC
install-doc-gtkdoc: gtkdoc install-doc-gtkdoc: gtkdoc
$(MKDIR_P) $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) $(MKDIR_P) $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME)
$(INSTALL_DATA) -t $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) gtkdoc/html/*.* $(INSTALL_DATA) -t $(DESTDIR)$(datadir)/gtk-doc/html/$(VALADOC_MODULE_NAME) gtkdoc/html/*.*
else
install-doc-gtkdoc:
endif
uninstall-hook: uninstall-doc-devhelp uninstall-doc-gtkdoc uninstall-hook: uninstall-doc-devhelp uninstall-doc-gtkdoc
......
...@@ -101,14 +101,14 @@ namespace OVCCClient ...@@ -101,14 +101,14 @@ namespace OVCCClient
/** /**
* A signal emitted when a message was received from server * A signal emitted when a message was received from server
* *
* @param msg A {@link Message} instance containing what the server sent us * @param msg A {@link OVCC.Network.Message} instance containing what the server sent us
*/ */
[Signal (detailed = true)] [Signal (detailed = true)]
public signal void message_received (Message msg); public signal void message_received (Message msg);
/** /**
* A signal emitted when a message in queue was sent to the server * A signal emitted when a message in queue was sent to the server
* *
* @param msg A {@link Message} instance which was just sent to the server * @param msg A {@link OVCC.Network.Message} instance which was just sent to the server
* @param err An optional error raised when sending * @param err An optional error raised when sending
*/ */
public signal void message_sent (Message msg, public signal void message_sent (Message msg,
...@@ -210,10 +210,10 @@ namespace OVCCClient ...@@ -210,10 +210,10 @@ namespace OVCCClient
} }
/** /**
* Asynchronous method allowing to pause until a given {@link MessageType} * Asynchronous method allowing to pause until a given {@link OVCC.Network.MessageType}
* get received. * get received.
* *
* @param mtype The {@link MessageType} to wait for * @param mtype The {@link OVCC.Network.MessageType} to wait for
* @param cancellable a Cancellable object or null * @param cancellable a Cancellable object or null
* @return The message received * @return The message received
*/ */
...@@ -252,7 +252,7 @@ namespace OVCCClient ...@@ -252,7 +252,7 @@ namespace OVCCClient
/** /**
* Asynchronous method to send messages to the remote server. * Asynchronous method to send messages to the remote server.
* *
* @param msg The {@link Message} to send * @param msg The {@link OVCC.Network.Message} to send
* @param cancellable a Cancellable object or null * @param cancellable a Cancellable object or null
* @return Whether the operation succeeded. * @return Whether the operation succeeded.
*/ */
...@@ -418,8 +418,8 @@ namespace OVCCClient ...@@ -418,8 +418,8 @@ namespace OVCCClient
* This method retrieves a list of available games currently on the server * This method retrieves a list of available games currently on the server
* matching the given filter * matching the given filter
* *
* @param a mask of {@link GameState}s to filter in * @param filter a mask of {@link OVCC.GameState}s to filter in
* @return A list of {@link GameDescription} on the remote server matching //filter// * @return A list of {@link OVCC.GameDescription} on the remote server matching //filter//
*/ */
public async GameDescription[]? enumerate_games (GameState? filter = null, public async GameDescription[]? enumerate_games (GameState? filter = null,
Cancellable? cancellable = null) Cancellable? cancellable = null)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment