Add safe connect, fix possible seg fault in RTC
[ric-plt/lib/rmr.git] / doc / src / rtd / user-guide.xfm
1 .** vim: ts=4 noet sw=4:
2 .if false
3 ==================================================================================
4         Copyright (c) 2019 Nokia
5         Copyright (c) 2018-2019 AT&T Intellectual Property.
6
7    Licensed under the Apache License, Version 2.0 (the "License");
8    you may not use this file except in compliance with the License.
9    You may obtain a copy of the License at
10
11        http://www.apache.org/licenses/LICENSE-2.0
12
13    Unless required by applicable law or agreed to in writing, software
14    distributed under the License is distributed on an "AS IS" BASIS,
15    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16    See the License for the specific language governing permissions and
17    limitations under the License.
18 ==================================================================================
19 .fi
20
21
22 .if false
23         Mnemonic:       user-guide.xfm
24         Abstract:       Source for the user's guide (mostly just an import of all
25                                 of the manual pages).
26         Date:           6 November 2019
27         Author:         E. Scott Daniels
28 .fi
29
30 .im setup.im
31
32 &h1(RMR User's Guide)
33
34 The RIC Message Router (RMR) is a library for peer-to-peer
35 communication.  Applications use the library to send and receive
36 messages where the message routing and endpoint selection is based on
37 the message type rather than DNS host name-IP port combinations.
38 &space
39 This document contains information that developers need to know to use
40 the RMR library.  Because the primary documentation for the RMR
41 library is a collection of UNIX manpages (included in the development
42 package, and available via the &cw(man) command when installed), there
43 is no separate "User's Guide."  To provide something for the document
44 scrapers to find, this is a collection of the RMR manual pages
45 formatted directly from their source, which might be a bit ragged when
46 combined into a single markup document.  Read the manual pages :)
47 &space
48
49
50 .** turn off header 1 so that the rmr library header isn't generated for each page
51 .dv h1
52
53 .** CAUTION: man_list.im is generated by a script when make is used!
54 .im man_list.im