diff options
| -rw-r--r-- | Makefile | 8 | ||||
| -rw-r--r-- | doc/swextreload.1 | 91 | ||||
| -rw-r--r-- | doc/swextreload.1.txt | 47 |
3 files changed, 146 insertions, 0 deletions
diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..33e0e2b --- /dev/null +++ b/Makefile @@ -0,0 +1,8 @@ +MAN_PAGE := doc/swextreload.1 + + +.PHONY: doc +doc: $(MAN_PAGE) + +$(MAN_PAGE): doc/swextreload.1.txt + a2x --no-xmllint --format manpage $< diff --git a/doc/swextreload.1 b/doc/swextreload.1 new file mode 100644 index 0000000..4291460 --- /dev/null +++ b/doc/swextreload.1 @@ -0,0 +1,91 @@ +'\" t +.\" Title: swextreload +.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 11/14/2023 +.\" Manual: \ \& +.\" Source: \ \& +.\" Language: English +.\" +.TH "SWEXTRELOAD" "1" "11/14/2023" "\ \&" "\ \&" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +swextreload \- Reload Chrome extensions +.SH "SYNOPSIS" +.sp +\fIswextreload\fR [options] EXTENSION_ID\&... +.SH "DESCRIPTION" +.sp +Reload Chrome extensions\&. All extension IDs given in positional arguments will be reloaded\&. +.sp +The \fI\-\-socket\-url\fR flag must be provided in order to connect to Chrome over the DevTools Protocol\&. It will resemble this: +.sp +.if n \{\ +.RS 4 +.\} +.nf +ws://127\&.0\&.0\&.1:55755/devtools/browser/208ae571\-d691\-4c98\-ad41\-3a15d507b656 +.fi +.if n \{\ +.RE +.\} +.sp +Chrome must be started with the \fI\-\-remote\-debugging\-port\fR flag to enable the DevTools Protocol, as well as the \fI\-\-silent\-debugger\-extension\-api\fR flag to allow debug access to extensions\&. For example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +/Applications/Google\e Chrome\&.app/Contents/MacOS/Google\e Chrome \e + \-\-silent\-debugger\-extension\-api \e + \-\-remote\-debugging\-port=0 & +.fi +.if n \{\ +.RE +.\} +.sp +The WebSocket URL will be printed to the console\&. +.SH "OPTIONS" +.PP +\-\-socket\-url=SOCKET_URL +.RS 4 +The DevTools Protocol socket URL to connect to Chrome\&. This flag is required\&. +.RE +.PP +\-\-reload\-current\-tab +.RS 4 +Reload the current Chrome tab\&. +.RE +.PP +\-\-debug +.RS 4 +Print WebSocket debug messages to standard output\&. +.RE +.PP +\-h, \-\-help +.RS 4 +Print usage help\&. +.RE +.PP +\-V, \-\-version +.RS 4 +Print the program version\&. +.RE diff --git a/doc/swextreload.1.txt b/doc/swextreload.1.txt new file mode 100644 index 0000000..31629b7 --- /dev/null +++ b/doc/swextreload.1.txt @@ -0,0 +1,47 @@ +swextreload(1) +============== + +NAME +---- +swextreload - Reload Chrome extensions + +SYNOPSIS +-------- +'swextreload' [options] EXTENSION_ID... + +DESCRIPTION +----------- +Reload Chrome extensions. All extension IDs given in positional arguments will +be reloaded. + +The '--socket-url' flag must be provided in order to connect to Chrome over the +DevTools Protocol. It will resemble this: + + ws://127.0.0.1:55755/devtools/browser/208ae571-d691-4c98-ad41-3a15d507b656 + +Chrome must be started with the '--remote-debugging-port' flag to enable the +DevTools Protocol, as well as the '--silent-debugger-extension-api' flag to +allow debug access to extensions. For example: + + /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \ + --silent-debugger-extension-api \ + --remote-debugging-port=0 & + +The WebSocket URL will be printed to the console. + +OPTIONS +------- +--socket-url=SOCKET_URL:: + The DevTools Protocol socket URL to connect to Chrome. This flag is required. + +--reload-current-tab:: + Reload the current Chrome tab. + +--debug:: + Print WebSocket debug messages to standard output. + +-h, --help:: + Print usage help. + +-V, --version:: + Print the program version. |