summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorswhite <swhite@17b73243-c579-4c4c-a9d2-2d5706c11dac>2005-02-09 14:33:06 +0000
committerswhite <swhite@17b73243-c579-4c4c-a9d2-2d5706c11dac>2005-02-09 14:33:06 +0000
commitc56cfa74b4df162b9b0347d1e4595db5c02fa9b9 (patch)
tree513b1343cc5128b1154b4f6b0a9d9d384164c800
parent16008bcab30364add2d5ca758c5e832c0191cf0d (diff)
Better explanation of nchars
Fixed formatting Explained that boxed comment pertains to C Explained how Reals are formatted git-svn-id: http://svn.cactuscode.org/flesh/trunk@3984 17b73243-c579-4c4c-a9d2-2d5706c11dac
-rw-r--r--doc/ReferenceManual/CCTKReference.tex12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/ReferenceManual/CCTKReference.tex b/doc/ReferenceManual/CCTKReference.tex
index c72d1d44..1b800518 100644
--- a/doc/ReferenceManual/CCTKReference.tex
+++ b/doc/ReferenceManual/CCTKReference.tex
@@ -7389,8 +7389,8 @@ end subroutine
\begin{ResultSection}
\begin{Result}{valstring}
-Pointer to parameter value as string. \em{The memory for this string
-must be released with a call to} \code{free} \em{after it has been used.}
+Pointer to parameter value as string. \emph{The memory for this string
+must be released with a call to} \code{free()} \emph{after it has been used.}
\end{Result}
\end{ResultSection}
@@ -7407,20 +7407,22 @@ On exit, the number of characters in the stringified parameter value,
or $-1$ if the parameter doesn't exist
\end{Parameter}
\begin{Parameter}{value}
-On exit, contains as many characters of the parameter name as fit into the
-Fortran string provided.
+On exit, contains as many characters of the stringified parameter value as
+fit into the Fortran string provided.
You should check for truncation by comparing \code{nchars} against the length
of your Fortran string.
\end{Parameter}
\end{ParameterSection}
\begin{Discussion}
-\fbox{The string \code{valstring} must be freed afterwards.}
+\fbox{In C, the string \code{valstring} must be freed afterwards.}
The thorn or implementation name must be the name of the place where
the parameter is originally defined. It is not possible to pass the
thorn or implementation name of a thorn that merely declares the
parameter as used.
+
+Real variables are formatted according to the C \code{"\%.20g"} format.
\end{Discussion}
\begin{SeeAlsoSection}