From ba2217050bf269df6cc0b793f9407062d36039ca Mon Sep 17 00:00:00 2001 From: Yang Tse Date: Thu, 21 May 2009 17:40:19 +0000 Subject: [PATCH] Allow generation of .html and .pdf versions of c-ares man pages. --- .cvsignore | 3 + Makefile.am | 46 ++++++++++++++- Makefile.inc | 178 +++++++++++++++++++++++++++++++++++++++++++++++++++-------- 3 files changed, 203 insertions(+), 24 deletions(-) diff --git a/.cvsignore b/.cvsignore index ab7a77b..d37034e 100644 --- a/.cvsignore +++ b/.cvsignore @@ -1,4 +1,6 @@ +*.html *.lo +*.pdf .deps .libs Makefile @@ -22,5 +24,6 @@ libcares.la libcares.pc libtool ltmain.sh +man3 missing stamp-h* diff --git a/Makefile.am b/Makefile.am index 373669c..de2ae90 100644 --- a/Makefile.am +++ b/Makefile.am @@ -46,7 +46,9 @@ noinst_PROGRAMS =$(PROGS) EXTRA_DIST = AUTHORS CHANGES README.cares Makefile.inc Makefile.dj \ Makefile.m32 Makefile.netware Makefile.vc6 $(man_MANS) $(MSVCFILES) \ config-win32.h RELEASE-NOTES libcares.pc.in buildconf get_ver.awk maketgz \ - TODO ares_build.h.in buildconf.bat + TODO ares_build.h.in buildconf.bat $(PDFPAGES) + +CLEANFILES = $(PDFPAGES) $(HTMLPAGES) DISTCLEANFILES = ares_build.h @@ -111,6 +113,48 @@ adig_LDADD = $(top_builddir)/$(lib_LTLIBRARIES) acountry_SOURCES = acountry.c ares_getopt.c ares_getopt.h acountry_LDADD = $(top_builddir)/$(lib_LTLIBRARIES) +SOURCEDMANDIR = man3 +SOURCEDMANPAGES = ares_init.3 +SOURCINGMANPAGES = ares_init_options.3 + +clean-local: clean-sourced-manpages + +clean-sourced-manpages: + @srcdmandir='$(SOURCEDMANDIR)'; \ + echo "rm -rf $(top_builddir)/$$srcdmandir"; \ + rm -rf $(top_builddir)/$$srcdmandir + +sourced-manpages: clean-sourced-manpages + @srcdmandir='$(SOURCEDMANDIR)'; \ + srcdmanfiles='$(SOURCEDMANPAGES)'; \ + mkdir $(top_builddir)/$$srcdmandir; \ + for file in $$srcdmanfiles; do \ + if test -f $(top_srcdir)/$$file; then \ + echo "cp $(top_srcdir)/$$file $(top_builddir)/$$srcdmandir/$$file"; \ + cp $(top_srcdir)/$$file $(top_builddir)/$$srcdmandir/$$file; \ + fi; \ + done + +$(SOURCINGMANPAGES): sourced-manpages + +MAN2HTML = roffit --mandir=. < $< >$@ + +SUFFIXES = .3 .html + +html: $(HTMLPAGES) + +.3.html: + $(MAN2HTML) + +pdf: $(PDFPAGES) + +.3.pdf: + @(foo=`echo $@ | sed -e 's/\.[0-9]$$//g'`; \ + groff -Tps -man $< >$$foo.ps; \ + ps2pdf $$foo.ps $@; \ + rm $$foo.ps; \ + echo "converted $< to $@") + # Make files named *.dist replace the file without .dist extension dist-hook: find $(distdir) -name "*.dist" -exec rm {} \; diff --git a/Makefile.inc b/Makefile.inc index d5e18ac..a701ed6 100644 --- a/Makefile.inc +++ b/Makefile.inc @@ -1,25 +1,157 @@ -CSOURCES = ares_fds.c ares_getsock.c ares_process.c ares_free_hostent.c \ -ares_query.c ares__close_sockets.c ares_free_string.c ares_search.c \ -ares__get_hostent.c ares_gethostbyaddr.c ares_send.c ares__read_line.c \ -ares_gethostbyname.c ares_strerror.c ares_cancel.c ares_init.c \ -ares_timeout.c ares_destroy.c ares_mkquery.c ares_version.c \ -ares_expand_name.c ares_parse_a_reply.c windows_port.c ares_strdup.c \ -ares_expand_string.c ares_parse_ptr_reply.c ares_parse_aaaa_reply.c \ -ares_getnameinfo.c inet_net_pton.c bitncmp.c inet_ntop.c ares_writev.c \ -ares_parse_ns_reply.c ares_llist.c ares__timeval.c ares_strcasecmp.c \ -ares_library_init.c -HHEADERS = ares.h ares_private.h setup.h ares_dns.h ares_version.h \ - nameser.h inet_net_pton.h inet_ntop.h ares_ipv6.h bitncmp.h setup_once.h \ - ares_llist.h ares_strdup.h ares_strcasecmp.h ares_writev.h ares_build.h \ - ares_rules.h ares_library_init.h +CSOURCES = ares__close_sockets.c \ + ares__get_hostent.c \ + ares__read_line.c \ + ares__timeval.c \ + ares_cancel.c \ + ares_destroy.c \ + ares_expand_name.c \ + ares_expand_string.c \ + ares_fds.c \ + ares_free_hostent.c \ + ares_free_string.c \ + ares_gethostbyaddr.c \ + ares_gethostbyname.c \ + ares_getnameinfo.c \ + ares_getsock.c \ + ares_init.c \ + ares_library_init.c \ + ares_llist.c \ + ares_mkquery.c \ + ares_parse_a_reply.c \ + ares_parse_aaaa_reply.c \ + ares_parse_ns_reply.c \ + ares_parse_ptr_reply.c \ + ares_process.c \ + ares_query.c \ + ares_search.c \ + ares_send.c \ + ares_strcasecmp.c \ + ares_strdup.c \ + ares_strerror.c \ + ares_timeout.c \ + ares_version.c \ + ares_writev.c \ + bitncmp.c \ + inet_net_pton.c \ + inet_ntop.c \ + windows_port.c + +HHEADERS = ares.h \ + ares_build.h \ + ares_dns.h \ + ares_ipv6.h \ + ares_library_init.h \ + ares_llist.h \ + ares_private.h \ + ares_rules.h \ + ares_strcasecmp.h \ + ares_strdup.h \ + ares_version.h \ + ares_writev.h \ + bitncmp.h \ + inet_net_pton.h \ + inet_ntop.h \ + nameser.h \ + setup.h \ + setup_once.h + +MANPAGES = ares_cancel.3 \ + ares_destroy.3 \ + ares_destroy_options.3 \ + ares_dup.3 \ + ares_expand_name.3 \ + ares_expand_string.3 \ + ares_fds.3 \ + ares_free_hostent.3 \ + ares_free_string.3 \ + ares_gethostbyaddr.3 \ + ares_gethostbyname.3 \ + ares_gethostbyname_file.3 \ + ares_getnameinfo.3 \ + ares_getsock.3 \ + ares_init.3 \ + ares_init_options.3 \ + ares_library_cleanup.3 \ + ares_library_init.3 \ + ares_mkquery.3 \ + ares_parse_a_reply.3 \ + ares_parse_aaaa_reply.3 \ + ares_parse_ns_reply.3 \ + ares_parse_ptr_reply.3 \ + ares_process.3 \ + ares_query.3 \ + ares_save_options.3 \ + ares_search.3 \ + ares_send.3 \ + ares_set_socket_callback.3 \ + ares_strerror.3 \ + ares_timeout.3 \ + ares_version.3 + +HTMLPAGES = ares_cancel.html \ + ares_destroy.html \ + ares_destroy_options.html \ + ares_dup.html \ + ares_expand_name.html \ + ares_expand_string.html \ + ares_fds.html \ + ares_free_hostent.html \ + ares_free_string.html \ + ares_gethostbyaddr.html \ + ares_gethostbyname.html \ + ares_gethostbyname_file.html \ + ares_getnameinfo.html \ + ares_getsock.html \ + ares_init.html \ + ares_init_options.html \ + ares_library_cleanup.html \ + ares_library_init.html \ + ares_mkquery.html \ + ares_parse_a_reply.html \ + ares_parse_aaaa_reply.html \ + ares_parse_ns_reply.html \ + ares_parse_ptr_reply.html \ + ares_process.html \ + ares_query.html \ + ares_save_options.html \ + ares_search.html \ + ares_send.html \ + ares_set_socket_callback.html \ + ares_strerror.html \ + ares_timeout.html \ + ares_version.html + +PDFPAGES = ares_cancel.pdf \ + ares_destroy.pdf \ + ares_destroy_options.pdf \ + ares_dup.pdf \ + ares_expand_name.pdf \ + ares_expand_string.pdf \ + ares_fds.pdf \ + ares_free_hostent.pdf \ + ares_free_string.pdf \ + ares_gethostbyaddr.pdf \ + ares_gethostbyname.pdf \ + ares_gethostbyname_file.pdf \ + ares_getnameinfo.pdf \ + ares_getsock.pdf \ + ares_init.pdf \ + ares_init_options.pdf \ + ares_library_cleanup.pdf \ + ares_library_init.pdf \ + ares_mkquery.pdf \ + ares_parse_a_reply.pdf \ + ares_parse_aaaa_reply.pdf \ + ares_parse_ns_reply.pdf \ + ares_parse_ptr_reply.pdf \ + ares_process.pdf \ + ares_query.pdf \ + ares_save_options.pdf \ + ares_search.pdf \ + ares_send.pdf \ + ares_set_socket_callback.pdf \ + ares_strerror.pdf \ + ares_timeout.pdf \ + ares_version.pdf -MANPAGES= ares_destroy.3 ares_expand_name.3 ares_expand_string.3 ares_fds.3 \ - ares_free_hostent.3 ares_free_string.3 ares_gethostbyaddr.3 \ - ares_gethostbyname.3 ares_init.3 ares_init_options.3 ares_mkquery.3 \ - ares_parse_a_reply.3 ares_parse_ptr_reply.3 ares_process.3 \ - ares_query.3 ares_search.3 ares_send.3 ares_strerror.3 ares_timeout.3 \ - ares_version.3 ares_cancel.3 ares_parse_aaaa_reply.3 ares_getnameinfo.3 \ - ares_getsock.3 ares_parse_ns_reply.3 ares_dup.3 ares_library_cleanup.3 \ - ares_destroy_options.3 ares_save_options.3 ares_gethostbyname_file.3 \ - ares_set_socket_callback.3 ares_library_init.3 -- 2.7.4