Changeset 1039

Show
Ignore:
Timestamp:
06/04/07 14:34:34 (2 years ago)
Author:
kraftche
Message:

Fix numerous typos and spelling mistakes

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • MOAB/trunk/mhdf/include/mhdf.h

    r990 r1039  
    44 *  
    55 * Copyright 2004 Sandia Corporation.  Under the terms of Contract 
    6  * DE-AC04-94AL85000 with Sandia Coroporation, the U.S. Government 
     6 * DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government 
    77 * retains certain rights in this software. 
    88 *  
     
    144144 *                   should be used.  If a constant does not exist for 
    145145 *                   the type, a similar naming pattern should be used 
    146  *                   (accepted name for type, first charaster uppercase, 
     146 *                   (accepted name for type, first character uppercase, 
    147147 *                   subsequent characters lowercase.)  The element type 
    148148 *                   index passed to \ref mhdf_addElement is then an 
    149149 *                   index into this list.  The array may contain 
    150  *                   null entires to allow the caller some control over 
     150 *                   null entries to allow the caller some control over 
    151151 *                   the assigned indices without creating dummy types 
    152152 *                   which may confuse readers. 
     
    168168 * 
    169169 * \param filename   The path and name of the file to open 
    170  * \param writeable  If non-zero, open read-write.  Otherwise readonly. 
     170 * \param writable  If non-zero, open read-write.  Otherwise read-only. 
    171171 * \param status     Passed back status of API call. 
    172172 * \param max_id     Used to pass back the maximum global ID used in the 
     
    178178mhdf_FileHandle 
    179179mhdf_openFile( const char* filename, 
    180                int writeable, 
     180               int writable, 
    181181               unsigned long* max_id, 
    182182               mhdf_Status* status ); 
     
    193193 * 
    194194 * \param filename   The path and name of the file to open 
    195  * \param writeable  If non-zero, open read-write.  Otherwise readonly. 
     195 * \param writable  If non-zero, open read-write.  Otherwise read-only. 
    196196 * \param status     Passed back status of API call. 
    197197 * \param max_id     Used to pass back the maximum global ID used in the 
     
    200200 *                   may be passed. 
    201201 * \param options    The HDF5 access property list to use when opening 
    202  *                   the file.  See the HDF5 documenation for H5Fopen. 
     202 *                   the file.  See the HDF5 documentation for H5Fopen. 
    203203 * \return An opaque handle to the file. 
    204204 */ 
    205205mhdf_FileHandle 
    206206mhdf_openFileWithOpt( const char* filename, 
    207                       int writeable, 
     207                      int writable, 
    208208                      unsigned long* max_id, 
    209209                      hid_t options, 
     
    213213 * Fails if buffer is not of sufficient size. 
    214214 * \param file_handle The file. 
    215  * \param type_index The type index.  Corresponds to indicies into 
     215 * \param type_index The type index.  Corresponds to indices into 
    216216 *                   the element type list passed to \ref mhdf_createFile. 
    217217 * \param buffer     The buffer into which to copy the name. 
     
    236236 * 
    237237 * Close an hid_t-type handle returned from any of the following 
    238  * functions.  Any hid_t passed-back or returnd must be closed via 
    239  * this function to avoid resouce loss. 
     238 * functions.  Any hid_t passed-back or returned must be closed via 
     239 * this function to avoid resource loss. 
    240240 * 
    241241 * \param file   The file the object pointed to by the passed data 
     
    297297 * \param num_nodes    The number of nodes the table will contain. 
    298298 * \param first_node_id_out  Nodes are assigned IDs sequentially in the 
    299  *             order they occur in the table, where the ID of the fisrt 
     299 *             order they occur in the table, where the ID of the first 
    300300 *             node in the table is this passed-back value. 
    301301 * \param status     Passed back status of API call. 
     
    315315 * \param num_nodes_out    The number of nodes the table contains. 
    316316 * \param first_node_id_out  Nodes are assigned IDs sequentially in the 
    317  *             order they occur in the table, where the ID of the fisrt 
     317 *             order they occur in the table, where the ID of the first 
    318318 *             node in the table is this passed-back value. 
    319319 * \param status     Passed back status of API call. 
     
    427427 * \param file_handle  File in which to create the element type. 
    428428 * \param elem_handle  The name to use for the element data.  This 
    429  *                     name is used as an identifer to reference the 
     429 *                     name is used as an identifier to reference the 
    430430 *                     data for this element type later.  The selected 
    431431 *                     name also appears explicitly in the file and  
     
    488488/** \brief Check if an element group contains polygon or polyhedron 
    489489 * 
    490  * Check if an element group contains general polyhon or polyhedrons 
     490 * Check if an element group contains general polygon or polyhedrons 
    491491 * rather than typically fixed-connectivity elements.   
    492492 * 
     
    633633 * \param num_poly     The total number number of polygons or polyhedra to 
    634634 *                     be written in the table. 
    635  * \param data_list_length The tolal number of values to be written to the 
     635 * \param data_list_length The total number of values to be written to the 
    636636 *                     table (the number of polys plus the sum of the number 
    637637 *                     of entities in each poly's connectivity data.) 
     
    673673 * \param num_poly_out The total number number of polygons or polyhedra to 
    674674 *                     be written in the table. 
    675  * \param data_list_length_out The tolal number of values to be written to the 
     675 * \param data_list_length_out The total number of values to be written to the 
    676676 *                     table (the number of polys plus the sum of the number 
    677677 *                     of entities in each poly's connectivity data.) 
     
    711711 * This function writes the index list. 
    712712 * 
    713  * \param poly_handle  The handle returnded from  
     713 * \param poly_handle  The handle returned from  
    714714 *                     <code>mhdf_createPolyConnectivity</code> or 
    715715 *                     <code>mhdf_openPolyConnectivity</code>. 
    716716 * \param offset       The offset in the table at which to write.  The 
    717  *                     offset is in terms of the integer valus in the table, 
     717 *                     offset is in terms of the integer values in the table, 
    718718 *                     not the count of polys. 
    719719 * \param count        The size of the integer list to write. 
     
    746746 * This function writes the connectivity/ID list. 
    747747 * 
    748  * \param poly_handle  The handle returnded from  
     748 * \param poly_handle  The handle returned from  
    749749 *                     <code>mhdf_createPolyConnectivity</code> or 
    750750 *                     <code>mhdf_openPolyConnectivity</code>. 
    751751 * \param offset       The offset in the table at which to write.  The 
    752  *                     offset is in terms of the integer valus in the table, 
     752 *                     offset is in terms of the integer values in the table, 
    753753 *                     not the count of polys. 
    754754 * \param count        The size of the integer list to write. 
     
    780780 * elements.) 
    781781 * 
    782  * \param poly_handle  The handle returnded from  
     782 * \param poly_handle  The handle returned from  
    783783 *                     <code>mhdf_createPolyConnectivity</code> or 
    784784 *                     <code>mhdf_openPolyConnectivity</code>. 
    785785 * \param offset       The offset in the table at which to read.  The 
    786  *                     offset is in terms of the integer valus in the table, 
     786 *                     offset is in terms of the integer values in the table, 
    787787 *                     not the count of polys. 
    788788 * \param count        The size of the integer list to read. 
     
    813813 * elements.) 
    814814 * 
    815  * \param poly_handle  The handle returnded from  
     815 * \param poly_handle  The handle returned from  
    816816 *                     <code>mhdf_createPolyConnectivity</code> or 
    817817 *                     <code>mhdf_openPolyConnectivity</code>. 
    818818 * \param offset       The offset in the table at which to read.  The 
    819  *                     offset is in terms of the integer valus in the table, 
     819 *                     offset is in terms of the integer values in the table, 
    820820 *                     not the count of polys. 
    821821 * \param count        The size of the integer list to read. 
     
    10201020#define mhdf_SET_OWNER_BIT 0x1   
    10211021/** \brief Set cannot contain duplicates */  
    1022 #define mhdf_SET_UNIQE_BIT 0x2   
     1022#define mhdf_SET_UNIQUE_BIT 0x2   
    10231023/** \brief Set order is preserved */ 
    10241024#define mhdf_SET_ORDER_BIT 0x4   
     
    10471047 * bit in the flags specifies the format of the contents list for each set. 
    10481048 * See a description of the \ref mhdf_SET_RANGE_BIT flag for a description 
    1049  * of the two possbile data formats.  The index values in the first two columns 
     1049 * of the two possible data formats.  The index values in the first two columns 
    10501050 * of the table are the index of the <em>last</em> value for the set in the corresponding 
    10511051 * contents and children lists.  The first index is always one greater than the last index 
    10521052 * for the previous set in the table.  The first index of the first set in the table is 
    1053  * implicitly zero.  A special value of -1 in the appropraite column should be used to  
     1053 * implicitly zero.  A special value of -1 in the appropriate column should be used to  
    10541054 * indicate that the first set contains no contents or has no children.  For any other set, 
    10551055 * if the last index for the set is the same as that of the previous set, it has no data 
     
    10621062 *                    will be assigned sequential global IDs. 
    10631063 * \param status       Passed back status of API call. 
    1064  *\return The handle to the set metadata table.   
     1064 *\return The handle to the set meta-data table.   
    10651065 */ 
    10661066hid_t 
     
    11001100 *                    have sequential global IDs. 
    11011101 * \param status       Passed back status of API call. 
    1102  *\return The handle to the set metadata table.   
     1102 *\return The handle to the set meta-data table.   
    11031103 */ 
    11041104hid_t 
     
    11361136 * Read flags for each set from the set description table. 
    11371137 * See \ref mhdf_createSetMeta for a description of this data. 
    1138  *\param data_handle The handle returnd from mdhf_createSetMeta or mhdf_openSetMeta 
     1138 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 
    11391139 *\param offset      The offset (set index) at which to begin reading. 
    11401140 *\param count       The number of values (number of sets) to read. 
     
    11601160 *       first in the list will have an end index of -1. 
    11611161 *  
    1162  *\param data_handle The handle returnd from mdhf_createSetMeta or mhdf_openSetMeta 
     1162 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 
    11631163 *\param offset      The offset (set index) at which to begin reading. 
    11641164 *\param count       The number of values (number of sets) to read. 
     
    11831183 *       first in the list will have an end index of -1. 
    11841184 *  
    1185  *\param data_handle The handle returnd from mdhf_createSetMeta or mhdf_openSetMeta 
     1185 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 
    11861186 *\param offset      The offset (set index) at which to begin reading. 
    11871187 *\param count       The number of values (number of sets) to read. 
     
    12061206 *       first in the list will have an end index of -1. 
    12071207 *  
    1208  *\param data_handle The handle returnd from mdhf_createSetMeta or mhdf_openSetMeta 
     1208 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 
    12091209 *\param offset      The offset (set index) at which to begin reading. 
    12101210 *\param count       The number of values (number of sets) to read. 
     
    12511251 * The format of this data is a vector of integer values which is the 
    12521252 * concatenation of the contents list for all the meshsets.  The length 
    1253  * and format of the data for each set is stored in the set metatable. 
     1253 * and format of the data for each set is stored in the set meta table. 
    12541254 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a  
    12551255 * description of that data. 
     
    12711271 * The format of this data is a vector of integer values which is the 
    12721272 * concatenation of the contents list for all the meshsets.  The length 
    1273  * and format of the data for each set is stored in the set metatable. 
     1273 * and format of the data for each set is stored in the set meta table. 
    12741274 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a  
    12751275 * description of that data. 
     
    12901290 * The format of this data is a vector of integer values which is the 
    12911291 * concatenation of the contents list for all the meshsets.  The length 
    1292  * and format of the data for each set is stored in the set metatable. 
     1292 * and format of the data for each set is stored in the set meta table. 
    12931293 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a  
    12941294 * description of that data. 
     
    13181318 * The format of this data is a vector of integer values which is the 
    13191319 * concatenation of the contents list for all the meshsets.  The length 
    1320  * and format of the data for each set is stored in the set metatable. 
     1320 * and format of the data for each set is stored in the set meta table. 
    13211321 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a  
    13221322 * description of that data. 
     
    13461346 * The format of this data is the concatenation of the lists of 
    13471347 * global IDs of child sets for each set.  The order of the sets and 
    1348  * the number of children for each set is contained in the set metatable. 
     1348 * the number of children for each set is contained in the set meta table. 
    13491349 * (See \ref mhdf_createSetMeta ). 
    13501350 * 
     
    13791379/** \brief Create file object for storing the set parent list  
    13801380 * 
    1381  * Create a data group for the list of set prents.   
     1381 * Create a data group for the list of set parents.   
    13821382 * The format of this data is the concatenation of the lists of 
    13831383 * global IDs of parent sets for each set.  The order of the sets and 
    1384  * the number of parents for each set is contained in the set metatable. 
     1384 * the number of parents for each set is contained in the set meta table. 
    13851385 * (See \ref mhdf_createSetMeta ). 
    13861386 * 
     
    14801480 * 
    14811481 * Sparse tag data is stored as a global table pair for each tag type.  The first 
    1482  * if the pair of tables is a list of Global IDs.  The second is the correspoding 
     1482 * if the pair of tables is a list of Global IDs.  The second is the corresponding 
    14831483 * tag value for each entity in the ID list. 
    14841484 */ 
     
    15081508 * size.  
    15091509 * 
    1510  * This function is providied to allow converting the stored tag 
     1510 * This function is provided to allow converting the stored tag 
    15111511 * type in a file to the preferred type for it's representation  
    15121512 * in memory when reading tag values. 
     
    15891589 * 
    15901590 *\param file_handle      The file. 
    1591  *\param tag_name         The name of the tag to retreive the data for. 
     1591 *\param tag_name         The name of the tag to retrieve the data for. 
    15921592 *\param class_out        The TSTT class of the tag data. 
    15931593 *\param size_out         Depends on value of class_out: 
    15941594 *                        - mhdf_OPAQUE  - size of opaque data in bytes 
    15951595 *                        - mhdf_BITFIELD - number of bits 
    1596  *                        - for everything else, if the tag dats is an 
    1597  *                          array, the length of the array.  1 otherwize. 
    1598  *\param tstt_storage_out The value of the TSTT enum for storage (dense, spase, etc.) 
     1596 *                        - for everything else, if the tag data is an 
     1597 *                          array, the length of the array.  1 otherwise. 
     1598 *\param tstt_storage_out The value of the TSTT enum for storage (dense, sparse, etc.) 
    15991599 *\param have_default_out Non-zero if file contains a default value for the tag. 
    16001600 *\param have_global_out  Non-zero if the file contains a global/mesh value for the tag. 
     
    16371637/** \brief Check if the file contains dense tag data for the specified tag and element group. 
    16381638 * 
    1639  * Check if there is dense tag data for a given element type for the specfiied 
     1639 * Check if there is dense tag data for a given element type for the specified 
    16401640 * tag.   
    16411641 *