From trac at boxbackup.org Sat Jan 2 12:00:03 2010 From: trac at boxbackup.org (trac at boxbackup.org) Date: Sat, 2 Jan 2010 12:00:03 +0000 (GMT) Subject: [Boxbackup-dev] Current open tickets Message-ID: <20100102120003.E8C4E326026@www.boxbackup.org> Note: to view an indiviual ticket, use: https://www.boxbackup.org/trac/ticket/(number) The following is a listing of current problems submitted by Box Backup users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Ticket Owner Component Summary - ------ ------ ------------- ------------------------------------------------------------ n 4 martin box libraries Port Box Backup to AIX n 6 box libraries Contribute code: SMTP client, HTTP server, Database drivers, n 7 box libraries Improve restore speed on local repositories n 8 chris box libraries Improve handling of directories with many files n 13 chris bbackupd Fix file locking on Windows n 14 chris bbackupd Fix large file issues on Windows n 16 chris bbackupquery Restore deleted directories may fail a 17 chris bbackupquery List files using wildcards a 20 chris bbackupctl bbackupctl reload reports prior settings n 45 ben bbackupd File diff performance patch (reduced disk IO and wall time n 46 chris bbackupd bbackupd only ever saves reverse diffs, corrupted files on s n 47 chris bbackupd Account numbers greater than 2^31 (0x7fffffff) do not work c n 48 chris bbackupd Locations that don't exist on first run are never tried agai n 49 chris bbackupd ID map (rename tracking) broken since [288] n 50 chris bbackupquery No way to capture stderr under Windows n 51 chris bbackupd No way to force bbackupd to re-upload files under Windows n 52 chris bbackupd Unable to control the maintenance of old vs. deleted files n 53 chris bbackupd Comparing root directory locations does not work under Windo n 54 chris bbackupd Locations not found on disk (e.g. unmounted filesystems) can n 55 chris bbackupd Should store and preserve directory timestamps n 56 bbackupquery Windows: User can polute restore directory by adding a trail n 57 ben bbackupd Create boxbackupresume and other files in DataDirectory n 58 ben bbackupd bbackupquery connection timeout results in error message, sh n 59 ben bbackupd Inconsistent treatment of NotifyScript between Box Backup an n 60 ben bbstored Case sensitivity between bbstored-certs and Boxi n 61 ben bbackupd File statistics: Log the number of uploaded files in additio n 62 ben bbackupd Backups of deleted files may be removed very quickly by hous 27 tickets total. From trac at boxbackup.org Sat Jan 9 12:00:00 2010 From: trac at boxbackup.org (trac at boxbackup.org) Date: Sat, 9 Jan 2010 12:00:00 +0000 (GMT) Subject: [Boxbackup-dev] Current open tickets Message-ID: <20100109120001.118B032602E@www.boxbackup.org> Note: to view an indiviual ticket, use: https://www.boxbackup.org/trac/ticket/(number) The following is a listing of current problems submitted by Box Backup users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Ticket Owner Component Summary - ------ ------ ------------- ------------------------------------------------------------ n 4 martin box libraries Port Box Backup to AIX n 6 box libraries Contribute code: SMTP client, HTTP server, Database drivers, n 7 box libraries Improve restore speed on local repositories n 8 chris box libraries Improve handling of directories with many files n 13 chris bbackupd Fix file locking on Windows n 14 chris bbackupd Fix large file issues on Windows n 16 chris bbackupquery Restore deleted directories may fail a 17 chris bbackupquery List files using wildcards a 20 chris bbackupctl bbackupctl reload reports prior settings n 45 ben bbackupd File diff performance patch (reduced disk IO and wall time n 46 chris bbackupd bbackupd only ever saves reverse diffs, corrupted files on s n 47 chris bbackupd Account numbers greater than 2^31 (0x7fffffff) do not work c n 48 chris bbackupd Locations that don't exist on first run are never tried agai n 49 chris bbackupd ID map (rename tracking) broken since [288] n 50 chris bbackupquery No way to capture stderr under Windows n 51 chris bbackupd No way to force bbackupd to re-upload files under Windows n 52 chris bbackupd Unable to control the maintenance of old vs. deleted files n 53 chris bbackupd Comparing root directory locations does not work under Windo n 54 chris bbackupd Locations not found on disk (e.g. unmounted filesystems) can n 55 chris bbackupd Should store and preserve directory timestamps n 56 bbackupquery Windows: User can polute restore directory by adding a trail n 57 ben bbackupd Create boxbackupresume and other files in DataDirectory n 58 ben bbackupd bbackupquery connection timeout results in error message, sh n 59 ben bbackupd Inconsistent treatment of NotifyScript between Box Backup an n 60 ben bbstored Case sensitivity between bbstored-certs and Boxi n 61 ben bbackupd File statistics: Log the number of uploaded files in additio n 62 ben bbackupd Backups of deleted files may be removed very quickly by hous 27 tickets total. From boxbackup-dev at functions-net.nl Wed Jan 13 10:38:13 2010 From: boxbackup-dev at functions-net.nl (boxbackup-dev at functions-net.nl) Date: Wed, 13 Jan 2010 11:38:13 +0100 Subject: [Boxbackup-dev] doxygen Message-ID: <201001131138.15643.boxbackup-dev@functions-net.nl> Hi, Is there a reason for not using Doxygen style comments? I find browsing through code an efficient way to get acquainted with new code. So if there are no objections lets start changing the comments. Regards MRK From chris at qwirx.com Wed Jan 13 11:54:57 2010 From: chris at qwirx.com (Chris Wilson) Date: Wed, 13 Jan 2010 12:54:57 +0100 (CET) Subject: [Boxbackup-dev] doxygen In-Reply-To: <201001131138.15643.boxbackup-dev@functions-net.nl> References: <201001131138.15643.boxbackup-dev@functions-net.nl> Message-ID: Hi MRK, On Wed, 13 Jan 2010, boxbackup-dev at functions-net.nl wrote: > Is there a reason for not using Doxygen style comments? I don't think it existed when work on Box Backup and the libraries was started. > I find browsing through code an efficient way to get acquainted with new > code. So if there are no objections lets start changing the comments. I'm not familiar with Doxygen. Could you start by submitting patches with some examples of how to rewrite the comments in this way, so that we can see what the impact would be? Cheers, Chris. -- _ ___ __ _ / __/ / ,__(_)_ | Chris Wilson <0000 at qwirx.com> - Cambs UK | / (_/ ,\/ _/ /_ \ | Security/C/C++/Java/Perl/SQL/HTML Developer | \ _/_/_/_//_/___/ | We are GNU-free your mind-and your software | From boxbackup-dev at functions-net.nl Thu Jan 14 14:05:11 2010 From: boxbackup-dev at functions-net.nl (Mick Kappenburg) Date: Thu, 14 Jan 2010 15:05:11 +0100 Subject: [Boxbackup-dev] doxygen In-Reply-To: References: <201001131138.15643.boxbackup-dev@functions-net.nl> Message-ID: <201001141505.15421.boxbackup-dev@functions-net.nl> No patch like requested but an example and some explanation. The easiest way would be to change all // 's to /// for all class and function documentation. For readability some spacing needs to be included, separating the different parts (Name, Purpose and Created). A newline after Function adds to its readability. The @returns gives a better formatted document. This process could be automated quite easily I guess. The comments would look something like the following: /// -------------------------------------------------------------------------- /// /// Function \n /// Name: BackupStoreFile::EncodeFile(IOStream &, IOStream &) /// /// Purpose: Encode a file into something for storing on file server. /// Requires a real filename so full info can be stored. /// /// @returns a stream. Most of the work is done by the stream /// when data is actually requested -- the file will be held /// open until the stream is deleted or the file finished. /// /// Created: 2003/08/28 /// /// -------------------------------------------------------------------------- Sadly the easiest way is not close to the best way in my opinion. If you are unfamiliar with doxygen you could have a look at http://www.stack.nl/~dimitri/doxygen/manual.html I propose to drop the redundant 'function' and part and question the 'Created' date line (but maybe there is a reason for it which is not apparent for a newbie to the code). Of course doxygen's options should be used, changing above comment to: /** * Encode a file into something for storing on file server. * Requires a real filename so full info can be stored. * @param Filename < description here > * @param ContainerID < description here > * @param rStoreFilename < description here > * @param pModificationTime < description here > default 0 * @param pLogger < description here > default NULL * @param pRunStatusProvider < description here > default NULL * * @returns a stream. Most of the work is done by the stream * when data is actually requested. * @note The file will be held open until the stream is * deleted or the file finished. * * @date Created: 2003/08/28 */ (A box of * can be made on top and bottom if desired.) An other thing about the documentation. It would be nice if all documentation would (at least) go in the header files. This makes the header file the only file needed to be inspected to understand what is going on. The cpp files then only reveal how it is done. At the present if you want to use the libs you need to read the cpp files for the comments and the header files for all code which is not in the cpp files, which turns out to be a lot (inline functions, class declarations etc.) Regards, MRK > Hi MRK, > > On Wed, 13 Jan 2010, boxbackup-dev at functions-net.nl wrote: > > Is there a reason for not using Doxygen style comments? > > I don't think it existed when work on Box Backup and the libraries was > started. > > > I find browsing through code an efficient way to get acquainted with new > > code. So if there are no objections lets start changing the comments. > > I'm not familiar with Doxygen. Could you start by submitting patches with > some examples of how to rewrite the comments in this way, so that we can > see what the impact would be? > > Cheers, Chris. > From trac at boxbackup.org Sat Jan 16 12:00:00 2010 From: trac at boxbackup.org (trac at boxbackup.org) Date: Sat, 16 Jan 2010 12:00:00 +0000 (GMT) Subject: [Boxbackup-dev] Current open tickets Message-ID: <20100116120001.6FD5B32602E@www.boxbackup.org> Note: to view an indiviual ticket, use: https://www.boxbackup.org/trac/ticket/(number) The following is a listing of current problems submitted by Box Backup users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Ticket Owner Component Summary - ------ ------ ------------- ------------------------------------------------------------ n 4 martin box libraries Port Box Backup to AIX n 6 box libraries Contribute code: SMTP client, HTTP server, Database drivers, n 7 box libraries Improve restore speed on local repositories n 8 chris box libraries Improve handling of directories with many files n 13 chris bbackupd Fix file locking on Windows n 14 chris bbackupd Fix large file issues on Windows n 16 chris bbackupquery Restore deleted directories may fail a 17 chris bbackupquery List files using wildcards a 20 chris bbackupctl bbackupctl reload reports prior settings n 45 ben bbackupd File diff performance patch (reduced disk IO and wall time n 46 chris bbackupd bbackupd only ever saves reverse diffs, corrupted files on s n 47 chris bbackupd Account numbers greater than 2^31 (0x7fffffff) do not work c n 48 chris bbackupd Locations that don't exist on first run are never tried agai n 49 chris bbackupd ID map (rename tracking) broken since [288] n 50 chris bbackupquery No way to capture stderr under Windows n 51 chris bbackupd No way to force bbackupd to re-upload files under Windows n 52 chris bbackupd Unable to control the maintenance of old vs. deleted files n 53 chris bbackupd Comparing root directory locations does not work under Windo n 54 chris bbackupd Locations not found on disk (e.g. unmounted filesystems) can n 55 chris bbackupd Should store and preserve directory timestamps n 56 bbackupquery Windows: User can polute restore directory by adding a trail n 57 ben bbackupd Create boxbackupresume and other files in DataDirectory n 58 ben bbackupd bbackupquery connection timeout results in error message, sh n 59 ben bbackupd Inconsistent treatment of NotifyScript between Box Backup an n 60 ben bbstored Case sensitivity between bbstored-certs and Boxi n 61 ben bbackupd File statistics: Log the number of uploaded files in additio n 62 ben bbackupd Backups of deleted files may be removed very quickly by hous n 63 ben bbackupd Support hard links in directories 28 tickets total. From boxbackup-dev at functions-net.nl Tue Jan 19 15:58:52 2010 From: boxbackup-dev at functions-net.nl (Mick Kappenburg) Date: Tue, 19 Jan 2010 16:58:52 +0100 Subject: [Boxbackup-dev] doxygen In-Reply-To: <201001141505.15421.boxbackup-dev@functions-net.nl> References: <201001131138.15643.boxbackup-dev@functions-net.nl> <201001141505.15421.boxbackup-dev@functions-net.nl> Message-ID: <201001191658.54386.boxbackup-dev@functions-net.nl> I created a script for changing the comment. The comment is converted to the /** ... */ example (no extra text, like param, is added). It worked for me (with convertComment as attached): find -name \*.h -exec bash -c '~/convertComment < {} > {}.new;mv {}.new {} && echo {}' \; Regards, MRK On Thursday 14 January 2010, Mick Kappenburg wrote: > No patch like requested but an example and some explanation. > > The easiest way would be to change all // 's to /// for all class and > function documentation. For readability some spacing needs to be included, > separating the different parts (Name, Purpose and Created). A newline > after Function adds to its readability. The @returns gives a better > formatted document. This process could be automated quite easily I guess. > The comments would look something like the following: > > /// > -------------------------------------------------------------------------- > /// > /// Function \n > /// Name: BackupStoreFile::EncodeFile(IOStream &, IOStream &) > /// > /// Purpose: Encode a file into something for storing on file server. > /// Requires a real filename so full info can be stored. > /// > /// @returns a stream. Most of the work is done by the stream > /// when data is actually requested -- the file will be held > /// open until the stream is deleted or the file finished. > /// > /// Created: 2003/08/28 > /// > /// > -------------------------------------------------------------------------- > > Sadly the easiest way is not close to the best way in my opinion. If you > are unfamiliar with doxygen you could have a look at > http://www.stack.nl/~dimitri/doxygen/manual.html > I propose to drop the redundant 'function' and part and question the > 'Created' date line (but maybe there is a reason for it which is not > apparent for a newbie to the code). Of course doxygen's options should be > used, changing above comment to: > > /** > * Encode a file into something for storing on file server. > * Requires a real filename so full info can be stored. > * @param Filename < description here > > * @param ContainerID < description here > > * @param rStoreFilename < description here > > * @param pModificationTime < description here > default 0 > * @param pLogger < description here > default NULL > * @param pRunStatusProvider < description here > default NULL > * > * @returns a stream. Most of the work is done by the stream > * when data is actually requested. > * @note The file will be held open until the stream is > * deleted or the file finished. > * > * @date Created: 2003/08/28 > */ > (A box of * can be made on top and bottom if desired.) > > An other thing about the documentation. It would be nice if all > documentation would (at least) go in the header files. This makes the > header file the only file needed to be inspected to understand what is > going on. The cpp files then only reveal how it is done. At the present if > you want to use the libs you need to read the cpp files for the comments > and the header files for all code which is not in the cpp files, which > turns out to be a lot (inline functions, class declarations etc.) > > Regards, > MRK > > > Hi MRK, > > > > On Wed, 13 Jan 2010, boxbackup-dev at functions-net.nl wrote: > > > Is there a reason for not using Doxygen style comments? > > > > I don't think it existed when work on Box Backup and the libraries was > > started. > > > > > I find browsing through code an efficient way to get acquainted with > > > new code. So if there are no objections lets start changing the > > > comments. > > > > I'm not familiar with Doxygen. Could you start by submitting patches with > > some examples of how to rewrite the comments in this way, so that we can > > see what the impact would be? > > > > Cheers, Chris. > > _______________________________________________ > Boxbackup-dev mailing list > Boxbackup-dev at boxbackup.org > http://lists.boxbackup.org/cgi-bin/mailman/listinfo/boxbackup-dev > -------------- next part -------------- A non-text attachment was scrubbed... Name: convertComment.gz Type: application/x-gzip Size: 736 bytes Desc: not available URL: From trac at boxbackup.org Sat Jan 23 12:00:00 2010 From: trac at boxbackup.org (trac at boxbackup.org) Date: Sat, 23 Jan 2010 12:00:00 +0000 (GMT) Subject: [Boxbackup-dev] Current open tickets Message-ID: <20100123120001.45A8A32602E@www.boxbackup.org> Note: to view an indiviual ticket, use: https://www.boxbackup.org/trac/ticket/(number) The following is a listing of current problems submitted by Box Backup users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Ticket Owner Component Summary - ------ ------ ------------- ------------------------------------------------------------ n 4 martin box libraries Port Box Backup to AIX n 6 box libraries Contribute code: SMTP client, HTTP server, Database drivers, n 7 box libraries Improve restore speed on local repositories n 8 chris box libraries Improve handling of directories with many files n 13 chris bbackupd Fix file locking on Windows n 14 chris bbackupd Fix large file issues on Windows n 16 chris bbackupquery Restore deleted directories may fail a 17 chris bbackupquery List files using wildcards a 20 chris bbackupctl bbackupctl reload reports prior settings n 45 ben bbackupd File diff performance patch (reduced disk IO and wall time n 46 chris bbackupd bbackupd only ever saves reverse diffs, corrupted files on s n 47 chris bbackupd Account numbers greater than 2^31 (0x7fffffff) do not work c n 48 chris bbackupd Locations that don't exist on first run are never tried agai n 49 chris bbackupd ID map (rename tracking) broken since [288] n 50 chris bbackupquery No way to capture stderr under Windows n 51 chris bbackupd No way to force bbackupd to re-upload files under Windows n 52 chris bbackupd Unable to control the maintenance of old vs. deleted files n 53 chris bbackupd Comparing root directory locations does not work under Windo n 54 chris bbackupd Locations not found on disk (e.g. unmounted filesystems) can n 55 chris bbackupd Should store and preserve directory timestamps n 56 bbackupquery Windows: User can polute restore directory by adding a trail n 57 ben bbackupd Create boxbackupresume and other files in DataDirectory n 58 ben bbackupd bbackupquery connection timeout results in error message, sh n 59 ben bbackupd Inconsistent treatment of NotifyScript between Box Backup an n 60 ben bbstored Case sensitivity between bbstored-certs and Boxi n 61 ben bbackupd File statistics: Log the number of uploaded files in additio n 62 ben bbackupd Backups of deleted files may be removed very quickly by hous n 63 ben bbackupd Support hard links in directories 28 tickets total. From trac at boxbackup.org Sat Jan 30 12:00:01 2010 From: trac at boxbackup.org (trac at boxbackup.org) Date: Sat, 30 Jan 2010 12:00:01 +0000 (GMT) Subject: [Boxbackup-dev] Current open tickets Message-ID: <20100130120001.DCC56325FF4@www.boxbackup.org> Note: to view an indiviual ticket, use: https://www.boxbackup.org/trac/ticket/(number) The following is a listing of current problems submitted by Box Backup users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Ticket Owner Component Summary - ------ ------ ------------- ------------------------------------------------------------ n 4 martin box libraries Port Box Backup to AIX n 6 box libraries Contribute code: SMTP client, HTTP server, Database drivers, n 7 box libraries Improve restore speed on local repositories n 8 chris box libraries Improve handling of directories with many files n 13 chris bbackupd Fix file locking on Windows n 14 chris bbackupd Fix large file issues on Windows n 16 chris bbackupquery Restore deleted directories may fail a 17 chris bbackupquery List files using wildcards a 20 chris bbackupctl bbackupctl reload reports prior settings n 45 ben bbackupd File diff performance patch (reduced disk IO and wall time n 46 chris bbackupd bbackupd only ever saves reverse diffs, corrupted files on s n 47 chris bbackupd Account numbers greater than 2^31 (0x7fffffff) do not work c n 48 chris bbackupd Locations that don't exist on first run are never tried agai n 49 chris bbackupd ID map (rename tracking) broken since [288] n 50 chris bbackupquery No way to capture stderr under Windows n 51 chris bbackupd No way to force bbackupd to re-upload files under Windows n 52 chris bbackupd Unable to control the maintenance of old vs. deleted files n 53 chris bbackupd Comparing root directory locations does not work under Windo n 54 chris bbackupd Locations not found on disk (e.g. unmounted filesystems) can n 55 chris bbackupd Should store and preserve directory timestamps n 56 bbackupquery Windows: User can polute restore directory by adding a trail n 57 ben bbackupd Create boxbackupresume and other files in DataDirectory n 58 ben bbackupd bbackupquery connection timeout results in error message, sh n 59 ben bbackupd Inconsistent treatment of NotifyScript between Box Backup an n 60 ben bbstored Case sensitivity between bbstored-certs and Boxi n 61 ben bbackupd File statistics: Log the number of uploaded files in additio n 62 ben bbackupd Backups of deleted files may be removed very quickly by hous n 63 ben bbackupd Support hard links in directories 28 tickets total.