contrib/libxo/libxo/xo_set_style.3

   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_emit
  15 .Nd emit formatted output based on format string and arguments
  16 .Sh LIBRARY
  17 .Lb libxo
  18 .Sh SYNOPSIS
  19 .In libxo/xo.h
  20 .Ft void
  21 .Fn xo_set_style "xo_handle_t *handle" "unsigned style"
  22 .Ft int
  23 .Fn xo_set_style_name "xo_handle_t *handle" "const char *style"
  24 .Sh DESCRIPTION
  25 Use the
  26 .Fn xo_set_style
  27 function to set the output style for a handle.
  28 To use the default handle, pass a
  29 .Dv NULL
  30 handle.
  31 The set of output styles used by
  32 .Nm libxo
  33 is:
  34 .Bl -column "XO_STYLE_TEXT12"
  35 .It Sy "Flag          Description"
  36 .It "XO_STYLE_TEXT  Traditional text output"
  37 .It "XO_STYLE_XML   XML encoded data"
  38 .It "XO_STYLE_JSON  JSON encoded data"
  39 .It "XO_STYLE_HTML  HTML encoded data"
  40 .El
  41 .Pp
  42 The
  43 .Fn xo_set_style_name
  44 function can be used to set the style based on a name
  45 encoded as a string.
  46 The name can be any of the styles: "text", "xml", "json", or "html".
  47 .Bd -literal -offset indent
  48     EXAMPLE:
  49         xo_set_style_name(NULL, "html");
  50 .Ed
  51 .Sh ADDITIONAL DOCUMENTATION
  52 Complete documentation can be found on github:
  53 .Bd -literal -offset indent
  54 http://juniper.github.io/libxo/libxo-manual.html
  55 .Ed
  56 .Pp
  57 .Nm libxo
  58 lives on github as:
  59 .Bd -literal -offset indent
  60 https://github.com/Juniper/libxo
  61 .Ed
  62 .Pp
  63 The latest release of
  64 .Nm libxo
  65 is available at:
  66 .Bd -literal -offset indent
  67 https://github.com/Juniper/libxo/releases
  68 .Ed
  69 .Sh SEE ALSO
  70 .Xr xo_emit 3
  71 .Sh HISTORY
  72 The
  73 .Nm libxo
  74 library was added in
  75 .Fx 11.0 .
  76 .Sh AUTHOR
  77 Phil Shafer