From b45df29dc71816bcd118c42b1749480651f66765 Mon Sep 17 00:00:00 2001 From: Sebastien Badia Date: Sun, 31 Jan 2021 23:35:26 +0100 Subject: [PATCH] docs: gen-docs - Fix pandoc options and re-generate manpages Tested with: LC_ALL=en_US.UTF-8 MANROFFSEQ='' MANWIDTH=80 man \ --warnings -E UTF-8 -l -Tutf8 -Z docs/manpages/startup-config.5 > /dev/null --- docs/gen-docs.sh | 2 +- docs/manpages/l2tpns.8 | 9 ++++++--- docs/manpages/nsctl.8 | 11 +++++++---- docs/manpages/startup-config.5 | 8 +++++++- 4 files changed, 21 insertions(+), 9 deletions(-) diff --git a/docs/gen-docs.sh b/docs/gen-docs.sh index 5128f0e..e112d56 100755 --- a/docs/gen-docs.sh +++ b/docs/gen-docs.sh @@ -16,7 +16,7 @@ echo "Manpages generation …" for src in src/man/*.md do - pandoc -f markdown -t man "$src" > manpages/"$(basename "$src" .md)" && echo "$(basename "$src" .md) successfully built in docs/manpages directory" || echo "Unable to generate manpage from $src" + pandoc -s -t man "$src" -o manpages/"$(basename "$src" .md)" && echo "$(basename "$src" .md) successfully built in docs/manpages directory" || echo "Unable to generate manpage from $src" done # We then generate the rest of the documentation diff --git a/docs/manpages/l2tpns.8 b/docs/manpages/l2tpns.8 index 5c12533..c000e38 100644 --- a/docs/manpages/l2tpns.8 +++ b/docs/manpages/l2tpns.8 @@ -1,3 +1,7 @@ +.\" Automatically generated by Pandoc 2.9.2.1 +.\" +.TH "L2TPNS" "8" "January 31, 2021" "Layer 2 tunneling protocol network server (LNS)" "" +.hy .SH NAME .PP l2tpns - Layer 2 tunneling protocol network server (LNS) @@ -174,8 +178,7 @@ which must be open a L2TP TUNNEL: .SH SEE ALSO .PP \f[B]startup-config\f[R](5), \f[B]nsctl\f[R](8) -.SH AUTHOR -.PP +.SH AUTHORS This manual page was written by Jonathan McDowell and -Fernando Alves (fendo\[at]sameswifi.fr), for the Debian GNU/Linux system +Fernando Alves (), for the Debian GNU/Linux system (but may be used by others). diff --git a/docs/manpages/nsctl.8 b/docs/manpages/nsctl.8 index de2c939..24da208 100644 --- a/docs/manpages/nsctl.8 +++ b/docs/manpages/nsctl.8 @@ -1,3 +1,7 @@ +.\" Automatically generated by Pandoc 2.9.2.1 +.\" +.TH "NSCTL" "8" "January 31, 2021" "Manage running l2tpns instance" "" +.hy .SH NAME .PP nsctl - manage running l2tpns instance @@ -44,8 +48,7 @@ be acted upon). .SH SEE ALSO .PP \f[B]l2tpns\f[R](8) -.SH AUTHOR -.PP +.SH AUTHORS This manual page was written by Jonathan McDowell -, for the Debian GNU/Linux system (but may be -used by others). +, for the Debian GNU/Linux system (but may be used +by others). diff --git a/docs/manpages/startup-config.5 b/docs/manpages/startup-config.5 index 168f7a1..b153780 100644 --- a/docs/manpages/startup-config.5 +++ b/docs/manpages/startup-config.5 @@ -1,3 +1,7 @@ +.\" Automatically generated by Pandoc 2.9.2.1 +.\" +.TH "STARTUP-CONFIG" "5" "January 31, 2021" "Configuration file for l2tpns" "" +.hy .SH NAME .PP startup-config - configuration file for l2tpns @@ -679,4 +683,6 @@ May not be specified on rules with layer 4 matches. .RE .SH SEE ALSO .PP -l2tpns(8) (http://man.he.net/man8/l2tpns) +l2tpns(8), nsctl(8) +.SH AUTHORS +l2tpns developers .