[trunk] FolderReorgProposal task: cleanup doxygen

Update issue 177

applications/CMakeLists.txt

@@ -1,22 +0,0 @@
-# Build the each application if it needed
-
-if(BUILD_CODEC)
-  add_subdirectory(codec)
-endif()
-
-if(BUILD_MJ2)
-  add_subdirectory(mj2)
-endif()
-
-# Client & Server:
-if(BUILD_JPIP)
-  add_subdirectory(jpip)
-endif()
-
-if(BUILD_VIEWER)
-  add_subdirectory(OPJViewer)
-endif()
-
-if(BUILD_JAVA)
-	add_subdirectory(JavaOpenJPEG)
-endif()

applications/jpip/CHANGES

@@ -1,127 +0,0 @@
-What's New for OpenJPIP
-
-* : fixed
-- : removed
-! : changed
-+ : added
-
-Feburary 28, 2012
-+ [kaori] enabled the opj_server to reply the first query consisting with len request from kakadu client
-
-February 9, 2012
-* [kaori] fixed Doxygen configuration file to document the utilities
-+ [kaori] added execution argument to set port number for opj_dec_server, opj_viewer*
-
-January 26, 2012
-! [kaori] unapplied auxtrans_manager to the local mode
-
-December 24, 2011
-* [kaori] additional modification for the warning
-
-December 22, 2011
-* [kaori] fixed auxtrans_manager to enable MAC
-* [kaori] warnings due to disregarding return value are removed
-
-November 30, 2011
-+ [kaori] TCP return (http-tcp) implemented
-
-November 16, 2011
-* [kaori] fixed Region of Interest option, and memory leak of opj_dec_server
-+ [kaori] new feature to target JP2 files from www (libcurl required)
-* [kaori] fixed opj_server execusion error (instant terminating) with autotool, cmake still need to be fixed
-
-November 8, 2011
-! [kaori] updated main page of doxygen
-
-November 3, 2011
-* [kaori] solved memory leak of opj_server
-! [kaori] removed redundant defines
-
-November 2, 2011
-* [antonin] additional patches for autotools and cmake
-
-October 26, 2011
-* [kaori] additional patches for autotool are applied
-
-October 25, 2011
-* [kaori] patches for cmake and autotool are applied
-* [kaori] fixed client viewer to be compatible with server response header both Content-type and Content-Type
-
-October 20, 2011
-+ [added] API style in openJPIP library
-! [kaori] rearranged directories, applications are all under util/ directory, currently only 'make -f Makefile.nix' works
-
-October 18, 2011
-! [kaori] rearranged opj_server, opj_dec_server directory
-
-October 14, 2011
-+ [kaori] enable all progression orders
-
-October 12, 2011
-+ [kaori] enable layers requests; restricting the number of codesream quality layers
-
-October 11, 2011
-+ [antonin] enable JPT-stream request from client viewer option (credit to kaori)
-
-October 10, 2011
-- [antonin] removed obsolete indexer utility (credit to kaori)
-+ [antonin] enabled JPP-stream (credit to kaori)
-
-September 16, 2011
-+ [kaori] enabled stateless requests from the opj_viewers
-
-Septempber 1, 2011
-* [kaori] changed terminating status of opj_server in debug/non-server mode
-
-August 27, 2011
-* [antonin] fixed missing include directory in opj_client/opj_dec_server/CMakeLists.txt
-
-August 26, 2011
-* [antonin] fixed cmake and autotools files to reflect recent indexer changes in JPIP
-! [kaori] indexer using the latest openjpeg library
-* [antonin] fixed cmake and autotools files to reflect recent changes in JPIP
-! [kaori] fixed Makefile.nix to load openjpeg library from this archive
-
-August 25, 2011
-+ [kaori] added tid request support to JPIP client
-+ [kaori] added quit JPIP server request
-
-August 24, 2011
-+ [kaori] added cachemodel_manager, which had been managed in target_manager previously
-+ [kaori] added tid request support to JPIP server
-
-August 16, 2011
-* [antonin] fixed cmake support for openjpip
-
-August 12, 2011
-+ [antonin] added cmake support to openjpip
-
-July 6, 2011
-* [antonin] JPIP : fixed autotools to work with recent name changes
-
-July 5, 2011
-! [kaori] changed parameter, file names, message names regarding JPT-stream to JPIP-stream, which handles also JPP-stream
-
-May 26, 2011
-! [antonin] changed Makefile to Makefile.nix to avoid having autotools overwrite them.
-
-May 23, 2011
-+ [antonin] added autotools for the 'tools' directory
-+ [antonin] added autotools as a build method for jpip (credit to Vincent Torri)
-
-May 10, 2011
-! [kaori] opj_viewer removed the xml functions (for users without Xersus2)
-+ [kaori] renamed opj_viewer  to opj_viewer_xerces ( needs Xersus2)
-! [kaori] Modification of opj_dec_server to be portable to windows  
-
-May 9, 2011
-* [kaori] Removal of c99 from the compile option (to be compatible to win platform) and bool definition in libopenjpip/bool.h
-
-May 9, 2011
-* [antonin] OpenJPIP: small bug fixes to compile on win platform
-
-May 8, 2011
-* [antonin] OpenJPIP: fixed several bugs in opj_server (removal of strsep function, duplication of query string) + some changes to compile opj_server under windows (replacement of strcasecmp(), bzero()).
-
-April 14, 2011
-+ [antonin] initial commit of OpenJPIP 1.0, a JPIP client-server architecture based on OpenJPEG (see README file in jpip directory for more details)

