From 776641ef5dcc932207f373db3b1f0b94e1f88584 Mon Sep 17 00:00:00 2001 From: Thierry Moisan Date: Tue, 12 Aug 2008 19:51:30 -0400 Subject: [PATCH] Adding documentation to NTuple --- NTuple.i | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/NTuple.i b/NTuple.i index 4ba8ce2..ddf43e8 100644 --- a/NTuple.i +++ b/NTuple.i @@ -24,4 +24,59 @@ gsl_ntuple_close /; %EXPORT_TAGS = ( all => [ @EXPORT_OK ] ); + +__END__ + +=head1 NAME + +Math::GSL::NTuple - Functions for creating and manipulating ntuples, sets of values associated with events + +=head1 SYNOPSIS + +This module is not yet implemented. Patches Welcome! + +use Math::GSL::NTuple qw /:all/; + +=head1 DESCRIPTION + +Here is a list of all the functions in this module : + +=over + +=item * - This function opens an existing ntuple file $filename for reading and returns a pointer to a corresponding ntuple struct. The ntuples in the file must have size $size. A pointer to memory for the current ntuple row $ntuple_data, which is an array reference, must be supplied—this is used to copy ntuples in and out of the file. + +=item * - This function creates a new write-only ntuple file $filename for ntuples of size $size and returns a pointer to the newly created ntuple struct. Any existing file with the same name is truncated to zero length and overwritten. A pointer to memory for the current ntuple row $ntuple_data, which is an array reference, must be supplied—this is used to copy ntuples in and out of the file. + + +=item * - This function writes the current $ntuple $ntuple->{ntuple_data} of size $ntuple->{size} to the corresponding file. + +=item * - This function is a synonym for gsl_ntuple_write. + +=item * - This function reads the current row of the ntuple file for ntuple and stores the values in $ntuple->{data}. + +=item * + +=item * - This function closes the ntuple file ntuple and frees its associated allocated memory. + +=back + +For more informations on the functions, we refer you to the GSL offcial +documentation: L + + Tip : search on google: site:http://www.gnu.org/software/gsl/manual/html_node/ name_of_the_function_you_want + + +=head1 AUTHORS + +Jonathan Leto and Thierry Moisan + +=head1 COPYRIGHT AND LICENSE + +Copyright (C) 2008 Jonathan Leto and Thierry Moisan + +This program is free software; you can redistribute it and/or modify it +under the same terms as Perl itself. + +=cut + %} -- 2.11.4.GIT