summaryrefslogblamecommitdiff
path: root/legacy/elementary/doc/Makefile.am
blob: 953809c74813e00c42ff877aaafccb50321e1655 (plain) (tree)
1
2
3
4
5
6
7
8
9
10

                 
                                  






                                                           

                                       





                                                                        


                                                             
                                                                 


                                                           
                                                           
                                                                           
                                                                     
                                                                 


                                                                 
                                                                      
                                                                        


                                                           
                                                           



                                                                                       
                                                                                   
                                                         
                                                                        
                                                          
                                                               
                                                                



                                                                




                                                                

                                                            
                                                            










                                                                 

                                                           

                                                                      
                                                                




                                                                               
                                                            
                                                           
                                                           


                                                               
 














                                                                        
                  

                     
                      
               

                             
                            


                      
                 
                 










                       
              
             

                
                          

                   
               

               
                  

                
               
               


                     
                  






                         
                 



               



                            






                                       
                                                                                     
                                                                                                                                                

                                                                                                                                            

            
                        
                                                                                                

                                                                                                         
                                                                                                      









                                                                                                                                              
          
                                                                                        
 
        
                      
                                   
                                    
 

                                                                  
                                         
                                      
                                                           





                                                         
                                                     









                                                               

                                                                                
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