summary refs log tree commit diff
path: root/doc/rfc
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doc/rfc/.gitignore3
-rw-r--r--doc/rfc/Makefile21
-rw-r--r--doc/rfc/rfc.vim30
-rw-r--r--doc/rfc/rfctags.pl28
4 files changed, 82 insertions, 0 deletions
diff --git a/doc/rfc/.gitignore b/doc/rfc/.gitignore
new file mode 100644
index 00000000..808cd63e
--- /dev/null
+++ b/doc/rfc/.gitignore
@@ -0,0 +1,3 @@
+*.txt
+*.txt.gz
+tags
diff --git a/doc/rfc/Makefile b/doc/rfc/Makefile
new file mode 100644
index 00000000..87462a6c
--- /dev/null
+++ b/doc/rfc/Makefile
@@ -0,0 +1,21 @@
+PREFIX ?= ~/.local
+
+MODULE = ftp.rfc-editor.org::rfcs-text-only
+
+tags: rfctags.pl rfc-index.txt.gz
+	perl rfctags.pl | sort -f > $@
+
+rfc-index.txt.gz:
+	rsync -ptz ${MODULE}/rfc-index.txt ${MODULE}/'rfc[1-9]*.txt' .
+	gzip -9f *.txt
+
+clean:
+	rm -f tags *.txt *.txt.gz
+
+install: tags rfc.vim
+	install -d ${PREFIX}/share/rfc ${PREFIX}/share/nvim/site/plugin
+	ln -f tags *.txt.gz ${PREFIX}/share/rfc
+	install -m 644 rfc.vim ${PREFIX}/share/nvim/site/plugin
+
+uninstall:
+	rm -fr ${PREFIX}/share/rfc ${PREFIX}/share/nvim/site/plugin/rfc.vim
diff --git a/doc/rfc/rfc.vim b/doc/rfc/rfc.vim
new file mode 100644
index 00000000..2455d8a6
--- /dev/null
+++ b/doc/rfc/rfc.vim
@@ -0,0 +1,30 @@
+if !exists('g:rfc_path')
+	let g:rfc_path = expand('<sfile>:h:h:h:h') . '/rfc'
+endif
+
+function! s:RFC(number)
+	if !empty(a:number)
+		let number = str2nr(matchstr(a:number, '\d\+'), 10)
+	else
+		let number = '-index'
+	endif
+	let path = expand(g:rfc_path . '/rfc' . number . '.txt.gz')
+	if filereadable(path)
+		execute 'silent' 'noswapfile' 'view' path
+	else
+		echohl ErrorMsg | echo 'No such RFC' a:number | echohl None
+	endif
+endfunction
+
+function! s:BufRead()
+	setlocal readonly
+	setlocal keywordprg=:RFC
+	setlocal iskeyword=a-z,A-Z,48-57,.,[,],-,_
+	nmap <buffer> <silent> gO :call search('^Table of Contents', 'bcs')<CR>
+endfunction
+
+command! -bar -nargs=? RFC call s:RFC(<q-args>)
+augroup RFC
+	autocmd!
+	autocmd BufRead rfc*.txt.gz call s:BufRead()
+augroup END
diff --git a/doc/rfc/rfctags.pl b/doc/rfc/rfctags.pl
new file mode 100644
index 00000000..01324a0d
--- /dev/null
+++ b/doc/rfc/rfctags.pl
@@ -0,0 +1,28 @@
+use strict;
+use warnings;
+use open ':encoding(ISO-8859-1)';
+
+use IO::Uncompress::Gunzip qw($GunzipError);
+
+($,, $\) = ("\t", "\n");
+print '!_TAG_FILE_SORTED', 2, $0; # Promise to pipe this through sort -f
+for my $rfc (<*.txt.gz>) {
+	my $handle = new IO::Uncompress::Gunzip $rfc
+		or die "${rfc}: ${GunzipError}";
+	while (<$handle>) {
+		chomp;
+		# Section headings
+		if (/^([\d.]+|[A-Z][.])\s+([^\t]+)?/) {
+			print $1, $rfc, $.;
+			print $2, $rfc, $. if $2;
+			print $1, $rfc, $. if $1 =~ /^([\d.]+)[.]$/;
+		}
+		# References
+		if (/^\s*(\[[\w-]+\])\s{2,}/) {
+			print $1, $rfc, $.;
+			print "\\$1", $rfc, $.; # vim ^] prepends \ to [
+		}
+	}
+	die "${rfc}: $!" if $!;
+	close $handle;
+}