From bad0ff24a658e71e40bc2b5afbbaeb5aa6acd643 Mon Sep 17 00:00:00 2001 From: schnetter Date: Sun, 7 May 2006 22:09:28 +0000 Subject: Describe the RECOVER_PARAMETERS bin better. git-svn-id: http://svn.cactuscode.org/flesh/trunk@4289 17b73243-c579-4c4c-a9d2-2d5706c11dac --- doc/UsersGuide/Appendices.tex | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/UsersGuide/Appendices.tex b/doc/UsersGuide/Appendices.tex index 6c12931d..3ef375ac 100644 --- a/doc/UsersGuide/Appendices.tex +++ b/doc/UsersGuide/Appendices.tex @@ -1199,10 +1199,15 @@ end The return value in {\tt CCTK\_STARTUP} and {\tt CCTK\_SHUTDOWN} is unused, and might in the future be used to indicate whether an error -occurred. You should return 0. The return value in {\tt - CCTK\_RECOVER\_PARAMETERS} should be zero, positive, or negative, -indicating that no parameters were recovered, that parameters were -recovered successfully, or that an error occurred, respectively. +occurred. You should return 0. + +The return value in {\tt CCTK\_RECOVER\_PARAMETERS} should be zero, +positive, or negative, indicating that no parameters were recovered, +that parameters were recovered successfully, or that an error +occurred, respectively. Only the first routine that returns a +positive value in the {\tt CCTK\_RECOVER\_PARAMETERS} bin will be +executed; all later routines will be ignored. The execution order in +this bin is unspecified. @@ -1211,7 +1216,9 @@ recovered successfully, or that an error occurred, respectively. \item[{\tt CCTK\_RECOVER\_PARAMETERS}] Used by thorns with relevant IO methods as the point to read parameters when recovering from checkpoint files. - Grid variables are not available in this timebin. + Grid variables are not available in this timebin. This bin is + special (see above); do not schedule any routines here except + if they recover parameters. \item[{\tt CCTK\_STARTUP}] Run before any grids are constructed, this is -- cgit v1.2.3