summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMarcel Hollerbach <mail@marcel-hollerbach.de>2019-06-18 08:12:44 +0200
committerMarcel Hollerbach <mail@marcel-hollerbach.de>2019-06-18 08:12:53 +0200
commit4f8e15c16c4f68b6fae8708b177ce672daefc59c (patch)
tree8c1bf8d808e0939bbd83291855961512ee42e70c /doc
parente8c69667b01e2795c1e4ead0536652f935ffa674 (diff)
downloadefl-4f8e15c16c4f68b6fae8708b177ce672daefc59c.tar.gz
Revert "autotools: REMOVAL!"
This reverts commit e8c69667b01e2795c1e4ead0536652f935ffa674. git push on a wrong branch, sorry. This will land today, but not now.
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am263
-rw-r--r--doc/previews/Makefile.am73
-rw-r--r--doc/widgets/Makefile.am196
3 files changed, 532 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000000..17adf520c1
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,263 @@
+SUBDIRS = previews widgets
+
+MAINTAINERCLEANFILES = Makefile.in
+
+.PHONY: doc
+
+PACKAGE_DOCNAME = $(PACKAGE_TARNAME)-$(PACKAGE_VERSION)-doc
+
+if EFL_BUILD_DOC
+
+doc-clean:
+ rm -rf html/ latex/ man/ xml/ $(top_builddir)/$(PACKAGE_DOCNAME).tar*
+
+previews-build:
+ @$(MAKE) -C previews
+
+previews-data:
+ @$(MAKE) -C previews 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 \
+ combobox:preview-00.png:widget_preview_combobox:300:300 \
+ 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 \
+ nstate:preview-00.png:widget_preview_nstate:45:28 \
+ 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 \
+ combobox \
+ 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: all previews-build previews-data widget-preview
+ $(efl_doxygen)
+ @echo "$(efl_doxygen) done !"
+ @echo "copying $(srcdir)/img/*.png to html/"
+ cp $(srcdir)/img/*.png html/
+ @echo "copying $(srcdir)/img/*.eps to latex/"
+ cp $(srcdir)/img/*.eps latex/
+ @echo "Removing older tarball $(PACKAGE_DOCNAME).tar*"
+ rm -rf $(PACKAGE_DOCNAME).tar*
+ @echo "Generating new tarball"
+ $(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
+ @echo "Removing temporary directory"
+ rm -rf $(PACKAGE_DOCNAME)/
+ @echo "Moving tarball $(PACKAGE_DOCNAME).tar.bz2 to $(top_builddir)"
+ mv $(PACKAGE_DOCNAME).tar.bz2 $(top_builddir)
+ @echo "Documentation Package: doc/$(PACKAGE_DOCNAME).tar.bz2"
+ @echo "Documentation HTML: doc/html"
+
+clean-local: doc-clean
+
+else
+
+doc:
+ @echo "Documentation not built. Run ./configure --help"
+
+endif
+
+EXTRA_DIST = \
+Doxyfile.in \
+e.css \
+head.html \
+foot.html \
+ecore_examples.dox \
+eldbus_examples.dox \
+edje_examples.dox \
+eet_examples.dox \
+eina_examples.dox \
+eio_examples.dox \
+emotion_examples.dox \
+eo_tutorial.dox \
+ephysics_examples.dox \
+evas_examples.dox \
+main.dox \
+pkgconfig.dox \
+shot.sh
+
+include images.mk
+
+all-local:
+ @rm -f images.tmp; \
+ echo 'EXTRA_DIST += \' > images.tmp; \
+ (cd $(srcdir) && find ./img -type f -print | cut -d/ -f2- | grep -v '~' | LANG=C LANGUAGE=C LC_ALL=C LC_CTYPE=C LC_NUMERIC=C LC_TIME=C LC_COLLATE=C LC_MONETARY=C LC_MESSAGES=C LC_PAPER=C LC_NAME=C LC_ADDRESS=C LC_TELEPHONE=C LC_MEASUREMENT=C LC_IDENTIFICATION=C sort | tr '\n' ' ') >> images.tmp && \
+ echo >> images.tmp && \
+ if ! cmp "$(srcdir)/images.mk" images.tmp >/dev/null; then \
+ echo "warning: new images added to '$(srcdir)/images.mk'"; \
+ mv -f images.tmp "$(srcdir)/images.mk"; \
+ else \
+ rm images.tmp; \
+ fi
diff --git a/doc/previews/Makefile.am b/doc/previews/Makefile.am
new file mode 100644
index 0000000000..ba952dd154
--- /dev/null
+++ b/doc/previews/Makefile.am
@@ -0,0 +1,73 @@
+if EFL_BUILD_DOC
+
+.PHONY: doc
+
+AM_CPPFLAGS = \
+-I$(top_builddir)/src/lib/efl \
+-I$(top_srcdir)/src/lib/efl \
+-I. \
+-I$(builddir) \
+-I$(top_srcdir)/src/lib/evil \
+-I$(top_builddir)/src/lib/evil \
+-I$(top_srcdir)/src/lib/eina \
+-I$(top_builddir)/src/lib/eina \
+-I$(top_srcdir)/src/lib/eo \
+-I$(top_builddir)/src/lib/eo \
+-I$(top_srcdir)/src/lib/eet \
+-I$(top_builddir)/src/lib/eet \
+-I$(top_srcdir)/src/lib/evas \
+-I$(top_builddir)/src/lib/evas \
+-I$(top_srcdir)/src/lib/ecore \
+-I$(top_builddir)/src/lib/ecore \
+-I$(top_srcdir)/src/lib/ecore_evas \
+-I$(top_builddir)/src/lib/ecore_evas \
+-DEFL_BETA_API_SUPPORT=1 \
+-DEFL_EO_API_SUPPORT=1 \
+@ECORE_EVAS_CFLAGS@
+
+LDADD = \
+$(top_builddir)/src/lib/eina/libeina.la \
+$(top_builddir)/src/lib/eo/libeo.la \
+$(top_builddir)/src/lib/efl/libefl.la \
+$(top_builddir)/src/lib/eet/libeet.la \
+$(top_builddir)/src/lib/evas/libevas.la \
+$(top_builddir)/src/lib/ecore/libecore.la \
+$(top_builddir)/src/lib/ecore_evas/libecore_evas.la \
+@ECORE_EVAS_LDFLAGS@
+
+noinst_PROGRAMS = preview_text_filter
+
+DATADIR = ${abs_top_srcdir}/doc/previews/img
+HTMLDIR = ${abs_top_srcdir}/doc/html
+
+PREVIEWS = blend blur bump curve grow mask transform \
+example_1 padding
+
+previews-data: preview_text_filter
+ $(MKDIR_P) $(DATADIR)
+ $(MKDIR_P) $(HTMLDIR)
+ @for a in $(PREVIEWS) ; do \
+ echo " GEN filter_$${a}.png" ; \
+ FONT="Sans" ; \
+ SIZE=24 ; \
+ TEXT="TEXT" ; \
+ FILTER=`cat ${top_srcdir}/src/examples/evas/filters/filter_$${a}.lua` ; \
+ if [ -e ${top_srcdir}/doc/previews/filter_$${a}.sh ] ; then \
+ source ${top_srcdir}/doc/previews/filter_$${a}.sh ; \
+ fi ; \
+ EVAS_DATA_DIR="$(top_srcdir)/src/lib/evas" $(top_builddir)/doc/previews/preview_text_filter "$${TEXT}" "$${FILTER}" "$(DATADIR)/filter_$${a}.png" "$${FONT}" "$${SIZE}" ; \
+ cp "$(DATADIR)/filter_$${a}.png" "$(HTMLDIR)/" ; \
+ done
+
+if BUILD_EFL_NATIVE
+doc: Makefile previews-data
+endif
+
+
+endif
+
+EXTRA_DIST = preview_text_filter.c
+
+clean-local:
+ rm -rf $(DATADIR)
+
diff --git a/doc/widgets/Makefile.am b/doc/widgets/Makefile.am
new file mode 100644
index 0000000000..e2e75b5ac4
--- /dev/null
+++ b/doc/widgets/Makefile.am
@@ -0,0 +1,196 @@
+MAINTAINERCLEANFILES = Makefile.in
+
+if EFL_BUILD_DOC
+
+include ../../Makefile_Elm_Helpers.am
+
+AM_CPPFLAGS = \
+-I$(top_srcdir) \
+-I$(top_srcdir)/src/lib/elementary \
+-I$(top_builddir)/src/lib/elementary \
+-I$(top_srcdir)/src/bin/elementary \
+-DPACKAGE_BIN_DIR=\"$(bindir)\" \
+-DPACKAGE_DATA_DIR=\"$(datadir)/elementary\" \
+-DDOCW_DIR=\"$(abs_top_builddir)/doc/widgets\" \
+@ELEMENTARY_CFLAGS@
+
+noinst_DATA = widget_preview_prefs.epb
+
+widget_preview_prefs.epb: Makefile widget_preview_prefs.epc
+ $(AM_V_EPB)$(ELM_PREFS_CC) $(ELM_PREFS_FLAGS) \
+ $(top_srcdir)/doc/widgets/widget_preview_prefs.epc \
+ $(top_builddir)/doc/widgets/widget_preview_prefs.epb
+
+noinst_PROGRAMS = \
+widget_preview_actionslider \
+widget_preview_bg \
+widget_preview_box \
+widget_preview_bubble1 \
+widget_preview_bubble2 \
+widget_preview_bubble3 \
+widget_preview_button1 \
+widget_preview_button2 \
+widget_preview_button3 \
+widget_preview_calendar \
+widget_preview_check1 \
+widget_preview_check2 \
+widget_preview_check3 \
+widget_preview_clock \
+widget_preview_colorselector \
+widget_preview_combobox \
+widget_preview_conformant \
+widget_preview_ctxpopup \
+widget_preview_datetime1 \
+widget_preview_datetime2 \
+widget_preview_datetime3 \
+widget_preview_dayselector \
+widget_preview_diskselector \
+widget_preview_entry1 \
+widget_preview_entry2 \
+widget_preview_entry3 \
+widget_preview_entry4 \
+widget_preview_fileselector \
+widget_preview_fileselector_button1 \
+widget_preview_fileselector_button2 \
+widget_preview_fileselector_button3 \
+widget_preview_fileselector_entry \
+widget_preview_flip \
+widget_preview_flipselector \
+widget_preview_frame \
+widget_preview_gengrid \
+widget_preview_genlist1 \
+widget_preview_genlist2 \
+widget_preview_genlist3 \
+widget_preview_genlist4 \
+widget_preview_genlist5 \
+widget_preview_hover \
+widget_preview_hoversel \
+widget_preview_icon \
+widget_preview_image \
+widget_preview_index \
+widget_preview_inwin1 \
+widget_preview_inwin2 \
+widget_preview_inwin3 \
+widget_preview_label \
+widget_preview_layout \
+widget_preview_list \
+widget_preview_map \
+widget_preview_mapbuf \
+widget_preview_menu \
+widget_preview_notify \
+widget_preview_nstate \
+widget_preview_panel \
+widget_preview_panes \
+widget_preview_photocam \
+widget_preview_popup \
+widget_preview_prefs \
+widget_preview_progressbar \
+widget_preview_radio \
+widget_preview_scroller \
+widget_preview_segment_control \
+widget_preview_separator \
+widget_preview_slider \
+widget_preview_slideshow \
+widget_preview_spinner \
+widget_preview_table \
+widget_preview_thumb \
+widget_preview_toolbar \
+widget_preview_web \
+widget_preview_win
+
+LDADD = \
+$(top_builddir)/src/lib/eina/libeina.la \
+$(top_builddir)/src/lib/eo/libeo.la \
+$(top_builddir)/src/lib/efl/libefl.la \
+$(top_builddir)/src/lib/eet/libeet.la \
+$(top_builddir)/src/lib/evas/libevas.la \
+$(top_builddir)/src/lib/ecore/libecore.la \
+$(top_builddir)/src/lib/ecore_evas/libecore_evas.la \
+$(top_builddir)/src/lib/edje/libedje.la \
+$(top_builddir)/src/lib/elementary/libelementary.la \
+@ECORE_EVAS_LDFLAGS@
+
+endif
+
+EXTRA_DIST = \
+ widget_preview_actionslider.c \
+ widget_preview_bg.c \
+ widget_preview_bubble1.c \
+ widget_preview_bubble2.c \
+ widget_preview_bubble3.c \
+ widget_preview_button1.c \
+ widget_preview_button2.c \
+ widget_preview_button3.c \
+ widget_preview_calendar.c \
+ widget_preview_check1.c \
+ widget_preview_check2.c \
+ widget_preview_check3.c \
+ widget_preview_spinner.c \
+ widget_preview_clock.c \
+ widget_preview_colorselector.c \
+ widget_preview_conformant.c \
+ widget_preview_combobox.c \
+ widget_preview_slider.c \
+ widget_preview_panes.c \
+ widget_preview_toolbar.c \
+ widget_preview_mapbuf.c \
+ widget_preview_map.c \
+ widget_preview_ctxpopup.c \
+ widget_preview_datetime1.c \
+ widget_preview_datetime2.c \
+ widget_preview_datetime3.c \
+ widget_preview_dayselector.c \
+ widget_preview_diskselector.c \
+ widget_preview_entry1.c \
+ widget_preview_entry2.c \
+ widget_preview_entry3.c \
+ widget_preview_entry4.c \
+ widget_preview_fileselector_button1.c \
+ widget_preview_fileselector_button2.c \
+ widget_preview_fileselector_button3.c \
+ widget_preview_fileselector.c \
+ widget_preview_fileselector_entry.c \
+ widget_preview_flip.c \
+ widget_preview_flipselector.c \
+ widget_preview_frame.c \
+ widget_preview_hover.c \
+ widget_preview_hoversel.c \
+ widget_preview_icon.c \
+ widget_preview_image.c \
+ widget_preview_index.c \
+ widget_preview_label.c \
+ widget_preview_layout.c \
+ widget_preview_list.c \
+ widget_preview_segment_control.c \
+ widget_preview_popup.c \
+ widget_preview_separator.c \
+ widget_preview_radio.c \
+ widget_preview_panel.c \
+ widget_preview_gengrid.c \
+ widget_preview_genlist1.c \
+ widget_preview_genlist2.c \
+ widget_preview_genlist3.c \
+ widget_preview_genlist4.c \
+ widget_preview_genlist5.c \
+ widget_preview_prefs.c \
+ widget_preview_prefs.epc \
+ widget_preview_progressbar.c \
+ widget_preview_box.c \
+ widget_preview_notify.c \
+ widget_preview_nstate.c \
+ widget_preview_slideshow.c \
+ widget_preview_photocam.c \
+ widget_preview_inwin1.c \
+ widget_preview_inwin2.c \
+ widget_preview_inwin3.c \
+ widget_preview_scroller.c \
+ widget_preview_table.c \
+ widget_preview_win.c \
+ widget_preview_menu.c \
+ widget_preview_thumb.c \
+ widget_preview_web.c \
+ widget_preview_tmpl_foot.c \
+ widget_preview_tmpl_head.c
+
+clean-local:
+ rm -f widget_preview_prefs.epb