diff --git a/Makefile.in b/Makefile.in index b972fd7..09efc7e 100644 --- a/Makefile.in +++ b/Makefile.in @@ -142,7 +142,6 @@ lib@LIB3270_NAME@.pot: \ doc: @$(DOXYGEN) doxygen/doxyfile - #---[ Install Targets ]------------------------------------------------------------------ install: diff --git a/doxygen/doxyfile.in b/doxygen/doxyfile.in index d373db2..bce5fa8 100644 --- a/doxygen/doxyfile.in +++ b/doxygen/doxyfile.in @@ -74,7 +74,7 @@ CREATE_SUBDIRS = NO # Polish, Portuguese, Romanian, Russian, Serbian, Serbian-Cyrillic, Slovak, # Slovene, Spanish, Swedish, Ukrainian, and Vietnamese. -OUTPUT_LANGUAGE = Portuguese +OUTPUT_LANGUAGE = English # If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will # include brief member descriptions after the members that are listed in @@ -648,7 +648,7 @@ WARN_FORMAT = "$file:$line: $text" # and error messages should be written. If left blank the output is written # to stderr. -WARN_LOGFILE = doxygen.log +WARN_LOGFILE = @BASEDIR@/doxygen/doxygen.log #--------------------------------------------------------------------------- # configuration options related to the input files @@ -711,8 +711,8 @@ FILE_PATTERNS = *.c \ *.for \ *.vhd \ *.vhdl \ - *.js \ - *.xml + *.js \ + *.xml # The RECURSIVE tag can be used to turn specify whether or not subdirectories # should be searched for input files as well. Possible values are YES and NO. @@ -1401,7 +1401,7 @@ RTF_EXTENSIONS_FILE = # If the GENERATE_MAN tag is set to YES (the default) Doxygen will # generate man pages -GENERATE_MAN = NO +GENERATE_MAN = YES # The MAN_OUTPUT tag is used to specify where the man pages will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be @@ -1753,7 +1753,7 @@ DOT_IMAGE_FORMAT = png # need to set HTML_FILE_EXTENSION to xhtml in order to make the SVG files # visible. Older versions of IE do not have SVG support. -INTERACTIVE_SVG = NO +INTERACTIVE_SVG = YES # The tag DOT_PATH can be used to specify the path where the dot tool can be # found. If left blank, it is assumed the dot tool can be found in the path. diff --git a/src/include/lib3270.h b/src/include/lib3270.h index 1ca3659..79b5a6a 100644 --- a/src/include/lib3270.h +++ b/src/include/lib3270.h @@ -392,23 +392,19 @@ LIB3270_EXPORT unsigned int lib3270_get_length(H3270 *h); /** - * Start a new session (INCOMPLETE). - * - * Initialize session structure, opens a new session. - * WARNING: Multi session ins't yet supported in lib3270, because of this - * this call always return the handle of the same session. + * @brief Creates an empty TN3270 session. * * @param model Terminal model. * - * @return lib3270 internal session structure. + * @return Handle of the new session. * */ LIB3270_EXPORT H3270 * lib3270_session_new(const char *model); /** - * Destroy session, release memory. + * @brief Closes a TN3270 session releasing resources. * - * @param h Session handle. + * @param h handle of the session to close. * */ LIB3270_EXPORT void lib3270_session_free(H3270 *h); diff --git a/src/lib3270/session.c b/src/lib3270/session.c index b7cf1ec..50cc0b2 100644 --- a/src/lib3270/session.c +++ b/src/lib3270/session.c @@ -55,6 +55,12 @@ /*---[ Implement ]------------------------------------------------------------------------------------------------------------*/ +/** + * @brief Closes a TN3270 session releasing resources. + * + * @param h handle of the session to close. + * + */ void lib3270_session_free(H3270 *h) { size_t f; -- libgit2 0.21.2