Fix all the errors lintian(1) reported:

+ "SEE ALSO" sections of man files have paragraph fillings errors which   
  groff(1) complains ("cannot adjust line").  This is because .BR line in 
  "SEE ALSO" section is too long to break properly.  Fix all man pages.
  While on it, move all AUTHORS section to the end of the files, this 
  section should come last.
+ lintian(1) complains about the debian/changelog symlink:
    W: pandoc source: changelog-is-symlink
    N:
    N:   The file debian/changelog is a symlink instead of a regular file. This
    N:   is unnecessary and makes package checking and manipulation more
    N:   difficult. If the changelog should be available in the source package
    N:   under multiple names, make debian/changelog the real file and the
    N:   other names symlinks to it.
    N:
    N:   This problem may have prevented lintian from performing other checks,
    N:   leading to undetected changelog errors.
  Reverse the source and targets in symlink to fix this warning.  Now, the 
  Debian packages can be cleanly built.


git-svn-id: https://pandoc.googlecode.com/svn/trunk@74 788f1e2b-df1e-0410-8736-df70ead52e1b

6 files changed, 39 insertions, 14 deletions

diff --git a/man/man1/html2markdown.1 b/man/man1/html2markdown.1
index 3ff142d3e..c1fe11474 100644
--- a/man/man1/html2markdown.1
+++ b/man/man1/html2markdown.1
@@ -17,7 +17,11 @@ or
 (or text from STDIN)
 from HTML to  markdown-formatted plain text.  It uses an available program
 (e.g. wget, w3m, lynx or curl) to fetch the contents of the URL.
+.SH "SEE ALSO"
+\fBpandoc\fR(1),
+\fBmarkdown2html\fR(1),
+\fBmarkdown2latex\fR(1),
+\fBlatex2markdown\fR(1),
+\fBmarkdown2pdf\fR(1)
 .SH AUTHOR
 John MacFarlane
-.SH "SEE ALSO"
-.BR pandoc (1), markdown2html (1), markdown2latex (1), latex2markdown (1), markdown2pdf (1)
diff --git a/man/man1/latex2markdown.1 b/man/man1/latex2markdown.1
index 9c77b03b1..b4acd363c 100644
--- a/man/man1/latex2markdown.1
+++ b/man/man1/latex2markdown.1
@@ -11,7 +11,11 @@ latex2markdown \- converts LaTeX to markdown-formatted text
 converts 
 .I input-file 
 (or text from STDIN) from LaTeX to markdown-formatted plain text.
+.SH "SEE ALSO"
+\fBpandoc\fR(1),
+\fBmarkdown2html\fR(1),
+\fBhtml2markdown\fR(1),
+\fBmarkdown2latex\fR(1),
+\fBmarkdown2pdf\fR(1)
 .SH AUTHOR
 John MacFarlane
-.SH "SEE ALSO"
-.BR pandoc (1), markdown2html (1), html2markdown (1), markdown2latex (1), markdown2pdf (1)
diff --git a/man/man1/markdown2html.1 b/man/man1/markdown2html.1
index 300aa1a40..63ad7a085 100644
--- a/man/man1/markdown2html.1
+++ b/man/man1/markdown2html.1
@@ -13,7 +13,11 @@ converts
 (or text from STDIN) from markdown-formatted plain text to HTML. 
 If multiple files are specified, they will be combined to make a single
 HTML document.
+.SH "SEE ALSO"
+\fBpandoc\fR(1),
+\fBhtml2markdown\fR(1),
+\fBmarkdown2latex\fR(1),
+\fBlatex2markdown\fR(1),
+\fBmarkdown2pdf\fR(1)
 .SH AUTHOR
 John MacFarlane
-.SH "SEE ALSO"
-.BR pandoc (1), html2markdown (1), markdown2latex (1), latex2markdown (1), markdown2pdf (1)
diff --git a/man/man1/markdown2latex.1 b/man/man1/markdown2latex.1
index ddbbb5456..5529f75ab 100644
--- a/man/man1/markdown2latex.1
+++ b/man/man1/markdown2latex.1
@@ -13,7 +13,11 @@ converts
 (or text from STDIN) from markdown-formatted
 plain text to LaTeX.  If multiple files are specified, they will
 be combined to make a single LaTeX document.
+.SH "SEE ALSO"
+\fBpandoc\fR(1),
+\fBmarkdown2html\fR(1),
+\fBhtml2markdown\fR(1),
+\fBlatex2markdown\fR(1),
+\fBmarkdown2pdf\fR(1)
 .SH AUTHOR
 John MacFarlane
-.SH "SEE ALSO"
-.BR pandoc (1), markdown2html (1), html2markdown (1), latex2markdown (1), markdown2pdf (1)
diff --git a/man/man1/markdown2pdf.1 b/man/man1/markdown2pdf.1
index e0e136bca..420c1bd86 100644
--- a/man/man1/markdown2pdf.1
+++ b/man/man1/markdown2pdf.1
@@ -24,7 +24,12 @@ the output file will be
 If the input is read from STDIN and no output filename is specified, 
 the output file will be named 
 .IR stdin.pdf .
+.SH "SEE ALSO"
+\fBpandoc\fR(1),
+\fBmarkdown2html\fR(1),
+\fBhtml2markdown\fR(1),
+\fBmarkdown2latex\fR(1),
+\fBlatex2markdown\fR(1),
+\fBpdflatex\fR(1)
 .SH AUTHOR
 John MacFarlane
-.SH "SEE ALSO"
-.BR pandoc (1), markdown2html (1), html2markdown (1), markdown2latex (1), latex2markdown (1), pdflatex (1)
diff --git a/man/man1/pandoc.1 b/man/man1/pandoc.1
index fdf79a8a7..6ca3bb9e4 100644
--- a/man/man1/pandoc.1
+++ b/man/man1/pandoc.1
@@ -159,11 +159,13 @@ Specify
 .I STRING
 as a prefix to the HTML window title.
 
-.SH AUTHOR
-John MacFarlane
-
 .SH "SEE ALSO"
-.BR markdown2html (1), html2markdown (1), markdown2latex (1), latex2markdown (1), markdown2pdf (1), iconv (1)
+\fBmarkdown2html\fR(1),
+\fBhtml2markdown\fR(1),
+\fBmarkdown2latex\fR(1),
+\fBlatex2markdown\fR(1),
+\fBmarkdown2pdf\fR(1),
+\fBiconv\fR(1)
 
 The
 .I README
@@ -171,3 +173,5 @@ file distributed with Pandoc contains full documentation.
 
 The Pandoc source code and all documentation may be downloaded from
 <http://sophos.berkeley.edu/macfarlane/pandoc/>.
+.SH AUTHOR
+John MacFarlane