Merge branch 'doc-update' into proposed_master

doc/.gitignore

@@ -14,3 +14,5 @@ wrpc.pdf
 *.tp
 /*.txt
 *.vr
+*.out
+version.tex

doc/Makefile

-#
-# Makefile for the documentation directory
-#
-# Copyright 1994,2000,2010,2011   Alessandro Rubini <rubini@linux.it>
-#
-#################
-
-# There is not basenames here, all *.in are considered input
-INPUT = $(wildcard *.in)
-
-TEXI = $(INPUT:.in=.texi)
-INFO = $(INPUT:.in=.info)
-HTML = $(INPUT:.in=.html)
-TXT  = $(INPUT:.in=.txt)
-PDF  = $(INPUT:.in=.pdf)
-
-ALL    = $(INFO) $(HTML) $(TXT) $(PDF)
-
-MAKEINFO ?= makeinfo
-
 RELEASE=$(shell git describe --always --dirty)
 
-%.texi: %.in
-	@rm -f $@
-	sed s/__RELEASE_GIT_ID__/$(RELEASE)/ $< | sed -f ./infofilter > $@
-	emacs -batch --no-site-file -l fixinfo $@
-	chmod -w $@
-
-%.pdf: %.texi
-	texi2pdf --batch $<
-
-%.info: %.texi
-	$(MAKEINFO) $< -o $@
-
-%.html: %.texi
-	$(MAKEINFO) --html --no-split -o $@ $<
-
-%.txt: %.texi
-	$(MAKEINFO) --no-headers $< > $@
-
-##############################################
-.PHONY: all images check terse clean install
-.INTERMEDIATE: $(TEXI)
-
-all: images $(ALL)
-	$(MAKE) terse
-
-images::
-	if [ -d images ]; then $(MAKE) -C images || exit 1; fi
+all : wrpc.pdf
 
-check: _err.ps
-	gs -sDEVICE=linux -r320x200x16 $<
 
-terse:
-	for n in cp fn ky pg toc tp vr aux log; do rm -f *.$$n; done
-	rm -f *~
 
-clean: terse
-	rm -f $(ALL) $(TEXI)
+.PHONY : all clean
 
-install:
+wrpc.pdf : wrpc.tex
+	@echo '\\newcommand{\\gitrevinfo}{'$(RELEASE)'}' > version.tex
+	pdflatex -dPDFSETTINGS=/prepress -dSubsetFonts=true -dEmbedAllFonts=true -dMaxSubsetPct=100 -dCompatibilityLevel=1.4 $^
+	pdflatex -dPDFSETTINGS=/prepress -dSubsetFonts=true -dEmbedAllFonts=true -dMaxSubsetPct=100 -dCompatibilityLevel=1.4 $^
 
+clean :
+	rm -f *.eps *.pdf *.dat *.log *.out *.aux *.dvi *.ps *.toc version.tex

doc/fixinfo

-
-;; use:
-;;     emacs -batch -l ./fixinfo.el <file>
-;; or, better:
-;;     emacs -batch --no-site-file -l ./fixinfo.el <file>
-
-(defun fixinfo (file)
-  (find-file-other-window file)
-  (message (concat "Maxing texinfo tree in " file))
-  (texinfo-all-menus-update)
-  (texinfo-every-node-update)
-  (save-buffer)
-  (kill-buffer (current-buffer))
-)
-
-;; loop over command line arguments
-(mapcar 'fixinfo command-line-args-left)
-(kill-emacs)

doc/infofilter

-#! /usr/bin/sed -f
-
-# allow "%" as a comment char, but only at the beginning of the line
-s/^%/@c /
-#s/[^\\]%.*$//
-s/^\\%/%/
-
-
-#preserve blanks and braces in @example blocks
-/^@example/,/^@end example/ s/{/@{/g
-/^@example/,/^@end example/ s/}/@}/g
-/^@example/,/^@end example/ p
-/^@example/,/^@end example/ d
-/^@smallexample/,/^@end smallexample/ s/{/@{/g
-/^@smallexample/,/^@end smallexample/ s/}/@}/g
-/^@smallexample/,/^@end smallexample/ p
-/^@smallexample/,/^@end smallexample/ d
-
-# remove leading blanks
-s/^[ 	]*//
-