Allow generation of .html and .pdf versions of c-ares man pages.

diff --git a/.cvsignore b/.cvsignore
index ab7a77b..d37034e 100644 (file)
--- 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 (file)
--- 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 (file)
--- 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