contrib/libxo/doc/index.rst

   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
  11 .. default-role:: code
  12
  13 libxo - A Library for Generating Text, XML, JSON, and HTML Output
  14 ===================================================================
  15
  16 The libxo library allows an application to generate text, XML, JSON,
  17 and HTML output, suitable for both command line use and for web
  18 applications.  The application decides at run time which output style
  19 should be produced.  By using libxo, a single source code path can
  20 emit multiple styles of output using command line options to select
  21 the style, along with optional behaviors.  libxo includes support for
  22 multiple output streams, pluralization, color, syslog,
  23 :manpage:`humanized(3)` output, internationalization, and UTF-8.  The
  24 library aims to minimize the cost of migrating code to libxo.
  25
  26 libxo ships as part of FreeBSD.
  27
  28 .. toctree::
  29     :maxdepth: 3
  30     :caption: Documentation Contents:
  31
  32     intro
  33     getting
  34     formatting
  35     options
  36     format-strings
  37     field-roles
  38     field-modifiers
  39     field-formatting
  40     api
  41     encoders
  42     xo
  43     xolint
  44     xohtml
  45     xopo
  46     faq
  47     howto
  48     example
  49
  50 Indices and tables
  51 ==================
  52
  53 * :ref:`genindex`
  54 * :ref:`search`