xref: /freebsd/contrib/libxo/libxo/xo_finish.3 (revision 325151a3)
1.\" #
2.\" # Copyright (c) 2014, Juniper Networks, Inc.
3.\" # All rights reserved.
4.\" # This SOFTWARE is licensed under the LICENSE provided in the
5.\" # ../Copyright file. By downloading, installing, copying, or
6.\" # using the SOFTWARE, you agree to be bound by the terms of that
7.\" # LICENSE.
8.\" # Phil Shafer, July 2014
9.\"
10.Dd December 4, 2014
11.Dt LIBXO 3
12.Os
13.Sh NAME
14.Nm xo_finish , xo_finish_h
15.Nd finish formatting output
16.Sh LIBRARY
17.Lb libxo
18.Sh SYNOPSIS
19.In libxo/xo.h
20.Ft void
21.Fn xo_finish "void"
22.Ft void
23.Fn xo_finish_h "xo_handle_t *xop"
24.Sh DESCRIPTION
25When the program is ready to exit or close a handle, a call to
26.Fn xo_finish
27is required.
28This flushes any buffered data, closes
29open
30.Nm libxo
31constructs, and completes any pending operations.
32.Pp
33Calling this function is
34.Em vital
35to the proper operation of libxo,
36especially for the non-TEXT output styles.
37.Sh SEE ALSO
38.Xr xo_emit 3 ,
39.Xr libxo 3
40