added manpages

Author: samsk

ChangeLog

@@ -1,6 +1,10 @@
 
+0.3.0 Sun Nov 23 21:12:54 CET 2014
+	- add manpages
+	- release
+
 0.3.0b2 Thu Nov 20 23:10:47 CET 2014
-	- backtrace2line.pl support for decoding native lib backtraces
+	- backtrace2line.pl support for decoding native glibc backtraces
 	- add log-malloc2_util.h inline only helper functions
 
 0.3.0b Mon Nov 10 00:00:00 CET 2014

Makefile.am

@@ -23,7 +23,8 @@ dist_libexec_SCRIPTS = scripts/backtrace2line.pl scripts/log-malloc.pl \
 libexec_SCRIPTS = scripts/log-malloc.pm
 
 install-exec-hook:
-	for i in $(dist_libexec_SCRIPTS); do bn=`basename $${i}`; $(LN_S) -f "${libexecdir}/$${bn}" "$(bindir)/$${bn%.pl}"; done;
+	for i in $(dist_libexec_SCRIPTS); do bn=`basename $${i}`;\
+		$(LN_S) -f "${libexecdir}/$${bn}" "$(bindir)/$${bn%.pl}"; done;
 
 ## pkconfig
 pkgconfigdir = $(libdir)/pkgconfig
