X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fdev%2Fconcepts.texi;h=64b0130e125459d0a346fa0aec7df3be1d1545f0;hb=bbe5d82770003c1309beee4e5c8231ed44885c51;hp=8d1e8ac0663604ba526332fa7c9bcf8653955f8e;hpb=fe8dc2171009e90d2335f159d05f7e6660e24780;p=pspp diff --git a/doc/dev/concepts.texi b/doc/dev/concepts.texi index 8d1e8ac066..64b0130e12 100644 --- a/doc/dev/concepts.texi +++ b/doc/dev/concepts.texi @@ -1,3 +1,13 @@ +@c PSPP - a program for statistical analysis. +@c Copyright (C) 2019 Free Software Foundation, Inc. +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.3 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". +@c + @node Basic Concepts @chapter Basic Concepts @@ -156,27 +166,6 @@ This function returns false if @func{value_init} and @func{value_destroy} are actually required for the given @var{width}. @end deftypefun -@deftypefun double value_num (const union value *@var{value}) -Returns the numeric value in @var{value}, which must have been -initialized as a numeric value. Equivalent to @code{@var{value}->f}. -@end deftypefun - -@deftypefun {const char *} value_str (const union value *@var{value}, int @var{width}) -@deftypefunx {char *} value_str_rw (union value *@var{value}, int @var{width}) -Returns the string value in @var{value}, which must have been -initialized with positive width @var{width}. The string returned is -not null-terminated. Only @var{width} bytes of returned data may be -accessed. - -The two different functions exist only for @code{const}-correctness. -Otherwise they are identical. - -It is important that @var{width} be the correct value that was passed -to @func{value_init}. Passing a smaller or larger value (e.g.@: -because that number of bytes will be accessed) will not always work -and should be avoided. -@end deftypefun - @deftypefun void value_copy (union value *@var{dst}, @ const union value *@var{src}, @ int @var{width}) @@ -609,7 +598,7 @@ Destroys @var{style}, freeing its storage. @end deftypefun @deftypefun {struct fmt_number_style} *fmt_create (void) -A function which creates an array of all the styles used by pspp, and +A function which creates an array of all the styles used by pspp, and calls fmt_number_style_init on each of them. @end deftypefun @@ -698,7 +687,7 @@ This function is declared in @file{data/data-in.h}. @deftypefunx char * data_out_legacy (const union value *@var{input}, const char *@var{encoding}, const struct fmt_spec *@var{format}) Converts the data pointed to by @var{input} into a string value, which will be encoded in UTF-8, according to output format specifier @var{format}. -Format +Format must be a valid output format. The width of @var{input} is inferred from @var{format} using an algorithm equivalent to @func{fmt_var_width}. @@ -1356,7 +1345,7 @@ Looks for a label for @var{value} in @var{var}'s set of value labels. @var{value} must have the same width as @var{var}. If a label exists, it will be appended to the string pointed to by @var{str}. Otherwise, it formats @var{value} -using @var{var}'s print format (@pxref{Input and Output Formats}) +using @var{var}'s print format (@pxref{Input and Output Formats}) and appends the formatted string. @end deftypefun