forked from enlightenment/efl
elementary: start bringing back documentation support.
I didn't know preview generation was so slow and done completely serialy. There is potential improvement here. Still need to kind of merge the documentation into something readable.
This commit is contained in:
Cedric BAIL
parent
5f17838711
commit
b6a81b6e7b
|
|
@ -5378,6 +5378,7 @@ data/Makefile
|
|||
doc/Makefile
|
||||
doc/Doxyfile
|
||||
doc/previews/Makefile
|
||||
doc/widgets/Makefile
|
||||
src/Makefile
|
||||
src/benchmarks/eina/Makefile
|
||||
src/benchmarks/eo/Makefile
|
||||
|
|
|
|||
185
doc/Makefile.am
185
doc/Makefile.am
|
|
@ -1,4 +1,4 @@
|
|||
SUBDIRS = previews
|
||||
SUBDIRS = previews widgets
|
||||
|
||||
MAINTAINERCLEANFILES = Makefile.in
|
||||
|
||||
|
|
@ -16,8 +16,189 @@ previews-build:
|
|||
|
||||
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 \
|
||||
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
|
||||
|
||||
doc: all previews-build previews-data
|
||||
# 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)
|
||||
cp $(srcdir)/img/* html/
|
||||
cp $(srcdir)/img/*.eps latex/
|
||||
|
|
|
|||
|
|
@ -6,11 +6,11 @@ include ../../Makefile_Elm_Helpers.am
|
|||
|
||||
AM_CPPFLAGS = \
|
||||
-I$(top_srcdir) \
|
||||
-I$(top_srcdir)/src/lib \
|
||||
-I$(top_builddir)/src/lib \
|
||||
-I$(top_srcdir)/src/bin \
|
||||
-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)/$(PACKAGE)\" \
|
||||
-DPACKAGE_DATA_DIR=\"$(datadir)/elementary\" \
|
||||
-DDOCW_DIR=\"$(abs_top_builddir)/doc/widgets\" \
|
||||
@ELEMENTARY_CFLAGS@
|
||||
|
||||
|
|
@ -97,8 +97,17 @@ widget_preview_toolbar \
|
|||
widget_preview_web \
|
||||
widget_preview_win
|
||||
|
||||
LDADD = $(top_builddir)/src/lib/libelementary.la \
|
||||
@ELEMENTARY_LIBS@
|
||||
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
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue