diff --git a/configure.ac b/configure.ac index 74afa75012b..a61c1a0a98d 100644 --- a/configure.ac +++ b/configure.ac @@ -104,7 +104,6 @@ AC_ARG_ENABLE([docs], [enable building of documentation with doxygen.])]) test "x$enable_docs" = xyes || enable_docs=no AC_MSG_RESULT([$enable_docs]) -AM_CONDITIONAL(BUILD_DOCS, [test "x$enable_docs" = xyes]) # Does the user want to developer documentation? AC_MSG_CHECKING([whether PIO developer documentation should be build (only for PIO developers)]) @@ -118,6 +117,7 @@ AC_MSG_RESULT([$enable_developer_docs]) if test "x$enable_developer_docs" = xyes; then enable_docs=yes fi +AM_CONDITIONAL(BUILD_DOCS, [test "x$enable_docs" = xyes]) # Is doxygen installed? AC_CHECK_PROGS([DOXYGEN], [doxygen]) diff --git a/doc/source/GettingStarted.txt b/doc/source/Introduction.txt similarity index 98% rename from doc/source/GettingStarted.txt rename to doc/source/Introduction.txt index 794c985af37..a5f72b49d53 100644 --- a/doc/source/GettingStarted.txt +++ b/doc/source/Introduction.txt @@ -1,6 +1,6 @@ @tableofcontents -/*! @page intro Introduction +/** @page intro Introduction PIO is a software interface layer designed to encapsolate the complexities of parallel IO and make it easier to replace the lower diff --git a/doc/source/Makefile.am b/doc/source/Makefile.am index 74fbc779139..074738846c8 100644 --- a/doc/source/Makefile.am +++ b/doc/source/Makefile.am @@ -4,5 +4,5 @@ EXTRA_DIST = api.txt CAMexample.txt Decomp.txt faq.txt Installing.txt \ Testing.txt base.txt c_api.txt contributing_code.txt Error.txt \ -Examples.txt GettingStarted.txt mach_walkthrough.txt \ +Examples.txt Introduction.txt mach_walkthrough.txt \ testpio_example.txt diff --git a/doc/source/contributing_code.txt b/doc/source/contributing_code.txt index dba93b20887..cf7df469c19 100644 --- a/doc/source/contributing_code.txt +++ b/doc/source/contributing_code.txt @@ -133,103 +133,5 @@ hours). Any test failures and the merge to master may be rolled back. -## Formatting Example ## - -
-/** 
- * \@ingroup PIOc_inq_attname
- * The PIO-C interface for the NetCDF function nc_inq_attname.
- *
- * This routine is called collectively by all tasks in the communicator 
- * ios.union_comm. For more information on the underlying NetCDF commmand
- * please read about this function in the NetCDF documentation at: 
- * http://www.unidata.ucar.edu/software/netcdf/docs/group__attributes.html
- *
- * \@param ncid the ncid of the open file, obtained from
- * PIOc_openfile() or PIOc_createfile().
- * \@param varid the variable ID.
- * \@param attnum the attribute ID.
- * \@return PIO_NOERR for success, error code otherwise.  See PIOc_Set_File_Error_Handling
- */
-int PIOc_inq_attname(int ncid, int varid, int attnum, char *name) 
-{
-    iosystem_desc_t *ios;  /* Pointer to io system information. */
-    file_desc_t *file;     /* Pointer to file information. */
-    int ierr = PIO_NOERR;  /* Return code from function calls. */
-    int mpierr = MPI_SUCCESS, mpierr2;  /* Return code from MPI function codes. */
-
-    LOG((1, "PIOc_inq_attname ncid = %d varid = %d attnum = %d", ncid, varid,
-         attnum));
-
-    /* Find the info about this file. */
-    if (!(file = pio_get_file_from_id(ncid)))
-        return PIO_EBADID;
-    ios = file->iosystem;
-
-    /* If async is in use, and this is not an IO task, bcast the parameters. */
-    if (ios->async_interface)
-    {
-        if (!ios->ioproc)
-        {
-            int msg = PIO_MSG_INQ_ATTNAME;
-            char name_present = name ? true : false;
-
-            if(ios->compmaster) 
-                mpierr = MPI_Send(&msg, 1,MPI_INT, ios->ioroot, 1, ios->union_comm);
-            
-            if (!mpierr)
-                mpierr = MPI_Bcast(&ncid, 1, MPI_INT, ios->compmaster, ios->intercomm);
-            if (!mpierr)
-                mpierr = MPI_Bcast(&varid, 1, MPI_INT, ios->compmaster, ios->intercomm);
-            if (!mpierr)
-                mpierr = MPI_Bcast(&attnum, 1, MPI_INT, ios->compmaster, ios->intercomm);
-            if (!mpierr)
-                mpierr = MPI_Bcast(&name_present, 1, MPI_CHAR, ios->compmaster, ios->intercomm);
-        }
-
-        /* Handle MPI errors. */
-        if ((mpierr2 = MPI_Bcast(&mpierr, 1, MPI_INT, ios->comproot, ios->my_comm)))
-            check_mpi(file, mpierr2, __FILE__, __LINE__);
-        if (mpierr)
-            return check_mpi(file, mpierr, __FILE__, __LINE__);
-    }
-
-    /* If this is an IO task, then call the netCDF function. */
-    if (ios->ioproc)
-    {
-\#ifdef _PNETCDF
-        if (file->iotype == PIO_IOTYPE_PNETCDF)
-            ierr = ncmpi_inq_attname(file->fh, varid, attnum, name);
-\#endif /* _PNETCDF */
-\#ifdef _NETCDF
-        if (file->iotype != PIO_IOTYPE_PNETCDF && file->do_io)
-            ierr = nc_inq_attname(file->fh, varid, attnum, name);
-\#endif /* _NETCDF */
-        LOG((2, "PIOc_inq_attname netcdf call returned %d", ierr));
-    }
-
-    /* Broadcast and check the return code. */
-    if ((mpierr = MPI_Bcast(&ierr, 1, MPI_INT, ios->ioroot, ios->my_comm)))
-    {
-        check_mpi(file, mpierr, __FILE__, __LINE__);            
-        return PIO_EIO;
-    }
-    check_netcdf(file, ierr, __FILE__, __LINE__);
-    
-    /* Broadcast results to all tasks. Ignore NULL parameters. */
-    if (!ierr)
-        if (name)
-        {
-            int namelen = strlen(name);
-            if ((mpierr = MPI_Bcast(&namelen, 1, MPI_INT, ios->ioroot, ios->my_comm)))
-                check_mpi(file, mpierr, __FILE__, __LINE__);
-            if ((mpierr = MPI_Bcast((void *)name, namelen + 1, MPI_CHAR, ios->ioroot,
-                                    ios->my_comm)))
-                check_mpi(file, mpierr, __FILE__, __LINE__);
-        }
-
-    return ierr;
-}
-
*/