applications/jpip/CMakeLists.txt

@@ -1,16 +0,0 @@
-# required dep for server:
-if(BUILD_JPIP_SERVER)
-  find_package(CURL REQUIRED)
-  find_package(FCGI REQUIRED)
-  find_package(Threads REQUIRED)
-  if(NOT CMAKE_USE_PTHREADS_INIT)
-    message(FATAL_ERROR "Only pthread are supported")
-  endif()
-endif()
-
-# JPIP library:
-add_subdirectory(libopenjpip)
-
-# JPIP binaries:
-add_subdirectory(util)
-

doc/Doxyfile.dox.cmake.in

@@ -109,7 +109,7 @@ FILE_PATTERNS          = *.h \
 RECURSIVE              = YES
 EXCLUDE                =
 EXCLUDE_SYMLINKS       = NO
-EXCLUDE_PATTERNS       =
+EXCLUDE_PATTERNS       = .svn
 EXCLUDE_SYMBOLS        =
 EXAMPLE_PATH           =
 EXAMPLE_PATTERNS       = *

src/lib/openjp3d/dwt.h

@@ -96,5 +96,6 @@ Calcula el valor del escal
 */
 void dwt_calc_explicit_stepsizes(opj_tccp_t * tccp, int prec);
 /*@}*/
+/*@}*/
 
 #endif /* __DWT_H */

src/lib/openjp3d/jp3d.c

@@ -2326,3 +2326,8 @@ bool j3d_encode(opj_j3d_t *j3d, opj_cio_t *cio, opj_volume_t *volume, char *inde
 	return true;
 }
 
+/* ----------------------------------------------------------------------- */
+/*@}*/
+
+/*@}*/
+

src/lib/openjp3d/jp3d.h

@@ -31,13 +31,13 @@
 #ifndef __J3D_H
 #define __J3D_H
 /**
-@file j3d.h
+@file jp3d.h
 @brief The JPEG-2000 Codestream Reader/Writer (J3D)
 
 The functions in J3D.C have for goal to read/write the several parts of the codestream: markers and data.
 */
 
-/** @defgroup J3D J3D - JPEG-2000 codestream reader/writer */
+/** @defgroup J3D J3D - JPEG-2000 PART 10 codestream reader/writer */
 /*@{*/
 
 #define J3D_CP_CSTY_PRT 0x01

src/lib/openjp3d/tgt.h

@@ -120,5 +120,6 @@ int tgt_decode(opj_bio_t *bio, opj_tgt_tree_t *tree, int leafno, int threshold);
 /*@}*/
 /* ----------------------------------------------------------------------- */
 void tgt_tree_dump (FILE *fd, opj_tgt_tree_t * tree);
+/*@}*/
 
 #endif /* __TGT_H */

src/lib/openmj2/mj2.c

@@ -2913,3 +2913,8 @@ void mj2_destroy_compress(opj_mj2_t *movie) {
 	}	
 	opj_free(movie);
 }
+
+/*@}*/
+
+/*@}*/
+

src/lib/openmj2/mj2.h

@@ -327,7 +327,7 @@ void mj2_destroy_decompress(opj_mj2_t *movie);
 Setup the decoder decoding parameters using user parameters.
 Decoding parameters are returned in mj2->j2k->cp. 
 @param movie MJ2 decompressor handle
-@param parameters decompression parameters
+@param mj2_parameters decompression parameters
 */
 void mj2_setup_decoder(opj_mj2_t *movie, mj2_dparameters_t *mj2_parameters);
 /**
@@ -372,8 +372,8 @@ Init a Standard MJ2 movie
 int mj2_init_stdmovie(opj_mj2_t *movie);
 /**
 Read the structure of an MJ2 file
-@param File MJ2 input File
+@param file MJ2 input File
-@param movie J2 movie structure 
+@param mj2 J2 movie structure 
 @return Returns 0 if successful, returns 1 otherwise
 */
 int mj2_read_struct(FILE *file, opj_mj2_t *mj2);