doc/Makefile.am

   1 SUBDIRS = widgets
   2
   3 MAINTAINERCLEANFILES = Makefile.in
   4
   5 .PHONY: doc
   6
   7 PACKAGE_DOCNAME = $(PACKAGE_TARNAME)-$(PACKAGE_VERSION)-doc
   8
   9 if EFL_BUILD_DOC
  10
  11 # dir:file name:executable:width:height
  12 WGT_PREVIEW = \
  13         actionslider:preview-00.png:widget_preview_actionslider:120:30 \
  14         bg:preview-00.png:widget_preview_bg:50:50 \
  15         box:preview-00.png:widget_preview_box:200:160 \
  16         bubble:preview-00.png:widget_preview_bubble1:160:50 \
  17         bubble:preview-01.png:widget_preview_bubble2:160:50 \
  18         bubble:preview-02.png:widget_preview_bubble3:160:50 \
  19         button:preview-00.png:widget_preview_button1:160:50 \
  20         button:preview-01.png:widget_preview_button2:160:50 \
  21         button:preview-02.png:widget_preview_button3:160:50 \
  22         calendar:preview-00.png:widget_preview_calendar:300:300 \
  23         check:preview-00.png:widget_preview_check1:160:50 \
  24         check:preview-01.png:widget_preview_check2:160:50 \
  25         check:preview-02.png:widget_preview_check3:160:50 \
  26         clock:preview-00.png:widget_preview_clock:200:100 \
  27         colorselector:preview-00.png:widget_preview_colorselector:320:300 \
  28         conformant:preview-00.png:widget_preview_conformant:200:400 \
  29         ctxpopup:preview-00.png:widget_preview_ctxpopup:200:130 \
  30         datetime:preview-00.png:widget_preview_datetime1:360:60 \
  31         datetime:preview-01.png:widget_preview_datetime2:200:60 \
  32         datetime:preview-02.png:widget_preview_datetime3:200:60 \
  33         dayselector:preview-00.png:widget_preview_dayselector:350:50 \
  34         diskselector:preview-00.png:widget_preview_diskselector:120:50 \
  35         entry:preview-00.png:widget_preview_entry1:160:50 \
  36         entry:preview-01.png:widget_preview_entry2:160:50 \
  37         entry:preview-02.png:widget_preview_entry3:160:50 \
  38         entry:preview-03.png:widget_preview_entry4:160:50 \
  39         fileselector:preview-00.png:widget_preview_fileselector:300:300 \
  40         fileselector_button:preview-00.png:widget_preview_fileselector_button1:200:50 \
  41         fileselector_button:preview-01.png:widget_preview_fileselector_button2:200:50 \
  42         fileselector_button:preview-02.png:widget_preview_fileselector_button3:160:50 \
  43         fileselector_entry:preview-00.png:widget_preview_fileselector_entry:70:50 \
  44         flip:preview-00.png:widget_preview_flip:100:100 \
  45         flipselector:preview-00.png:widget_preview_flipselector:100:60 \
  46         frame:preview-00.png:widget_preview_frame:100:50 \
  47         gengrid:preview-00.png:widget_preview_gengrid:200:160 \
  48         genlist:preview-00.png:widget_preview_genlist1:200:200 \
  49         genlist:preview-01.png:widget_preview_genlist2:200:160 \
  50         genlist:preview-02.png:widget_preview_genlist3:200:160 \
  51         genlist:preview-03.png:widget_preview_genlist4:200:160 \
  52         genlist:preview-04.png:widget_preview_genlist5:200:160 \
  53         hover:preview-00.png:widget_preview_hover:90:170 \
  54         hoversel:preview-00.png:widget_preview_hoversel:90:170 \
  55         icon:preview-00.png:widget_preview_icon:50:50 \
  56         image:preview-00.png:widget_preview_image:50:50 \
  57         index:preview-00.png:widget_preview_index:200:160 \
  58         inwin:preview-00.png:widget_preview_inwin1:200:160 \
  59         inwin:preview-01.png:widget_preview_inwin2:200:160 \
  60         inwin:preview-02.png:widget_preview_inwin3:200:160 \
  61         label:preview-00.png:widget_preview_label:70:30 \
  62         layout:preview-00.png:widget_preview_layout:200:160 \
  63         list:preview-00.png:widget_preview_list:200:200 \
  64         map:preview-00.png:widget_preview_map:256:256 \
  65         mapbuf:preview-00.png:widget_preview_mapbuf:200:200 \
  66         menu:preview-00.png:widget_preview_menu:100:100 \
  67         notify:preview-00.png:widget_preview_notify:60:30 \
  68         panel:preview-00.png:widget_preview_panel:150:50 \
  69         panes:preview-00.png:widget_preview_panes:200:100 \
  70         photocam:preview-00.png:widget_preview_photocam:243:162 \
  71         popup:preview-00.png:widget_preview_popup:480:400 \
  72         prefs:preview-00.png:widget_preview_prefs:200:160 \
  73         prefs:preview-00.png:widget_preview_prefs:280:250 \
  74         progressbar:preview-00.png:widget_preview_progressbar:150:50 \
  75         radio:preview-00.png:widget_preview_radio:60:20 \
  76         scroller:preview-00.png:widget_preview_scroller:100:30 \
  77         segment_control:preview-00.png:widget_preview_segment_control:240:120 \
  78         separator:preview-00.png:widget_preview_separator:10:80 \
  79         slider:preview-00.png:widget_preview_slider:200:100 \
  80         slideshow:preview-00.png:widget_preview_slideshow:50:50 \
  81         spinner:preview-00.png:widget_preview_spinner:160:30 \
  82         table::preview-00.png:widget_preview_table:100:100 \
  83         table:preview-00.png:widget_preview_table:100:100 \
  84         thumb:preview-00.png:widget_preview_thumb:100:100 \
  85         toolbar:preview-00.png:widget_preview_toolbar:300:100 \
  86         win:preview-00.png:widget_preview_win:200:200
  87
  88 # put in here every elm widget, so that it gets its hierarchy tree built
  89 # then, make a reference to the generated image, in the form
  90 # @image html <WGTNAME>_inheritance_tree.{png,eps}
  91 WGT_TREE = \
  92         actionslider \
  93         bg \
  94         box \
  95         bubble \
  96         button \
  97         calendar \
  98         check \
  99         clock \
 100         colorselector \
 101         conformant \
 102         container \
 103         ctxpopup \
 104         datetime \
 105         dayselector \
 106         diskselector \
 107         entry \
 108         fileselector \
 109         fileselector_button \
 110         fileselector_entry \
 111         flip \
 112         flipselector \
 113         frame \
 114         gengrid \
 115         genlist \
 116         gesture_layer \
 117         glview \
 118         grid \
 119         hover \
 120         hoversel \
 121         icon \
 122         image \
 123         index \
 124         inwin \
 125         label \
 126         layout \
 127         list \
 128         map \
 129         mapbuf \
 130         menu \
 131         multibuttonentry \
 132         naviframe \
 133         notify \
 134         panel \
 135         panes \
 136         photo \
 137         photocam \
 138         player \
 139         plug \
 140         popup \
 141         prefs \
 142         progressbar \
 143         radio \
 144         route \
 145         scroller \
 146         segment_control \
 147         separator \
 148         slider \
 149         slideshow \
 150         spinner \
 151         table \
 152         thumb \
 153         toolbar \
 154         video \
 155         win
 156
 157 widget-build:
 158         @$(MAKE) -C widgets
 159
 160 widget-preview: widget-build
 161         @for ss in $(WGT_PREVIEW); do \
 162                 ENTRY=($${ss//:/ }) ; \
 163                 DIR=$${ENTRY[0]} ; \
 164                 SS=$${ENTRY[1]} ; \
 165                 BIN=$${ENTRY[2]} ; \
 166                 X=$${ENTRY[3]} ; \
 167                 Y=$${ENTRY[4]} ; \
 168                 echo "Generating widget preview image" $${SS} "for widget" $${DIR}; \
 169                 $(top_srcdir)/doc/shot.sh $(top_builddir)/doc/html/img/widget/$${DIR} $${SS} $(top_builddir)/doc/widgets/$${BIN} $${X} $${Y} ; \
 170                 mkdir -p $(top_builddir)/doc/latex/img/widget/$${DIR} ; \
 171                 convert $(top_builddir)/doc/html/img/widget/$${DIR}/$${SS} $(top_builddir)/doc/latex/img/widget/$${DIR}/$${SS/.png/.eps} ; \
 172         done
 173
 174 widget-tree-figures: doc
 175         $(srcdir)/widget_hierarchy.py --scan $(top_srcdir)/src/lib -o $(builddir)/widget_tree.p;
 176         $(srcdir)/widget_hierarchy.py --tree -i $(builddir)/widget_tree.p > $(builddir)/widgets_tree.dot;
 177         dot -Tpng -o $(top_srcdir)/doc/img/elm-widget-tree.png $(top_builddir)/doc/widgets_tree.dot;
 178         convert $(top_srcdir)/doc/img/elm-widget-tree.png $(top_srcdir)/doc/img/"elm-widget-tree.eps";
 179         @for wgt in $(WGT_TREE); do \
 180                 WGT_FILE_NAME="WNAME_inheritance_tree.dot"; \
 181                 WGT_FILE_NAME=$${WGT_FILE_NAME/WNAME/$${wgt}}; \
 182                 echo "Generating widget inheritance tree image for widget" $${wgt}; \
 183                 $(srcdir)/widget_hierarchy.py --widget=$${wgt} -i $(top_builddir)/doc/widget_tree.p > $(top_builddir)/doc/$${WGT_FILE_NAME}; \
 184                 dot -Tpng -o $(top_srcdir)/doc/img/$${WGT_FILE_NAME/.dot/.png} $(top_builddir)/doc/$${WGT_FILE_NAME}; \
 185                 convert $(top_srcdir)/doc/img/$${WGT_FILE_NAME/.dot/.png} $(top_srcdir)/doc/img/$${WGT_FILE_NAME/.dot/.eps}; \
 186                 rm $${WGT_FILE_NAME}; \
 187         done
 188
 189 doc-clean:
 190         rm -rf img/widget html/ latex/ man/ xml/ $(top_builddir)/$(PACKAGE_DOCNAME).tar*
 191
 192 gen-doc:
 193         $(efl_doxygen)
 194         cp -r $(srcdir)/img/* html/
 195         cp -r $(srcdir)/img/* latex/
 196
 197 #run the last rule whenever the elm widget tree changes
 198 #commit the changed pictures, then. depends on python and graphviz
 199 doc: all doc-clean widget-preview gen-doc
 200         @echo "Entering src/examples/"
 201         $(MAKE) -C $(top_builddir)/src/examples screenshots
 202         rm -rf $(PACKAGE_DOCNAME).tar*
 203         mkdir -p $(PACKAGE_DOCNAME)/doc
 204         cp -R html/ latex/ man/ $(PACKAGE_DOCNAME)/doc
 205         tar cf $(PACKAGE_DOCNAME).tar $(PACKAGE_DOCNAME)/
 206         bzip2 -9 $(PACKAGE_DOCNAME).tar
 207         rm -rf $(PACKAGE_DOCNAME)/
 208         mv $(PACKAGE_DOCNAME).tar.bz2 $(top_builddir)
 209
 210 clean-local: doc-clean
 211
 212 else
 213
 214 doc:
 215         @echo "Documentation not built. Run ./configure --help"
 216
 217 endif
 218
 219 EXTRA_DIST = Doxyfile.in $(wildcard img/*.*) e.css head.html foot.html shot.sh \
 220              DoxygenLayout.xml examples.dox index.doxy