Merge trunk version 194962 into gupc branch.
[official-gcc.git] / libgupc / libgupc.texi
blob9ce2a82b55d621e9df33d0d4d7e85c317613e17d
1 \input texinfo @c -*-texinfo-*-
3 @c %**start of header
4 @setfilename libgupc.info
5 @settitle GNU libgupc
6 @c %**end of header
9 @copying
10 Copyright @copyright{} 2006, 2007, 2008, 2009, 2010, 2011
11 Free Software Foundation, Inc.
13 Permission is granted to copy, distribute and/or modify this document
14 under the terms of the GNU Free Documentation License, Version 1.2 or
15 any later version published by the Free Software Foundation; with the
16 Invariant Sections being ``Funding Free Software'', the Front-Cover
17 texts being (a) (see below), and with the Back-Cover Texts being (b)
18 (see below).  A copy of the license is included in the section entitled
19 ``GNU Free Documentation License''.
21 (a) The FSF's Front-Cover Text is:
23      A GNU Manual
25 (b) The FSF's Back-Cover Text is:
27      You have freedom to copy and modify this GNU Manual, like GNU
28      software.  Copies published by the Free Software Foundation raise
29      funds for GNU development.
30 @end copying
32 @ifinfo
33 @dircategory GNU Libraries
34 @direntry
35 * libgupc: (libgupc).                    GNU UPC runtime library
36 @end direntry
38 This manual documents the GNU implementation of the UPC runtime.
39 multi-platform shared-memory parallel programming in C/C++ and Fortran.
41 Published by the Free Software Foundation
42 51 Franklin Street, Fifth Floor
43 Boston, MA 02110-1301 USA
45 @insertcopying
46 @end ifinfo
49 @setchapternewpage odd
51 @titlepage
52 @title The GNU UPC Implementation
53 @page
54 @vskip 0pt plus 1filll
55 @comment For the @value{version-GCC} Version*
56 @sp 1
57 Published by the Free Software Foundation @*
58 51 Franklin Street, Fifth Floor@*
59 Boston, MA 02110-1301, USA@*
60 @sp 1
61 @insertcopying
62 @end titlepage
64 @summarycontents
65 @contents
66 @page
69 @node Top
70 @top Introduction
71 @cindex Introduction
73 This manual documents the usage of libgupc, the GNU implementation of the 
74 @uref{http://www.openmp.org, UPC} Application Programming Interface (API)
75 for multi-platform shared-memory parallel programming in C/C++ and Fortran.
79 @comment
80 @comment  When you add a new menu item, please keep the right hand
81 @comment  aligned to the same column.  Do not use tabs.  This provides
82 @comment  better formatting.
83 @comment
84 @menu
85 * Enabling UPC::            How to enable UPC for your applications.
86 * Runtime Library Routines::   The UPC runtime application programming 
87                                interface.
88 * Environment Variables::      Influencing runtime behavior with environment 
89                                variables.
90 * The libgupc ABI::             Notes on the external ABI presented by libgupc.
91 * Reporting Bugs::             How to report bugs in GNU UPC.
92 * Copying::                    GNU general public license says
93                                how you can copy and share libgupc.
94 * GNU Free Documentation License::
95                                How you can copy and share this manual.
96 * Funding::                    How to help assure continued work for free 
97                                software.
98 * Index::                      Index of this documentation.
99 @end menu
102 @c ---------------------------------------------------------------------
103 @c Enabling UPC
104 @c ---------------------------------------------------------------------
106 @node Enabling UPC
107 @chapter Enabling UPC
110 @c ---------------------------------------------------------------------
111 @c Runtime Library Routines
112 @c ---------------------------------------------------------------------
114 @node Runtime Library Routines
115 @chapter Runtime Library Routines
117 @c ---------------------------------------------------------------------
118 @c The libgupc ABI
119 @c ---------------------------------------------------------------------
121 @node The libgupc ABI
122 @chapter The libgupc ABI
124 @c ---------------------------------------------------------------------
125 @c Environment Variables
126 @c ---------------------------------------------------------------------
128 @node Environment Variables
129 @chapter Environment Variables
131 @c ---------------------------------------------------------------------
132 @c 
133 @c ---------------------------------------------------------------------
135 @node Reporting Bugs
136 @chapter Reporting Bugs
138 Bugs in the GNU UPC implementation should be reported via 
139 @uref{http://gcc.gnu.org/bugzilla/, bugzilla}. In all cases, please add 
140 "UPC" to the keywords field in the bug report.
142 @c ---------------------------------------------------------------------
143 @c GNU General Public License
144 @c ---------------------------------------------------------------------
146 @include gpl_v3.texi
150 @c ---------------------------------------------------------------------
151 @c GNU Free Documentation License
152 @c ---------------------------------------------------------------------
154 @include fdl.texi
158 @c ---------------------------------------------------------------------
159 @c Funding Free Software
160 @c ---------------------------------------------------------------------
162 @include funding.texi
164 @c ---------------------------------------------------------------------
165 @c Index
166 @c ---------------------------------------------------------------------
168 @node Index
169 @unnumbered Index
171 @printindex cp
173 @bye