Documentation/DocBook/Makefile

   1 BOOKS   := wanbook.sgml z8530book.sgml mcabook.sgml videobook.sgml \
   2            kernel-api.sgml parportbook.sgml kernel-hacking.sgml \
   3            kernel-locking.sgml via-audio.sgml mousedrivers.sgml sis900.sgml
   4
   5 PS      :=      $(patsubst %.sgml, %.ps, $(BOOKS))
   6 PDF     :=      $(patsubst %.sgml, %.pdf, $(BOOKS))
   7 HTML    :=      $(patsubst %.sgml, %, $(BOOKS))
   8 IMG-parportbook := parport-share.fig parport-multi.fig parport-structure.fig
   9 EPS-parportbook := $(patsubst %.fig, %.eps, $(IMG-parportbook))
  10 JPG-parportbook := $(patsubst %.fig, %.jpeg, $(IMG-parportbook))
  11
  12 $(BOOKS): $(TOPDIR)/scripts/docproc
  13
  14 .PHONY: books ps pdf html clean mrproper
  15
  16 books:  $(BOOKS)
  17
  18 ps:     $(PS)
  19
  20 pdf:    $(PDF)
  21
  22 html:   $(HTML)
  23
  24 %.eps: %.fig
  25         -fig2dev -Leps $< $@
  26
  27 %.jpeg: %.fig
  28         -fig2dev -Ljpeg $< $@
  29
  30 $(TOPDIR)/scripts/docproc:
  31         $(MAKE) -C $(TOPDIR)/scripts docproc
  32
  33 mousedrivers.sgml: mousedrivers.tmpl
  34         $(TOPDIR)/scripts/docgen <$< >$@
  35
  36 kernel-hacking.sgml: kernel-hacking.tmpl
  37         $(TOPDIR)/scripts/docgen <$< >$@
  38
  39 kernel-locking.sgml: kernel-locking.tmpl
  40         $(TOPDIR)/scripts/docgen <$< >$@
  41
  42 wanbook.sgml: wanbook.tmpl $(TOPDIR)/drivers/net/wan/syncppp.c
  43         $(TOPDIR)/scripts/docgen $(TOPDIR)/drivers/net/wan/syncppp.c \
  44                 <wanbook.tmpl >wanbook.sgml
  45
  46 z8530book.sgml: z8530book.tmpl $(TOPDIR)/drivers/net/wan/z85230.c
  47         $(TOPDIR)/scripts/docgen $(TOPDIR)/drivers/net/wan/z85230.c \
  48                 <z8530book.tmpl >z8530book.sgml
  49
  50 via-audio.sgml: via-audio.tmpl $(TOPDIR)/drivers/sound/via82cxxx_audio.c
  51         $(TOPDIR)/scripts/docgen $(TOPDIR)/drivers/sound/via82cxxx_audio.c \
  52                 <via-audio.tmpl >via-audio.sgml
  53
  54 sis900.sgml: sis900.tmpl $(TOPDIR)/drivers/net/sis900.c
  55         $(TOPDIR)/scripts/docgen $(TOPDIR)/drivers/net/sis900.c \
  56                 <sis900.tmpl >sis900.sgml
  57
  58 mcabook.sgml: mcabook.tmpl $(TOPDIR)/arch/i386/kernel/mca.c
  59         $(TOPDIR)/scripts/docgen $(TOPDIR)/arch/i386/kernel/mca.c \
  60                 <mcabook.tmpl >mcabook.sgml
  61
  62 videobook.sgml: videobook.tmpl $(TOPDIR)/drivers/media/video/videodev.c
  63         $(TOPDIR)/scripts/docgen $(TOPDIR)/drivers/media/video/videodev.c \
  64                 <videobook.tmpl >videobook.sgml
  65
  66 APISOURCES :=   $(TOPDIR)/drivers/media/video/videodev.c \
  67                 $(TOPDIR)/arch/i386/kernel/mca.c \
  68                 $(TOPDIR)/arch/i386/kernel/mtrr.c \
  69                 $(TOPDIR)/drivers/char/misc.c \
  70                 $(TOPDIR)/drivers/net/net_init.c \
  71                 $(TOPDIR)/drivers/net/8390.c \
  72                 $(TOPDIR)/drivers/char/serial.c \
  73                 $(TOPDIR)/drivers/pci/pci.c \
  74                 $(TOPDIR)/drivers/block/ll_rw_blk.c \
  75                 $(TOPDIR)/drivers/sound/sound_core.c \
  76                 $(TOPDIR)/drivers/sound/sound_firmware.c \
  77                 $(TOPDIR)/drivers/net/wan/syncppp.c \
  78                 $(TOPDIR)/drivers/net/wan/z85230.c \
  79                 $(TOPDIR)/fs/locks.c \
  80                 $(TOPDIR)/fs/devfs/base.c \
  81                 $(TOPDIR)/kernel/pm.c \
  82                 $(TOPDIR)/kernel/ksyms.c \
  83                 $(TOPDIR)/net/netsyms.c
  84
  85 kernel-api.sgml: kernel-api.tmpl $(APISOURCES)
  86         $(TOPDIR)/scripts/docgen $(APISOURCES) \
  87                 <kernel-api.tmpl >kernel-api.sgml
  88
  89 kernel-api-man: $(APISOURCES)
  90         @rm -rf $(TOPDIR)/Documentation/man
  91         $(TOPDIR)/scripts/kernel-doc -man $^ | \
  92                 $(PERL) $(TOPDIR)/scripts/split-man $(TOPDIR)/Documentation/man
  93
  94 parportbook: $(JPG-parportbook)
  95 parportbook.ps: $(EPS-parportbook)
  96 parportbook.sgml: parportbook.tmpl $(TOPDIR)/drivers/parport/init.c
  97         $(TOPDIR)/scripts/docgen $(TOPDIR)/drivers/parport/init.c <$< >$@
  98
  99 DVI     :=      $(patsubst %.sgml, %.dvi, $(BOOKS))
 100 AUX     :=      $(patsubst %.sgml, %.aux, $(BOOKS))
 101 TEX     :=      $(patsubst %.sgml, %.tex, $(BOOKS))
 102 LOG     :=      $(patsubst %.sgml, %.log, $(BOOKS))
 103 OUT     :=      $(patsubst %.sgml, %.out, $(BOOKS))
 104
 105 clean:
 106         -$(RM) core *~
 107         -$(RM) $(BOOKS)
 108         -$(RM) $(DVI) $(AUX) $(TEX) $(LOG) $(OUT)
 109         -$(RM) $(JPG-parportbook) $(EPS-parportbook)
 110
 111 mrproper: clean
 112         -$(RM) $(PS) $(PDF)
 113         -$(RM) -r $(HTML)
 114         -$(RM) .depend
 115         -$(RM) $(TOPDIR)/scripts/mkdep-docbook
 116
 117 %.ps : %.sgml
 118         @(which db2ps > /dev/null 2>&1) || \
 119          (echo "*** You need to install DocBook stylesheets ***"; \
 120           exit 1)
 121         db2ps $<
 122
 123 %.pdf : %.sgml
 124         @(which db2pdf > /dev/null 2>&1) || \
 125          (echo "*** You need to install DocBook stylesheets ***"; \
 126           exit 1)
 127         db2pdf $<
 128
 129 %:      %.sgml
 130         @(which db2html > /dev/null 2>&1) || \
 131          (echo "*** You need to install DocBook stylesheets ***"; \
 132           exit 1)
 133         -$(RM) -r $@
 134         db2html $<
 135         if [ ! -z "$(JPG-$@)" ]; then cp $(JPG-$@) $@; fi
 136
 137 #
 138 # we could have our own dependency generator
 139 #
 140 #
 141 # .depend: $(TOPDIR)/scripts/mkdep-docbook
 142 #       $(TOPDIR)/scripts/mkdep-docbook $(wildcard *.tmpl) > .depend
 143
 144 include $(TOPDIR)/Rules.make
 145