@@ -35,5 +36,13 @@ dist_noinst_SCRIPTS = autogen.sh
 ## examples
 dist_noinst_DATA = examples/Makefile examples/*.c
 
+# manpages
+scripts_man_MANS = $(dist_libexec_SCRIPTS:.pl=.1)
+man_MANS = $(scripts_man_MANS)
+%.1: %.pl
+	pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
+		--section=1 $< > $@
+CLEANFILES = $(man_MANS)
+
 ## test
 .PHONY: test

Makefile.in

@@ -101,8 +101,8 @@ am__uninstall_files_from_dir = { \
          $(am__cd) "$$dir" && rm -f $$files; }; \
   }
 am__installdirs = "$(DESTDIR)$(libdir)" "$(DESTDIR)$(libexecdir)" \
-	"$(DESTDIR)$(libexecdir)" "$(DESTDIR)$(pkgconfigdir)" \
-	"$(DESTDIR)$(pkgincludedir)"
+	"$(DESTDIR)$(libexecdir)" "$(DESTDIR)$(man1dir)" \
+	"$(DESTDIR)$(pkgconfigdir)" "$(DESTDIR)$(pkgincludedir)"
 LTLIBRARIES = $(lib_LTLIBRARIES)
 liblog_malloc2_la_LIBADD =
 am__dirstamp = $(am__leading_dot)dirstamp
@@ -134,6 +134,9 @@ am__can_run_installinfo = \
     n|no|NO) false;; \
     *) (install-info --version) >/dev/null 2>&1;; \
   esac
+man1dir = $(mandir)/man1
+NROFF = nroff
+MANS = $(man_MANS)
 DATA = $(dist_noinst_DATA) $(pkgconfig_DATA)
 HEADERS = $(pkginclude_HEADERS)
 ETAGS = etags
@@ -290,6 +293,11 @@ pkgconfigdir = $(libdir)/pkgconfig
 pkgconfig_DATA = log-malloc2.pc
 dist_noinst_SCRIPTS = autogen.sh
 dist_noinst_DATA = examples/Makefile examples/*.c
+
+# manpages
+scripts_man_MANS = $(dist_libexec_SCRIPTS:.pl=.1)
+man_MANS = $(scripts_man_MANS)
+CLEANFILES = $(man_MANS)
 all: config.h
 	$(MAKE) $(AM_MAKEFLAGS) all-am
 
@@ -508,6 +516,49 @@ clean-libtool:
 
 distclean-libtool:
 	-rm -f libtool config.lt
+install-man1: $(man_MANS)
+	@$(NORMAL_INSTALL)
+	@list1=''; \
+	list2='$(man_MANS)'; \
+	test -n "$(man1dir)" \
+	  && test -n "`echo $$list1$$list2`" \
+	  || exit 0; \
+	echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \
+	$(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \
+	{ for i in $$list1; do echo "$$i"; done;  \
+	if test -n "$$list2"; then \
+	  for i in $$list2; do echo "$$i"; done \
+	    | sed -n '/\.1[a-z]*$$/p'; \
+	fi; \
+	} | while read p; do \
+	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
+	  echo "$$d$$p"; echo "$$p"; \
+	done | \
+	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
+	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
+	sed 'N;N;s,\n, ,g' | { \
+	list=; while read file base inst; do \
+	  if test "$$base" = "$$inst"; then list="$$list $$file"; else \
+	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \
+	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \
+	  fi; \
+	done; \
+	for i in $$list; do echo "$$i"; done | $(am__base_list) | \
+	while read files; do \
+	  test -z "$$files" || { \
+	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \
+	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \
+	done; }
+
+uninstall-man1:
+	@$(NORMAL_UNINSTALL)
+	@list=''; test -n "$(man1dir)" || exit 0; \
+	files=`{ for i in $$list; do echo "$$i"; done; \
+	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
+	  sed -n '/\.1[a-z]*$$/p'; \
+	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
+	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
+	dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir)
 install-pkgconfigDATA: $(pkgconfig_DATA)
 	@$(NORMAL_INSTALL)
 	@list='$(pkgconfig_DATA)'; test -n "$(pkgconfigdir)" || list=; \
@@ -604,6 +655,19 @@ distclean-tags:
 	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
 
 distdir: $(DISTFILES)
+	@list='$(MANS)'; if test -n "$$list"; then \
+	  list=`for p in $$list; do \
+	    if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
+	    if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \
+	  if test -n "$$list" && \
+	    grep 'ab help2man is required to generate this page' $$list >/dev/null; then \
+	    echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \
+	    grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/         /' >&2; \
+	    echo "       to fix them, install help2man, remove and regenerate the man pages;" >&2; \
+	    echo "       typically \`make maintainer-clean' will remove them" >&2; \
+	    exit 1; \
+	  else :; fi; \
+	else :; fi
 	$(am__remove_distdir)
 	test -d "$(distdir)" || mkdir "$(distdir)"
 	@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
@@ -767,9 +831,10 @@ distcleancheck: distclean
 	       exit 1; } >&2
 check-am: all-am
 check: check-am
-all-am: Makefile $(LTLIBRARIES) $(SCRIPTS) $(DATA) $(HEADERS) config.h
+all-am: Makefile $(LTLIBRARIES) $(SCRIPTS) $(MANS) $(DATA) $(HEADERS) \
+		config.h
 installdirs:
-	for dir in "$(DESTDIR)$(libdir)" "$(DESTDIR)$(libexecdir)" "$(DESTDIR)$(libexecdir)" "$(DESTDIR)$(pkgconfigdir)" "$(DESTDIR)$(pkgincludedir)"; do \
+	for dir in "$(DESTDIR)$(libdir)" "$(DESTDIR)$(libexecdir)" "$(DESTDIR)$(libexecdir)" "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(pkgconfigdir)" "$(DESTDIR)$(pkgincludedir)"; do \
 	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
 	done
 install: install-am
@@ -794,6 +859,7 @@ install-strip:
 mostlyclean-generic:
 
 clean-generic:
+	-test -z "$(CLEANFILES)" || rm -f $(CLEANFILES)
 
 distclean-generic:
 	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
@@ -828,7 +894,8 @@ info: info-am
 
 info-am:
 
-install-data-am: install-pkgconfigDATA install-pkgincludeHEADERS
+install-data-am: install-man install-pkgconfigDATA \
+	install-pkgincludeHEADERS
 
 install-dvi: install-dvi-am
 
@@ -846,7 +913,7 @@ install-info: install-info-am
 
 install-info-am:
 
-install-man:
+install-man: install-man1
 
 install-pdf: install-pdf-am
 
@@ -879,9 +946,11 @@ ps: ps-am
 ps-am:
 
 uninstall-am: uninstall-dist_libexecSCRIPTS uninstall-libLTLIBRARIES \
-	uninstall-libexecSCRIPTS uninstall-pkgconfigDATA \
+	uninstall-libexecSCRIPTS uninstall-man uninstall-pkgconfigDATA \
 	uninstall-pkgincludeHEADERS
 
+uninstall-man: uninstall-man1
+
 .MAKE: all install-am install-exec-am install-strip
 
 .PHONY: CTAGS GTAGS all all-am am--refresh check check-am clean \
@@ -896,19 +965,23 @@ uninstall-am: uninstall-dist_libexecSCRIPTS uninstall-libLTLIBRARIES \
 	install-exec install-exec-am install-exec-hook install-html \
 	install-html-am install-info install-info-am \
 	install-libLTLIBRARIES install-libexecSCRIPTS install-man \
-	install-pdf install-pdf-am install-pkgconfigDATA \
+	install-man1 install-pdf install-pdf-am install-pkgconfigDATA \
 	install-pkgincludeHEADERS install-ps install-ps-am \
 	install-strip installcheck installcheck-am installdirs \
 	maintainer-clean maintainer-clean-generic mostlyclean \
 	mostlyclean-compile mostlyclean-generic mostlyclean-libtool \
 	pdf pdf-am ps ps-am tags uninstall uninstall-am \
 	uninstall-dist_libexecSCRIPTS uninstall-libLTLIBRARIES \
-	uninstall-libexecSCRIPTS uninstall-pkgconfigDATA \
-	uninstall-pkgincludeHEADERS
+	uninstall-libexecSCRIPTS uninstall-man uninstall-man1 \
+	uninstall-pkgconfigDATA uninstall-pkgincludeHEADERS
 
 
 install-exec-hook:
-	for i in $(dist_libexec_SCRIPTS); do bn=`basename $${i}`; $(LN_S) -f "${libexecdir}/$${bn}" "$(bindir)/$${bn%.pl}"; done;
+	for i in $(dist_libexec_SCRIPTS); do bn=`basename $${i}`;\
+		$(LN_S) -f "${libexecdir}/$${bn}" "$(bindir)/$${bn%.pl}"; done;
+%.1: %.pl
+	pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
+		--section=1 $< > $@
 
 .PHONY: test
 

scripts/log-malloc-findleak.pl

@@ -306,7 +306,7 @@ =head1 DESCRIPTION
 This script analyzes input trace file (or part of it) produced by log-malloc2 library, and prints out
 suspected memory leaks along with translated backtrace path to code allocating that memory.
 
-NOTE: This script can be also usesd as perl module.
+NOTE: This script can be also used as perl module.
 
 =head1 ARGUMENTS
 

src/log-malloc2.c

@@ -150,9 +150,6 @@ static void *__init_lib(void)
 
 	LOCK_INIT();
 
-	fprintf(stderr, "\n *** log-malloc trace-fd = %d *** \n\n",
-		g_ctx.memlog_fd);
-
 	/* open statm */
 	if(g_statm_path[0] != '\0' && (g_ctx.statm_fd = open(g_statm_path, 0)) == -1)
 		fprintf(stderr, "\n*** log-malloc: could not open %s\n\n", g_statm_path);
@@ -205,6 +202,9 @@ static void *__init_lib(void)
 		/* auto-disable trace if file is not open  */
 		if(w == -1 && errno == EBADF)
 			g_ctx.memlog_disabled = true;
+
+		fprintf(stderr, "\n *** log-malloc trace-fd = %d *** \n\n",
+			g_ctx.memlog_fd);
 	}
 
 	return (void *)0x01;