manuals/developer-guide/src/main/asciidoc/bk-developers-guide.adoc

   1 [[bk-user-guide]]
   2 = OpenDaylight Developer Guide
   3 :docinfo:
   4
   5 ///////
   6 [dedication]
   7 Example Dedication
   8 ------------------
   9 Optional dedication.
  10
  11 This document is an AsciiDoc book skeleton containing briefly
  12 annotated example elements plus a couple of example index entries and
  13 footnotes.
  14
  15 Books are normally used to generate DocBook markup and the titles of
  16 the preface, appendix, bibliography, glossary and index sections are
  17 significant ('specialsections').
  18
  19
  20 [preface]
  21 Example Preface
  22 ---------------
  23 Optional preface.
  24
  25 Preface Sub-section
  26 ~~~~~~~~~~~~~~~~~~~
  27 Preface sub-section body.
  28 ///////
  29
  30 //////////////////////////
  31 Please note and leave the blank line between include statements here.
  32
  33 It is a defensive measure to prevent individual projects' .adoc files
  34 from eating the next section if they forget to leave a blank line at
  35 the end of their file.
  36 //////////////////////////
  37 = Overview
  38
  39 // FIXME: Should we use introduction from user manual / installation guide?
  40 //        are this prerequisites for developers guide? If so, we should document
  41 //        that explicitly here so we do not need to repeat same text
  42 //          over-and-over
  43
  44 // FIXME: section_Git_and_Gerrit_Setup.adoc and section_Hacking_from_CLI.adoc
  45 //        is much more contributor style documentation and not Developer
  46 //        documentation for folks which wants to build on top of OpenDaylight.
  47 include::section_Git_and_Gerrit_Setup.adoc[]
  48
  49 include::section_Hacking_from_CLI.adoc[]
  50
  51 include::developing-app.adoc[]
  52
  53 = Project-Specific Development Guides
  54
  55 include::alto/alto-developer-guide.adoc[ALTO]
  56
  57 include::atrium/odl-atrium-all-dev.adoc[Atrium]
  58
  59 include::bgpcep/odl-bgpcep-bgp-all-dev.adoc[BGP]
  60
  61 include::bgpcep/odl-bgpcep-bmp-dev.adoc[BGP]
  62
  63 include::capwap/capwap-dev.adoc[CAPWAP]
  64
  65 include::cardinal/odl-cardinal-dev.adoc[]
  66
  67 include::controller/controller.adoc[Controller]
  68
  69 include::didm/didm-dev.adoc[]
  70
  71 include::dlux/dlux-core-dev.adoc[]
  72
  73 include::iotdm/iotdm-dev.adoc[]
  74
  75 include::l2switch/l2switch-dev.adoc[]
  76
  77 include::lacp/lacp-dev.adoc[]
  78
  79 include::controller/netconf/odl-netconf-dev.adoc[]
  80
  81 include::nic/nic-dev.adoc[]
  82
  83 include::nemo/odl-nemo-engine-dev.adoc[]
  84
  85 include::netide/netide-developer-guide.adoc[]
  86
  87 include::neutron/neutron.adoc[]
  88
  89 include::odlparent/odlparent-developer.adoc[]
  90
  91 include::ocpplugin/ocp-developer-guide.adoc[OCP]
  92
  93 include::sdninterfaceapp/odl-sdninterfaceapp-all-dev.adoc[]
  94
  95 include::of-config/of-config-dev.adoc[]
  96
  97 include::openflowjava/odl-openflowjava-protocol-dev.adoc[]
  98
  99 include::openflowplugin/odl-ofp-developer-guide.adoc[]
 100
 101 include::opflex/agent-ovs-dev.adoc[]
 102
 103 include::opflex/genie-dev.adoc[]
 104
 105 include::opflex/libopflex-dev.adoc[]
 106
 107 include::ovsdb/ovsdb-developer.adoc[]
 108
 109 include::bgpcep/odl-bgpcep-pcep-all-dev.adoc[PCEP]
 110
 111 include::packetcable/packetcable-dev.adoc[Packet Cable PCMM Southbound Plugin]
 112
 113 // commenting this out as it contains no content
 114 //include::reservation/reservation-dev.adoc[]
 115
 116 include::sfc/sfc.adoc[]
 117
 118 include::snmp4sdn/snmp4sdn-developer.adoc[SNMP4SDN]
 119
 120 include::sxp/odl-sxp-dev.adoc[]
 121
 122 include::topoprocessing/odl-topoprocessing-framework-dev.adoc[]
 123
 124 include::ttp/ttp-model-dev.adoc[]
 125
 126 include::ttp/ttp-cli-tools-dev.adoc[]
 127
 128 include::usc/odl-usc-channel-dev.adoc[]
 129
 130 include::vtn/vtn-dev.adoc[]
 131
 132 include::yangtools/yangtools.adoc[]
 133
 134 include::yang-push/odl-yang-push-dev.adoc[YANG-PUSH]
 135
 136 :numbered!:
 137
 138 ///////
 139 [appendix]
 140 Example Appendix
 141 ----------------
 142 One or more optional appendixes go here at section level 1.
 143
 144 Appendix Sub-section
 145 ~~~~~~~~~~~~~~~~~~~
 146 Sub-section body.
 147
 148
 149 [glossary]
 150 Example Glossary
 151 ----------------
 152 Glossaries are optional. Glossaries entries are an example of a style
 153 of AsciiDoc labeled lists.
 154
 155 [glossary]
 156 A glossary term::
 157   The corresponding (indented) definition.
 158
 159 A second glossary term::
 160   The corresponding (indented) definition.
 161
 162
 163 [colophon]
 164 Example Colophon
 165 ----------------
 166 Text at the end of a book describing facts about its production.
 167
 168
 169 [index]
 170 Example Index
 171 -------------
 172 ///////
 173
 174 ////////////////////////////////////////////////////////////////
 175 The index is normally left completely empty, it's contents being
 176 generated automatically by the DocBook toolchain.
 177 ////////////////////////////////////////////////////////////////