efl/legacy/elementary/doc/Makefile.am

223 lines
7.8 KiB
Makefile

SUBDIRS = widgets
MAINTAINERCLEANFILES = Makefile.in
.PHONY: doc
PACKAGE_DOCNAME = $(PACKAGE_TARNAME)-$(PACKAGE_VERSION)-doc
if EFL_BUILD_DOC
# dir:file name:executable:width:height
WGT_PREVIEW = \
actionslider:preview-00.png:widget_preview_actionslider:120:30 \
bg:preview-00.png:widget_preview_bg:50:50 \
box:preview-00.png:widget_preview_box:200:160 \
bubble:preview-00.png:widget_preview_bubble1:160:50 \
bubble:preview-01.png:widget_preview_bubble2:160:50 \
bubble:preview-02.png:widget_preview_bubble3:160:50 \
button:preview-00.png:widget_preview_button1:160:50 \
button:preview-01.png:widget_preview_button2:160:50 \
button:preview-02.png:widget_preview_button3:160:50 \
calendar:preview-00.png:widget_preview_calendar:300:300 \
check:preview-00.png:widget_preview_check1:160:50 \
check:preview-01.png:widget_preview_check2:160:50 \
check:preview-02.png:widget_preview_check3:160:50 \
clock:preview-00.png:widget_preview_clock:200:100 \
colorselector:preview-00.png:widget_preview_colorselector:320:300 \
conformant:preview-00.png:widget_preview_conformant:200:400 \
ctxpopup:preview-00.png:widget_preview_ctxpopup:200:130 \
datetime:preview-00.png:widget_preview_datetime1:360:60 \
datetime:preview-01.png:widget_preview_datetime2:200:60 \
datetime:preview-02.png:widget_preview_datetime3:200:60 \
dayselector:preview-00.png:widget_preview_dayselector:350:50 \
diskselector:preview-00.png:widget_preview_diskselector:120:50 \
entry:preview-00.png:widget_preview_entry1:160:50 \
entry:preview-01.png:widget_preview_entry2:160:50 \
entry:preview-02.png:widget_preview_entry3:160:50 \
entry:preview-03.png:widget_preview_entry4:160:50 \
fileselector:preview-00.png:widget_preview_fileselector:300:300 \
fileselector_button:preview-00.png:widget_preview_fileselector_button1:200:50 \
fileselector_button:preview-01.png:widget_preview_fileselector_button2:200:50 \
fileselector_button:preview-02.png:widget_preview_fileselector_button3:160:50 \
fileselector_entry:preview-00.png:widget_preview_fileselector_entry:70:50 \
flip:preview-00.png:widget_preview_flip:100:100 \
flipselector:preview-00.png:widget_preview_flipselector:100:60 \
frame:preview-00.png:widget_preview_frame:100:50 \
gengrid:preview-00.png:widget_preview_gengrid:200:160 \
genlist:preview-00.png:widget_preview_genlist1:200:200 \
genlist:preview-01.png:widget_preview_genlist2:200:160 \
genlist:preview-02.png:widget_preview_genlist3:200:160 \
genlist:preview-03.png:widget_preview_genlist4:200:160 \
genlist:preview-04.png:widget_preview_genlist5:200:160 \
hover:preview-00.png:widget_preview_hover:90:170 \
hoversel:preview-00.png:widget_preview_hoversel:90:170 \
icon:preview-00.png:widget_preview_icon:50:50 \
image:preview-00.png:widget_preview_image:50:50 \
index:preview-00.png:widget_preview_index:200:160 \
inwin:preview-00.png:widget_preview_inwin1:200:160 \
inwin:preview-01.png:widget_preview_inwin2:200:160 \
inwin:preview-02.png:widget_preview_inwin3:200:160 \
label:preview-00.png:widget_preview_label:70:30 \
layout:preview-00.png:widget_preview_layout:200:160 \
list:preview-00.png:widget_preview_list:200:200 \
map:preview-00.png:widget_preview_map:256:256 \
mapbuf:preview-00.png:widget_preview_mapbuf:200:200 \
menu:preview-00.png:widget_preview_menu:100:100 \
notify:preview-00.png:widget_preview_notify:60:30 \
panel:preview-00.png:widget_preview_panel:150:50 \
panes:preview-00.png:widget_preview_panes:200:100 \
photocam:preview-00.png:widget_preview_photocam:243:162 \
popup:preview-00.png:widget_preview_popup:480:400 \
prefs:preview-00.png:widget_preview_prefs:200:160 \
prefs:preview-00.png:widget_preview_prefs:280:250 \
progressbar:preview-00.png:widget_preview_progressbar:150:50 \
radio:preview-00.png:widget_preview_radio:60:20 \
scroller:preview-00.png:widget_preview_scroller:100:30 \
segment_control:preview-00.png:widget_preview_segment_control:240:120 \
separator:preview-00.png:widget_preview_separator:10:80 \
slider:preview-00.png:widget_preview_slider:200:100 \
slideshow:preview-00.png:widget_preview_slideshow:50:50 \
spinner:preview-00.png:widget_preview_spinner:160:30 \
table::preview-00.png:widget_preview_table:100:100 \
table:preview-00.png:widget_preview_table:100:100 \
thumb:preview-00.png:widget_preview_thumb:100:100 \
toolbar:preview-00.png:widget_preview_toolbar:300:100 \
web:preview-00.png:widget_preview_web:300:300 \
win:preview-00.png:widget_preview_win:200:200
# put in here every elm widget, so that it gets its hierarchy tree built
# then, make a reference to the generated image, in the form
# @image html <WGTNAME>_inheritance_tree.{png,eps}
WGT_TREE = \
actionslider \
bg \
box \
bubble \
button \
calendar \
check \
clock \
colorselector \
conformant \
container \
ctxpopup \
datetime \
dayselector \
diskselector \
entry \
fileselector \
fileselector_button \
fileselector_entry \
flip \
flipselector \
frame \
gengrid \
genlist \
gesture_layer \
glview \
grid \
hover \
hoversel \
icon \
image \
index \
inwin \
label \
layout \
list \
map \
mapbuf \
menu \
multibuttonentry \
naviframe \
notify \
panel \
panes \
photo \
photocam \
player \
plug \
popup \
prefs \
progressbar \
radio \
route \
scroller \
segment_control \
separator \
slider \
slideshow \
spinner \
table \
thumb \
toolbar \
video \
web \
win
widget-build:
@$(MAKE) -C widgets
widget-preview: widget-build
@for ss in $(WGT_PREVIEW); do \
ENTRY=($${ss//:/ }) ; \
DIR=$${ENTRY[0]} ; \
SS=$${ENTRY[1]} ; \
BIN=$${ENTRY[2]} ; \
X=$${ENTRY[3]} ; \
Y=$${ENTRY[4]} ; \
echo "Generating widget preview image" $${SS} "for widget" $${DIR}; \
$(top_srcdir)/doc/shot.sh $(top_builddir)/doc/html/img/widget/$${DIR} $${SS} $(top_builddir)/doc/widgets/$${BIN} $${X} $${Y} ; \
mkdir -p $(top_builddir)/doc/latex/img/widget/$${DIR} ; \
convert $(top_builddir)/doc/html/img/widget/$${DIR}/$${SS} $(top_builddir)/doc/latex/img/widget/$${DIR}/$${SS/.png/.eps} ; \
done
widget-tree-figures: doc
$(srcdir)/widget_hierarchy.py --scan $(top_srcdir)/src/lib -o $(builddir)/widget_tree.p;
$(srcdir)/widget_hierarchy.py --tree -i $(builddir)/widget_tree.p > $(builddir)/widgets_tree.dot;
dot -Tpng -o $(top_srcdir)/doc/img/elm-widget-tree.png $(top_builddir)/doc/widgets_tree.dot;
convert $(top_srcdir)/doc/img/elm-widget-tree.png $(top_srcdir)/doc/img/"elm-widget-tree.eps";
@for wgt in $(WGT_TREE); do \
WGT_FILE_NAME="WNAME_inheritance_tree.dot"; \
WGT_FILE_NAME=$${WGT_FILE_NAME/WNAME/$${wgt}}; \
echo "Generating widget inheritance tree image for widget" $${wgt}; \
$(srcdir)/widget_hierarchy.py --widget=$${wgt} -i $(top_builddir)/doc/widget_tree.p > $(top_builddir)/doc/$${WGT_FILE_NAME}; \
dot -Tpng -o $(top_srcdir)/doc/img/$${WGT_FILE_NAME/.dot/.png} $(top_builddir)/doc/$${WGT_FILE_NAME}; \
convert $(top_srcdir)/doc/img/$${WGT_FILE_NAME/.dot/.png} $(top_srcdir)/doc/img/$${WGT_FILE_NAME/.dot/.eps}; \
rm $${WGT_FILE_NAME}; \
done
doc-clean:
rm -rf img/widget html/ latex/ man/ xml/ $(top_builddir)/$(PACKAGE_DOCNAME).tar*
gen-doc:
$(efl_doxygen)
cp -r $(srcdir)/img/* html/
cp -r $(srcdir)/img/* latex/
#run the last rule whenever the elm widget tree changes
#commit the changed pictures, then. depends on python and graphviz
doc: all doc-clean widget-preview gen-doc
@echo "Entering src/examples/"
$(MAKE) -C $(top_builddir)/src/examples screenshots
rm -rf $(PACKAGE_DOCNAME).tar*
mkdir -p $(PACKAGE_DOCNAME)/doc
cp -R html/ latex/ man/ $(PACKAGE_DOCNAME)/doc
tar cf $(PACKAGE_DOCNAME).tar $(PACKAGE_DOCNAME)/
bzip2 -9 $(PACKAGE_DOCNAME).tar
rm -rf $(PACKAGE_DOCNAME)/
mv $(PACKAGE_DOCNAME).tar.bz2 $(top_builddir)
clean-local: doc-clean
else
doc:
@echo "Documentation not built. Run ./configure --help"
endif
EXTRA_DIST = Doxyfile.in $(wildcard img/*.*) e.css head.html foot.html shot.sh \
DoxygenLayout.xml examples.dox index.doxy