From 818cb81feb8f8426a0a6cd43b6928f92dec907b1 Mon Sep 17 00:00:00 2001
From: Nikos Mavrogiannopoulos <nmav@gnutls.org>
Date: Sat, 4 Aug 2012 21:55:37 +0200
Subject: [PATCH] better doc output

---
 doc/Makefile.am |  2 ++
 doc/gnutls.texi | 42 +++++++++++++++++++++---------------------
 2 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 33e982eb3..873e74062 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -353,11 +353,13 @@ DISTCLEANFILES += $(ENUMS) stamp_enums stamp_functions
 
 stamp_functions: gnutls-api.texi x509-api.texi pgp-api.texi pkcs12-api.texi pkcs11-api.texi abstract-api.texi compat-api.texi dtls-api.texi crypto-api.texi ocsp-api.texi
 	-mkdir functions
+	-mkdir functions.short
 	for i in $^; do \
 		$(srcdir)/scripts/split-texi.pl functions < $$i; \
 	done
 	sed -i 's/\@anchor{.*//g' functions/*
 	sed -i 's/\@subheading.*//g' functions/*
+	cd functions && for i in *;do grep ^"@deftypefun" $$i | sed 's/@deftypefun/@item/g;s/ {/ @var{/;s/ {/ @ref{/' > ../functions.short/$$i;done
 	echo $@ > $@
 	$(MAKE) compare-makefile
 
diff --git a/doc/gnutls.texi b/doc/gnutls.texi
index 0a2604c64..076536bd9 100644
--- a/doc/gnutls.texi
+++ b/doc/gnutls.texi
@@ -76,52 +76,52 @@ Documentation License''.
 
 @macro showfuncA{ref}
 @table @code
-@item @ref{\ref\}
+@include functions.short/\ref\
 @end table
 @end macro
 
 @macro showfuncB{ref1,ref2}
 @table @code
-@item @ref{\ref1\}
-@item @ref{\ref2\}
+@include functions.short/\ref1\
+@include functions.short/\ref2\
 @end table
 @end macro
 
 @macro showfuncC{ref1,ref2,ref3}
 @table @code
-@item @ref{\ref1\}
-@item @ref{\ref2\}
-@item @ref{\ref3\}
+@include functions.short/\ref1\
+@include functions.short/\ref2\
+@include functions.short/\ref3\
 @end table
 @end macro
 
 @macro showfuncD{ref1,ref2,ref3,ref4}
 @table @code
-@item @ref{\ref1\}
-@item @ref{\ref2\}
-@item @ref{\ref3\}
-@item @ref{\ref4\}
+@include functions.short/\ref1\
+@include functions.short/\ref2\
+@include functions.short/\ref3\
+@include functions.short/\ref4\
 @end table
 @end macro
 
 @macro showfuncE{ref1,ref2,ref3,ref4,ref5}
 @table @code
-@item @ref{\ref1\}
-@item @ref{\ref2\}
-@item @ref{\ref3\}
-@item @ref{\ref4\}
-@item @ref{\ref5\}
+@include functions.short/\ref1\
+@include functions.short/\ref2\
+@include functions.short/\ref3\
+@include functions.short/\ref4\
+@include functions.short/\ref5\
 @end table
 @end macro
 
 @macro showfuncF{ref1,ref2,ref3,ref4,ref5,ref6}
 @table @code
-@item @ref{\ref1\}
-@item @ref{\ref2\}
-@item @ref{\ref3\}
-@item @ref{\ref4\}
-@item @ref{\ref5\}
-@item @ref{\ref6\}
+@include functions.short/\ref1\
+@include functions.short/\ref2\
+@include functions.short/\ref3\
+@include functions.short/\ref4\
+@include functions.short/\ref5\
+@include functions.short/\ref6\
 @end table
 @end macro
 
-- 
2.11.4.GIT