Merge trunk version 216723 into gupc branch.
[official-gcc.git] / libgupc / libgupc.texi
blob9e4f02a64b0fc82e644a0f71c465761d0cf12fc7
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-2014 Free Software Foundation, Inc.
12 Permission is granted to copy, distribute and/or modify this document
13 under the terms of the GNU Free Documentation License, Version 1.2 or
14 any later version published by the Free Software Foundation; with the
15 Invariant Sections being ``Funding Free Software'', the Front-Cover
16 texts being (a) (see below), and with the Back-Cover Texts being (b)
17 (see below).  A copy of the license is included in the section entitled
18 ``GNU Free Documentation License''.
20 (a) The FSF's Front-Cover Text is:
22      A GNU Manual
24 (b) The FSF's Back-Cover Text is:
26      You have freedom to copy and modify this GNU Manual, like GNU
27      software.  Copies published by the Free Software Foundation raise
28      funds for GNU development.
29 @end copying
31 @ifinfo
32 @dircategory GNU Libraries
33 @direntry
34 * libgupc: (libgupc).                    GNU UPC runtime library
35 @end direntry
37 This manual documents the GNU implementation of the UPC runtime.
38 multi-platform shared-memory parallel programming in C/C++ and Fortran.
40 Published by the Free Software Foundation
41 51 Franklin Street, Fifth Floor
42 Boston, MA 02110-1301 USA
44 @insertcopying
45 @end ifinfo
48 @setchapternewpage odd
50 @titlepage
51 @title The GNU UPC Implementation
52 @page
53 @vskip 0pt plus 1filll
54 @comment For the @value{version-GCC} Version*
55 @sp 1
56 Published by the Free Software Foundation @*
57 51 Franklin Street, Fifth Floor@*
58 Boston, MA 02110-1301, USA@*
59 @sp 1
60 @insertcopying
61 @end titlepage
63 @summarycontents
64 @contents
65 @page
68 @node Top
69 @top Introduction
70 @cindex Introduction
72 This manual documents the usage of libgupc, the GNU implementation of the 
73 @uref{http://www.openmp.org, UPC} Application Programming Interface (API)
74 for multi-platform shared-memory parallel programming in C/C++ and Fortran.
78 @comment
79 @comment  When you add a new menu item, please keep the right hand
80 @comment  aligned to the same column.  Do not use tabs.  This provides
81 @comment  better formatting.
82 @comment
83 @menu
84 * Enabling UPC::            How to enable UPC for your applications.
85 * Runtime Library Routines::   The UPC runtime application programming 
86                                interface.
87 * Environment Variables::      Influencing runtime behavior with environment 
88                                variables.
89 * The libgupc ABI::             Notes on the external ABI presented by libgupc.
90 * Reporting Bugs::             How to report bugs in GNU UPC.
91 * Copying::                    GNU general public license says
92                                how you can copy and share libgupc.
93 * GNU Free Documentation License::
94                                How you can copy and share this manual.
95 * Funding::                    How to help assure continued work for free 
96                                software.
97 * Index::                      Index of this documentation.
98 @end menu
101 @c ---------------------------------------------------------------------
102 @c Enabling UPC
103 @c ---------------------------------------------------------------------
105 @node Enabling UPC
106 @chapter Enabling UPC
109 @c ---------------------------------------------------------------------
110 @c Runtime Library Routines
111 @c ---------------------------------------------------------------------
113 @node Runtime Library Routines
114 @chapter Runtime Library Routines
116 @c ---------------------------------------------------------------------
117 @c The libgupc ABI
118 @c ---------------------------------------------------------------------
120 @node The libgupc ABI
121 @chapter The libgupc ABI
123 @c ---------------------------------------------------------------------
124 @c Environment Variables
125 @c ---------------------------------------------------------------------
127 @node Environment Variables
128 @chapter Environment Variables
130 @c ---------------------------------------------------------------------
131 @c 
132 @c ---------------------------------------------------------------------
134 @node Reporting Bugs
135 @chapter Reporting Bugs
137 Bugs in the GNU UPC implementation should be reported via 
138 @uref{http://gcc.gnu.org/bugzilla/, bugzilla}. In all cases, please add 
139 "UPC" to the keywords field in the bug report.
141 @c ---------------------------------------------------------------------
142 @c GNU General Public License
143 @c ---------------------------------------------------------------------
145 @include gpl_v3.texi
149 @c ---------------------------------------------------------------------
150 @c GNU Free Documentation License
151 @c ---------------------------------------------------------------------
153 @include fdl.texi
157 @c ---------------------------------------------------------------------
158 @c Funding Free Software
159 @c ---------------------------------------------------------------------
161 @include funding.texi
163 @c ---------------------------------------------------------------------
164 @c Index
165 @c ---------------------------------------------------------------------
167 @node Index
168 @unnumbered Index
170 @printindex cp
172 @bye