doc/Makefile.am

   1 ## Process this file with automake to produce Makefile.in.
   2
   3 # Pass down make invocation to each subdirectory.
   4 #
   5 # Each of these directories contains a Sphinx-generated Makefile that has been
   6 # modified to implement all the targets required by Automake, as documented in
   7 # the 'Third-Party Makefiles' section of the Automake docs.
   8 #
   9 # Note the absence of the 'developer' directory here; development docs are
  10 # never built as part of a regular build. They are only built when explicitly
  11 # asked for. See comment further down.
  12
  13 # Sphinx is not designed to be invoked multiple times against the same toctree.
  14 .NOTPARALLEL:
  15
  16 SUBDIRS = manpages user
  17 AM_MAKEFLAGS = DESTDIR=${DESTDIR} infodir=${infodir}
  18
  19 MANPAGE_BUILDDIR = manpages/_build/man
  20
  21 # This is a hack, see comment further down.
  22 man_MANS = $(MANPAGE_BUILDDIR)/frr.1
  23
  24 if PIMD
  25 man_MANS += $(MANPAGE_BUILDDIR)/pimd.8
  26 man_MANS += $(MANPAGE_BUILDDIR)/mtracebis.8
  27 endif
  28
  29 if PBRD
  30 man_MANS += $(MANPAGE_BUILDDIR)/pbrd.8
  31 endif
  32
  33 if BGPD
  34 man_MANS += $(MANPAGE_BUILDDIR)/bgpd.8
  35 endif
  36
  37 if ISISD
  38 man_MANS += $(MANPAGE_BUILDDIR)/isisd.8
  39 endif
  40
  41 if OSPF6D
  42 man_MANS += $(MANPAGE_BUILDDIR)/ospf6d.8
  43 endif
  44
  45 if OSPFCLIENT
  46 man_MANS += $(MANPAGE_BUILDDIR)/ospfclient.8
  47 endif
  48
  49 if OSPFD
  50 man_MANS += $(MANPAGE_BUILDDIR)/ospfd.8
  51 endif
  52
  53 if LDPD
  54 man_MANS += $(MANPAGE_BUILDDIR)/ldpd.8
  55 endif
  56
  57 if RIPD
  58 man_MANS += $(MANPAGE_BUILDDIR)/ripd.8
  59 endif
  60
  61 if RIPNGD
  62 man_MANS += $(MANPAGE_BUILDDIR)/ripngd.8
  63 endif
  64
  65 if NHRPD
  66 man_MANS += $(MANPAGE_BUILDDIR)/nhrpd.8
  67 endif
  68
  69 if VTYSH
  70 man_MANS += $(MANPAGE_BUILDDIR)/vtysh.1
  71 endif
  72
  73 if WATCHFRR
  74 man_MANS += $(MANPAGE_BUILDDIR)/watchfrr.8
  75 endif
  76
  77 if ZEBRA
  78 man_MANS += $(MANPAGE_BUILDDIR)/zebra.8
  79 endif
  80
  81 if EIGRPD
  82 man_MANS += $(MANPAGE_BUILDDIR)/eigrpd.8
  83 endif
  84
  85 if SHARPD
  86 man_MANS += $(MANPAGE_BUILDDIR)/sharpd.8
  87 endif
  88
  89 # Automake is particular about manpages. It is aware of them and has some
  90 # special facilities for handling them, but it assumes that manpages are always
  91 # given in groff source and so these facilities are limited to simply
  92 # specifying the path to the groff sources in a special variable. There is no
  93 # target for building manpages that can be extended, as there are for pdf,
  94 # html, dvi, etc. Unfortunately this leaves us with hijacking the
  95 # 'install-data' and 'all' targets in the 3rd-party Makefile in manpages/ to
  96 # make sure manpages are always built, and then using the special Automake
  97 # variable defined above in order to take advantage of automatic installation.
  98 #
  99 # However, it is conceivable that someone may want to build just the manpages,
 100 # so here's an explicit target for that.
 101 man:
 102         $(MAKE) -C manpages man
 103
 104 # Automake automatically defines targets for various document formats. All of
 105 # the child 3rd-party Makefiles are aware of all Automake targets and implement
 106 # the ones we are interested in.
 107 #
 108 # The SUBDIRS variable at the top of this Makefile.am causes the following
 109 # implicit Automake targets to only build user documentation, and not developer
 110 # documentation:
 111 # - info
 112 # - html
 113 # - pdf
 114 #
 115 # If you wish to build developer documentation, use these targets:
 116 developer-info:
 117         $(MAKE) -C developer info
 118
 119 developer-pdf:
 120         $(MAKE) -C developer latexpdf
 121
 122 developer-html:
 123         $(MAKE) -C developer html
 124
 125 # If you want to build the developer's docs in other formats, try the
 126 # following:
 127 #
 128 # $ cd developer
 129 # $ make help
 130
 131 # dist tarballs want doc sources
 132 EXTRA_DIST = frr-sphinx.mk \
 133         manpages/bgpd.rst \
 134         manpages/common-options.rst \
 135         manpages/conf.py \
 136         manpages/defines.rst \
 137         manpages/eigrpd.rst \
 138         manpages/epilogue.rst \
 139         manpages/frr.rst \
 140         manpages/index.rst \
 141         manpages/isisd.rst \
 142         manpages/ldpd.rst \
 143         manpages/Makefile.am \
 144         manpages/mtracebis.rst \
 145         manpages/nhrpd.rst \
 146         manpages/ospf6d.rst \
 147         manpages/ospfclient.rst \
 148         manpages/ospfd.rst \
 149         manpages/pimd.rst \
 150         manpages/ripd.rst \
 151         manpages/pbrd.rst \
 152         manpages/ripngd.rst \
 153         manpages/sharpd.rst \
 154         manpages/vtysh.rst \
 155         manpages/watchfrr.rst \
 156         manpages/zebra.rst \
 157         developer/bgpd.rst \
 158         developer/bgp-typecodes.rst \
 159         developer/building-frr-on-alpine.rst \
 160         developer/building-frr-on-centos6.rst \
 161         developer/building-frr-on-centos7.rst \
 162         developer/building-frr-on-debian8.rst \
 163         developer/building-frr-on-debian9.rst \
 164         developer/building-frr-on-fedora24.rst \
 165         developer/building-frr-on-freebsd10.rst \
 166         developer/building-frr-on-freebsd11.rst \
 167         developer/building-frr-on-freebsd9.rst \
 168         developer/building-frr-on-lede-openwrt.rst \
 169         developer/building-frr-on-netbsd6.rst \
 170         developer/building-frr-on-netbsd7.rst \
 171         developer/building-frr-on-omnios.rst \
 172         developer/building-frr-on-openbsd6.rst \
 173         developer/building-frr-on-ubuntu1204.rst \
 174         developer/building-frr-on-ubuntu1404.rst \
 175         developer/building-frr-on-ubuntu1604.rst \
 176         developer/building-frr-on-ubuntu1804.rst \
 177         developer/building.rst \
 178         developer/cli.rst \
 179         developer/conf.py \
 180         developer/draft-zebra-00.ms \
 181         developer/hooks.rst \
 182         developer/index.rst \
 183         developer/ldpd-basic-test-setup.md \
 184         developer/library.rst \
 185         developer/Makefile.in \
 186         developer/maintainer-release-build.rst \
 187         developer/memtypes.rst \
 188         developer/modules.rst \
 189         developer/next-hop-tracking.rst \
 190         developer/ospf-api.rst \
 191         developer/ospf.rst \
 192         developer/ospf-sr.rst \
 193         developer/workflow.rst \
 194         developer/zebra.rst \
 195         user/babeld.rst \
 196         user/basic.rst \
 197         user/bgp.rst \
 198         user/bugs.rst \
 199         user/conf.py \
 200         user/eigrpd.rst \
 201         user/filter.rst \
 202         user/glossary.rst \
 203         user/index.rst \
 204         user/installation.rst \
 205         user/ipv6.rst \
 206         user/isisd.rst \
 207         user/kernel.rst \
 208         user/Makefile.am \
 209         user/nhrpd.rst \
 210         user/ospf6d.rst \
 211         user/ospfd.rst \
 212         user/ospf_fundamentals.rst \
 213         user/overview.rst \
 214         user/packet-dumps.rst \
 215         user/pim.rst \
 216         user/ripd.rst \
 217         user/pbr.rst \
 218         user/ripngd.rst \
 219         user/routemap.rst \
 220         user/routeserver.rst \
 221         user/rpki.rst \
 222         user/setup.rst \
 223         user/sharp.rst \
 224         user/snmp.rst \
 225         user/snmptrap.rst \
 226         user/Useful_Sysctl_Settings.md \
 227         user/vnc.rst \
 228         user/vtysh.rst \
 229         user/zebra.rst \
 230         mpls/ChangeLog.opaque.txt \
 231         mpls/ospfd.conf \
 232         mpls/cli_summary.txt \
 233         mpls/opaque_lsa.txt \
 234         figures/cligraph.png \
 235         figures/cligraph.svg \
 236         figures/fig-normal-processing.dia \
 237         figures/fig-normal-processing.png \
 238         figures/fig-normal-processing.txt \
 239         figures/fig-rs-processing.dia \
 240         figures/fig-rs-processing.png \
 241         figures/fig-rs-processing.txt \
 242         figures/fig_topologies_full.dia \
 243         figures/fig_topologies_full.png \
 244         figures/fig_topologies_full.txt \
 245         figures/fig_topologies_rs.dia \
 246         figures/fig_topologies_rs.png \
 247         figures/fig_topologies_rs.txt \
 248         figures/fig-vnc-commercial-route-reflector.dia \
 249         figures/fig-vnc-commercial-route-reflector.png \
 250         figures/fig-vnc-commercial-route-reflector.txt \
 251         figures/fig-vnc-frr-route-reflector.dia \
 252         figures/fig-vnc-frr-route-reflector.png \
 253         figures/fig-vnc-frr-route-reflector.txt \
 254         figures/fig-vnc-gw.dia \
 255         figures/fig-vnc-gw.png \
 256         figures/fig-vnc-gw-rr.dia \
 257         figures/fig-vnc-gw-rr.png \
 258         figures/fig-vnc-gw-rr.txt \
 259         figures/fig-vnc-gw.txt \
 260         figures/fig-vnc-mesh.dia \
 261         figures/fig-vnc-mesh.png \
 262         figures/fig-vnc-mesh.txt \
 263         figures/fig-vnc-redundant-route-reflectors.dia \
 264         figures/fig-vnc-redundant-route-reflectors.png \
 265         figures/fig-vnc-redundant-route-reflectors.txt \
 266         figures/frr-icon.svg \
 267         figures/frr-logo-icon.png \
 268         figures/frr-logo-medium.png \
 269         figures/frr-logo.png \
 270         figures/frr-logo-small.png \
 271         figures/git_branches.png \
 272         figures/git_branches.svg \
 273         figures/ospf_api_architecture.png \
 274         figures/ospf_api_msghdr.png \
 275         figures/ospf_api_msgs1.png \
 276         figures/ospf_api_msgs2.png \
 277         extra/frrlexer.py