diff options
author | June McEnroe <june@causal.agency> | 2022-01-03 14:08:23 -0500 |
---|---|---|
committer | June McEnroe <june@causal.agency> | 2022-01-03 14:08:23 -0500 |
commit | 62fb45e18ff493e576ddbf24b83d46d064760072 (patch) | |
tree | 368ea224bc9c96b39114f7b396e1853fd7da74e7 /doc | |
parent | Remove sudo/doas from install script (diff) | |
download | src-62fb45e18ff493e576ddbf24b83d46d064760072.tar.gz src-62fb45e18ff493e576ddbf24b83d46d064760072.zip |
Generate RFC bibliographic blocks from JSON
Diffstat (limited to 'doc')
-rw-r--r-- | doc/rfc/Makefile | 4 | ||||
-rw-r--r-- | doc/rfc/rfc.1 | 9 | ||||
-rw-r--r-- | doc/rfc/rfc.in | 22 |
3 files changed, 32 insertions, 3 deletions
diff --git a/doc/rfc/Makefile b/doc/rfc/Makefile index 31e238a0..3078dcd3 100644 --- a/doc/rfc/Makefile +++ b/doc/rfc/Makefile @@ -1,8 +1,8 @@ PREFIX ?= ~/.local MANDIR ?= ${PREFIX}/share/man -MODULE = ftp.rfc-editor.org::rfcs-text-only -RFCS = ${MODULE}/rfc-index.txt ${MODULE}/'rfc[1-9]*.txt' +MODULE = ftp.rfc-editor.org::rfcs +RFCS = ${MODULE}/rfc-index.txt ${MODULE}/'rfc[1-9]*.txt' ${MODULE}/'rfc*.json' all: rfc rfctags diff --git a/doc/rfc/rfc.1 b/doc/rfc/rfc.1 index ece5a901..da393e8b 100644 --- a/doc/rfc/rfc.1 +++ b/doc/rfc/rfc.1 @@ -1,4 +1,4 @@ -.Dd January 18, 2021 +.Dd January 3, 2022 .Dt RFC 1 .Os . @@ -10,6 +10,8 @@ .Sh SYNOPSIS .Nm rfc .Op Ar number +.Nm rfc +.Fl b Ar number .Nm rfctags .Op Ar . @@ -23,6 +25,11 @@ The RFC is displayed in the .Ev PAGER with a tags file generated by .Nm rfctags . +The +.Fl b +option outputs an +.Xr mdoc 7 +bibliographic block. . .Pp The diff --git a/doc/rfc/rfc.in b/doc/rfc/rfc.in index 16081c83..abeb293f 100644 --- a/doc/rfc/rfc.in +++ b/doc/rfc/rfc.in @@ -4,6 +4,28 @@ set -eu mktemp='mktemp -t rfc' [ "$(uname)" = 'OpenBSD' ] && mktemp="${mktemp}.XXXXXXXXXX" +bib= +while getopts 'b:' opt; do + case $opt in + (b) bib=$OPTARG;; + (?) exit 1;; + esac +done +shift $((OPTIND - 1)) + +if test -n "${bib}"; then + exec jq -r ' + ".Rs", + (.authors[] | ".%A \(.)"), + ".%T \(.title | ltrimstr(" "))", + ".%I IETF", + ".%R \(.doc_id)", + ".%U https://tools.ietf.org/html/\(.doc_id | ascii_downcase)", + ".%D \(.pub_date)", + ".Re" + ' %%PREFIX%%/share/rfc/"rfc${bib}.json" +fi + rfc=%%PREFIX%%/share/rfc/"rfc${1:--index}.txt" tags=$($mktemp) trap 'rm "${tags}"' EXIT |