docs/makefile

# this makefile assumes that you have docutils and rst2pdf installed

WEB_PATH = ~/Documents/rasterbar/web/products/libtorrent

REFERENCE_TARGETS = \
	reference \
	reference-Session \
	reference-Core \
	reference-String \
	reference-Plugins \
	reference-Create_Torrents \
	reference-Error_Codes \
	reference-Time \
	reference-Storage \
	reference-Custom_Storage \
	reference-Utility \
	reference-Bencoding \
	reference-Alerts \
	reference-RSS \
	reference-Filter \
	reference-Settings \
	manual-ref

TARGETS = index \
	udp_tracker_protocol \
	dht_rss \
	dht_store \
	client_test \
	building \
	features \
	contributing\
	examples \
	extension_protocol \
	dht_extensions \
	dht_sec \
	python_binding \
	projects \
	utp \
	tuning \
	hacking \
	$(REFERENCE_TARGETS)

FIGURES = read_disk_buffers write_disk_buffers troubleshooting

html: $(TARGETS:=.html) $(FIGURES:=.png) todo.html 

pdf: $(TARGETS:=.pdf) $(FIGURES:=.eps)

epub: $(TARGETS:=.epub) $(FIGURES:=.png)

all: html

todo.html:gen_todo.py ../src/*.cpp ../include/libtorrent/*.hpp
	python gen_todo.py

$(REFERENCE_TARGETS:=.rst):gen_reference_doc.py ../include/libtorrent/*.hpp ../include/libtorrent/kademlia/*.hpp manual.rst
	python gen_reference_doc.py

%.epub:%.rst
	rst2epub $? $@

%.pdf:%.rst
	rst2pdf $? -o $@ --stylesheets stylesheet

%.html:%.rst
	rst2html-2.6.py --template=template.txt --stylesheet-path=style.css --link-stylesheet --no-toc-backlinks $? > $@
	cp $@ $(WEB_PATH)/$@

%.png:%.dot
	dot -Tpng $? >$@
	cp $@ $(WEB_PATH)/$@

%.eps:%.dot
	dot -Teps $? >$@
	cp $@ $(WEB_PATH)/$@

clean:
	rm -f $(TARGETS:=.html) $(TARGETS:=.pdf) todo.html reference*.html reference*.rst
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`# this makefile assumes that you have docutils and rst2pdf installed`

regenerated documentation. added makefile for docs, added rst template file 2008-10-17 03:23:30 +00:00			`WEB_PATH = ~/Documents/rasterbar/web/products/libtorrent`

automatically generate links in reference documentation for symbols (classes, enums, enum values, functions and member functions) 2013-08-05 05:26:15 +00:00			`REFERENCE_TARGETS = \`
			`reference \`
move some defines from headers to cpp files (to improve ABI stability). add some documentation. regenerate html. minor fixes to documentation script 2013-12-19 05:35:47 +00:00			`reference-Session \`
automatically generate links in reference documentation for symbols (classes, enums, enum values, functions and member functions) 2013-08-05 05:26:15 +00:00			`reference-Core \`
			`reference-String \`
			`reference-Plugins \`
			`reference-Create_Torrents \`
			`reference-Error_Codes \`
			`reference-Time \`
			`reference-Storage \`
			`reference-Custom_Storage \`
			`reference-Utility \`
			`reference-Bencoding \`
			`reference-Alerts \`
			`reference-RSS \`
move torrent_handle documentation into header file 2013-08-06 02:50:57 +00:00			`reference-Filter \`
more documentation polishing. the manual.rst is now also linked to the reference documentation 2013-08-11 16:57:33 +00:00			`reference-Settings \`
			`manual-ref`
automatically generate links in reference documentation for symbols (classes, enums, enum values, functions and member functions) 2013-08-05 05:26:15 +00:00
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`TARGETS = index \`
			`udp_tracker_protocol \`
add DHT extension proposal document 2011-01-02 03:53:28 +00:00			`dht_rss \`
add support for mutable put/get functions in DHT 2011-05-25 02:26:07 +00:00			`dht_store \`
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`client_test \`
			`building \`
			`features \`
regenerated html and added contribution page 2010-02-18 20:01:23 +00:00			`contributing\`
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`examples \`
			`extension_protocol \`
			`dht_extensions \`
first implementation of DHT security implementation. tie the node ID to the external IP 2010-12-11 09:38:07 +00:00			`dht_sec \`
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`python_binding \`
documentation update 2009-02-09 03:48:27 +00:00			`projects \`
merged uTP branch into trunk (yay) 2010-11-29 01:33:05 +00:00			`utp \`
add some documentation of the internals of libtorrent 2011-12-11 09:44:05 +00:00			`tuning \`
generate rst instead of html for reference documentation. This allows for RST markup in comments 2013-07-24 05:04:46 +00:00			`hacking \`
automatically generate links in reference documentation for symbols (classes, enums, enum values, functions and member functions) 2013-08-05 05:26:15 +00:00			`$(REFERENCE_TARGETS)`
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00
added early version of trouble shooting guide 2011-03-13 18:19:09 +00:00			`FIGURES = read_disk_buffers write_disk_buffers troubleshooting`
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00
generate rst instead of html for reference documentation. This allows for RST markup in comments 2013-07-24 05:04:46 +00:00			`html: $(TARGETS:=.html) $(FIGURES:=.png) todo.html`
documentation update 2009-02-09 03:48:27 +00:00
			`pdf: $(TARGETS:=.pdf) $(FIGURES:=.eps)`
fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00
add epub target for documentation makefile 2012-12-31 06:51:04 +00:00			`epub: $(TARGETS:=.epub) $(FIGURES:=.png)`

fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`all: html`

clean up the root directory by moving parsing scripts into the tools directory 2013-06-14 16:49:06 +00:00			`todo.html:gen_todo.py ../src/.cpp ../include/libtorrent/.hpp`
			`python gen_todo.py`

more documentation polishing. the manual.rst is now also linked to the reference documentation 2013-08-11 16:57:33 +00:00			`$(REFERENCE_TARGETS:=.rst):gen_reference_doc.py ../include/libtorrent/.hpp ../include/libtorrent/kademlia/.hpp manual.rst`
add script to extract reference documentation from headers 2013-07-19 16:29:53 +00:00			`python gen_reference_doc.py`

add epub target for documentation makefile 2012-12-31 06:51:04 +00:00			`%.epub:%.rst`
			`rst2epub $? $@`

fixed typos in documentation and made makefile build pdfs with rst2pdf 2008-10-17 17:31:20 +00:00			`%.pdf:%.rst`
updated docs makefile and added rst2pdf stylesheet 2008-10-22 00:55:51 +00:00			`rst2pdf $? -o $@ --stylesheets stylesheet`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 03:23:30 +00:00
			`%.html:%.rst`
regenerate html 2012-06-06 18:14:55 +00:00			`rst2html-2.6.py --template=template.txt --stylesheet-path=style.css --link-stylesheet --no-toc-backlinks $? > $@`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 03:23:30 +00:00			`cp $@ $(WEB_PATH)/$@`

added early version of trouble shooting guide 2011-03-13 18:19:09 +00:00			`%.png:%.dot`
			`dot -Tpng $? >$@`
			`cp $@ $(WEB_PATH)/$@`

documentation update 2009-02-09 03:48:27 +00:00			`%.eps:%.dot`
			`dot -Teps $? >$@`
			`cp $@ $(WEB_PATH)/$@`

regenerated documentation. added makefile for docs, added rst template file 2008-10-17 03:23:30 +00:00			`clean:`
minor fixes 2013-08-01 16:15:02 +00:00			`rm -f $(TARGETS:=.html) $(TARGETS:=.pdf) todo.html reference.html reference.rst`
regenerated documentation. added makefile for docs, added rst template file 2008-10-17 03:23:30 +00:00