Reacted on advise from Helmut Grohne to avoid confusion of doxygen

This commit is contained in:
Thomas Schmitt 2013-08-04 12:45:31 +00:00
parent a9958f1e04
commit 0772360530
2 changed files with 14 additions and 12 deletions

View File

@ -1 +1 @@
#define Cdrskin_timestamP "2013.08.04.100247" #define Cdrskin_timestamP "2013.08.04.124449"

View File

@ -3760,18 +3760,20 @@ typedef int (*burn_abort_handler_t)(void *handle, int signum, int flag);
0 Same as 1 (for pre-0.7.8 backward compatibility) 0 Same as 1 (for pre-0.7.8 backward compatibility)
@since 0.7.8 @since 0.7.8
1 Catch the control thread in abort handler, call 1 Catch the control thread in abort handler, call
burn_abort(>0) and finally exit(1). burn_abort() with a patience value > 0 and
finally exit(1). Does not always work with FreeBSD.
2 Call burn_abort() with patience -1 and return from
handler. When the control thread calls
burn_drive_get_status(), then call burn_abort()
with patience 1 instead, and finally exit(1).
Does not always work with FreeBSD. Does not always work with FreeBSD.
2 Call burn_abort(-1) and return from handler. When the 3 Call burn_abort() with patience -1, return from handler.
control thread calls burn_drive_get_status(), then do It is duty of the application to detect a pending abort
burn_abort(>0) instead, and finally exit(1). condition by calling burn_is_aborting() and to wait for
Does not always work with FreeBSD. all drives to become idle. E.g. by calling burn_abort()
3 Call burn_abort(-1), return from handler. It is duty of with patience >0.
the application to detect a pending abort condition 4 Like 3, but without calling burn_abort() with -1. Only
by calling burn_is_aborting() and to wait for all the indicator of burn_is_aborting() gets set.
drives to become idle. E.g. by calling burn_abort(>0).
4 Like 3, but without calling burn_abort(-1). Only the
indicator of burn_is_aborting() gets set.
bit8: @since 1.3.2 bit8: @since 1.3.2
try to ignore SIGPIPE (regardless of bit0 - bit3) try to ignore SIGPIPE (regardless of bit0 - bit3)