doc/Makefile.am

   1 ## Process this file with automake to produce Makefile.in.
   2
   3 # Dia, the version i have at least, doesn't do very good EPS output
   4 # (some of the text is scaled strangely). So this will work, but
   5 # it is probably better to use something like gimp to convert the
   6 # dia exported PNG files to EPS manually.
   7 #
   8 # Here we use 'convert' from the well known 'ImageMagick' package
   9 # to do conversion from png to eps/pdf for figures.
  10 # PDF form is required for frr.pdf, using PDFTex at least.
  11 #
  12 # TeX implementation, which we depend on already anyway.
  13 #
  14 # dia -> (dia) -> png -> (convert) -> eps -> (epstopdf) -> pdf
  15 SUFFIXES = .png .eps .dia .pdf
  16 DIATOPNG = dia -t png -e
  17 DIATOEPS = dia -t eps -e
  18 PNGTOEPS = convert -antialias -contrast -despeckle
  19 PNGTOPDF = $(PNGTOEPS)
  20 EPSTOPDF = epstopdf
  21
  22 VNCFIGURES_PNG =
  23 VNCFIGURES_DIA = -vnc-mesh -vnc-frr-route-reflector             \
  24 -vnc-commercial-route-reflector -vnc-redundant-route-reflectors \
  25 -vnc-gw -vnc-gw-rr
  26
  27 # TODO: A target that creates an empty text file for each member of
  28 # VNCFIGURES_TXT
  29 VNCFIGURES_TXT = $(VNCFIGURES:%.png=%.txt)
  30
  31 # The figure sources
  32 figures_names_parts = -normal-processing -rs-processing \
  33         _topologies_full _topologies_rs \
  34         $(VNCFIGURES_DIA)
  35
  36 figures_sources = $(figures_names_parts:%=fig%.dia)
  37 figures_png = $(figures_names_parts:%=fig%.png) $(VNCFIGURES_PNG)
  38 figures_pdf = $(figures_names_parts:%=fig%.pdf) $(VNCFIGURES_PNG:%.png=%.pdf)
  39 figures_eps = $(figures_names_parts:%=fig%.eps) $(VNCFIGURES_PNG:%.png=%.eps)
  40 figures_txt = $(figures_names_parts:%=fig%.txt)
  41
  42 # rather twisted logic because we have to build PDFs of the EPS figures for
  43 # PDFTex and yet build one PDF, frr.pdf, from texi source. Which means we
  44 # cant rely on a single automatic rule for *.pdf, eg the one automatically
  45 # provided by automake. If you are an automake wizard, please feel free to
  46 # compact it somehow.
  47
  48 # Built from defines.texi.in
  49 BUILT_SOURCES = defines.texi
  50
  51 info_TEXINFOS = frr.texi
  52
  53 # Have to manually specify the frr.pdf rule in order to allow
  54 # us to have a generic automatic .pdf rule to build the figure sources
  55 # because it cant just work from the png's directly it seems - contrary
  56 # to the documentation...
  57 frr.pdf: $(info_TEXINFOS) $(figures_pdf) $(frr_TEXINFOS)
  58         $(TEXI2PDF) -o "$@" $< || true
  59
  60 frr_TEXINFOS = appendix.texi basic.texi bgpd.texi isisd.texi filter.texi \
  61         vnc.texi \
  62         install.texi ipv6.texi kernel.texi main.texi \
  63         nhrpd.texi \
  64         ospf6d.texi ospfd.texi \
  65         overview.texi protocol.texi ripd.texi ripngd.texi routemap.texi \
  66         snmp.texi vtysh.texi routeserver.texi defines.texi $(figures_png) \
  67         snmptrap.texi ospf_fundamentals.texi isisd.texi $(figures_txt)
  68
  69 .png.eps:
  70         $(PNGTOEPS) $< "$@"
  71
  72 .png.pdf:
  73         $(PNGTOPDF) $< "$@"
  74
  75 .dia.png:
  76         $(DIATOPNG) "$@" $<
  77
  78 man_MANS = frr.1
  79
  80 if PIMD
  81 man_MANS += pimd.8
  82 endif
  83
  84 if BGPD
  85 man_MANS += bgpd.8
  86 endif
  87
  88 if ISISD
  89 man_MANS += isisd.8
  90 endif
  91
  92 if OSPF6D
  93 man_MANS += ospf6d.8
  94 endif
  95
  96 if OSPFCLIENT
  97 man_MANS += ospfclient.8
  98 endif
  99
 100 if OSPFD
 101 man_MANS += ospfd.8
 102 endif
 103
 104 if LDPD
 105 man_MANS += ldpd.8
 106 endif
 107
 108 if RIPD
 109 man_MANS += ripd.8
 110 endif
 111
 112 if RIPNGD
 113 man_MANS += ripngd.8
 114 endif
 115
 116 if NHRPD
 117 man_MANS += nhrpd.8
 118 endif
 119
 120 if VTYSH
 121 man_MANS += vtysh.1
 122 endif
 123
 124 if WATCHFRR
 125 man_MANS += watchfrr.8
 126 endif
 127
 128 if ZEBRA
 129 man_MANS += zebra.8
 130 endif
 131
 132 EXTRA_DIST = BGP-TypeCode draft-zebra-00.ms draft-zebra-00.txt \
 133         \
 134         bgpd.8.in \
 135         isisd.8.in \
 136         ospf6d.8.in \
 137         ospfclient.8.in \
 138         ospfd.8.in \
 139         ldpd.8.in \
 140         ripd.8.in \
 141         ripngd.8.in \
 142         pimd.8.in \
 143         nhrpd.8.in \
 144         vtysh.1.in \
 145         watchfrr.8.in \
 146         zebra.8.in \
 147         frr.1.in \
 148         \
 149         mpls/ChangeLog.opaque.txt mpls/cli_summary.txt \
 150         mpls/opaque_lsa.txt mpls/ospfd.conf \
 151         $(figures_sources) $(figures_png) $(figures_txt)
 152
 153 draft-zebra-00.txt: draft-zebra-00.ms
 154         groff -T ascii -ms $< > $@
 155
 156 # Ensure that all of the figures are copied into the html directory
 157 html-local: $(HTMLS)
 158         if test -d $(HTMLS) ; then \
 159                 cp -p $(figures_png) $(HTMLS) ; \
 160         else \
 161                 echo "$(HTMLS) is not a directory. Make it so, the rerun make."; \
 162         fi