From f7bbad96be3a48ae1f696eda95d20558db0bf843 Mon Sep 17 00:00:00 2001
From: Gilles Gouaillardet <gilles@rist.or.jp>
Date: Tue, 2 Jun 2015 19:08:24 +0900
Subject: [PATCH] MPI_Win_create_dynamic : add man page

---
 ompi/mpi/man/man3/MPI_Win_create_dynamic.3in | 81 ++++++++++++++++++++
 ompi/mpi/man/man3/Makefile.extra             |  1 +
 2 files changed, 82 insertions(+)
 create mode 100644 ompi/mpi/man/man3/MPI_Win_create_dynamic.3in

diff --git a/ompi/mpi/man/man3/MPI_Win_create_dynamic.3in b/ompi/mpi/man/man3/MPI_Win_create_dynamic.3in
new file mode 100644
index 0000000000..9f882d2102
--- /dev/null
+++ b/ompi/mpi/man/man3/MPI_Win_create_dynamic.3in
@@ -0,0 +1,81 @@
+.\" -*- nroff -*-
+.\" Copyright (c) 2015      Research Organization for Information Science
+.\"                         and Technology (RIST). All rights reserved.
+.\" $COPYRIGHT$
+.TH MPI_Win_create_dynamic 3 "#OMPI_DATE#" "#PACKAGE_VERSION#" "#PACKAGE_NAME#"
+.SH NAME
+\fBMPI_Win_create_dynamic\fP \- One-sided MPI call that returns a window object for RMA operations.
+
+.SH SYNTAX
+.ft R
+.SH C Syntax
+.nf
+#include <mpi.h>
+MPI_Win_create_dynamic(MPI_Info \fIinfo\fP, MPI_Comm \fIcomm\fP, MPI_Win *\fIwin\fP)
+
+.fi
+.SH Fortran Syntax
+.nf
+INCLUDE 'mpif.h'
+MPI_WIN_CREATE_DYNAMIC(\fIINFO, COMM, WIN, IERROR\fP)
+	INTEGER \fIINFO, COMM, WIN, IERROR\fP
+
+.fi
+.SH INPUT PARAMETERS
+.ft R
+.TP 1i
+info
+Info argument (handle).
+.TP 1i
+comm
+Communicator (handle).
+
+.SH OUTPUT PARAMETERS
+.ft R
+.TP 1i
+win
+Window object returned by the call (handle). 
+.TP 1i
+IERROR
+Fortran only: Error status (integer). 
+
+.SH DESCRIPTION
+.ft R
+MPI_Win_create_dynamic is a one-sided MPI communication collective call executed by all processes in the group of \fIcomm\fP. It returns a window object without memory attached that can be used by these processes to perform RMA operations.
+.sp
+The following info keys are supported:
+.ft R
+.TP 1i
+no_locks 
+If set to \fItrue\fP, then the implementation may assume that the local
+window is never locked (by a call to MPI_Win_lock or
+MPI_Win_lock_all).  Setting this value if only active synchronization
+may allow the implementation to enable certain optimizations.
+.sp 
+.TP 1i
+accumulate_ordering
+By default, accumulate operations from one initiator to one target on
+the same window are strictly ordered.  If the info key
+accumulate_ordering is set to \fInone\fP, no ordering of accumulate
+operations guaranteed.  They key can also be a comma-separated list of
+required orderings consisting of \fIrar\fP, \fIwar\fP, \fIraw\fP, and \fIwaw\fP for
+read-after-read, write-after-read, read-after-write, and
+write-after-write, respectively.  Looser ordering constraints are
+likely to result in improved performance.
+.sp 
+.TP 1i
+accumulate_ops
+If set to \fIsame_op\fP, the implementation will assume that all concurrent
+accumulate calls to the same target address will use the same
+operation.  If set to \fIsame_op_no_op\fP, then the implementation will
+assume that all concurrent accumulate calls to the same target address
+will use the same operation or MPI_NO_OP.  The default is \fIsame_op_no_op\fP.
+
+.SH ERRORS
+Almost all MPI routines return an error value; C routines as the value of the function and Fortran routines in the last argument.
+.sp
+Before the error value is returned, the current MPI error handler is
+called. By default, this error handler aborts the MPI job, except for I/O function errors. The error handler may be changed with MPI_Comm_set_errhandler; the predefined error handler MPI_ERRORS_RETURN may be used to cause error values to be returned. Note that MPI does not guarantee that an MPI program can continue past an error.  
+
+ 
+
diff --git a/ompi/mpi/man/man3/Makefile.extra b/ompi/mpi/man/man3/Makefile.extra
index db8cd2d311..442b5a5cf9 100644
--- a/ompi/mpi/man/man3/Makefile.extra
+++ b/ompi/mpi/man/man3/Makefile.extra
@@ -383,6 +383,7 @@ mpi_api_man_pages = \
         mpi/man/man3/MPI_Win_call_errhandler.3 \
         mpi/man/man3/MPI_Win_complete.3 \
         mpi/man/man3/MPI_Win_create.3 \
+        mpi/man/man3/MPI_Win_create_dynamic.3 \
         mpi/man/man3/MPI_Win_create_errhandler.3 \
         mpi/man/man3/MPI_Win_create_keyval.3 \
         mpi/man/man3/MPI_Win_delete_attr.3 \