update manpage for --tagn

Signed-off-by: William Casarin <jb55@jb55.com>
This commit is contained in:
William Casarin 2024-09-22 10:11:28 +09:00
parent 74ba45adbc
commit 30df00e6fa
3 changed files with 43 additions and 35 deletions

View File

@ -42,6 +42,9 @@ nostril - generate nostr events
*--tag* <key> <value> *--tag* <key> <value>
Add a tag with a single value Add a tag with a single value
*--tagn* <N> <value \* N ...>
Add a tag with 0 or more elements
*-t* *-t*
Shorthand for --tag t <hashtag> Shorthand for --tag t <hashtag>

View File

@ -1,4 +1,4 @@
.\" Generated by scdoc 1.11.2 .\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page .\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq .ie \n(.g .ds Aq \(aq
.el .ds Aq ' .el .ds Aq '
@ -6,87 +6,92 @@
.ad l .ad l
.\" Begin generated content: .\" Begin generated content:
.TH "nostril" "1" "1980-01-01" .TH "nostril" "1" "1980-01-01"
.P .PP
.SH NAME .SH NAME
.P .PP
nostril - generate nostr events nostril - generate nostr events
.P .PP
.SH SYNPOSIS .SH SYNPOSIS
.P .PP
\fBnostril\fR [OPTIONS.\&.\&.\&] \fBnostril\fR [OPTIONS.\&.\&.\&]
.P .PP
.SH DESCRIPTION .SH DESCRIPTION
.P .PP
\fBnostril\fR is a tool that creates and signs nostr events.\& \fBnostril\fR is a tool that creates and signs nostr events.\&
.P .PP
.SH OPTIONS .SH OPTIONS
.P .PP
\fB--content\fR \fB--content\fR
.RS 4 .RS 4
The text contents of the note The text contents of the note
.P .PP
.RE .RE
\fB--dm\fR <hex pubkey> \fB--dm\fR <hex pubkey>
.RS 4 .RS 4
Create a direct message.\& This will create a kind-4 note with the Create a direct message.\& This will create a kind-4 note with the
contents encrypted> contents encrypted>
.P .PP
.RE .RE
\fB--envelope\fR \fB--envelope\fR
.RS 4 .RS 4
Wrap the event with `["EVENT", .\&.\&.\& ]` for easy relaying Wrap the event with `["EVENT", .\&.\&.\& ]` for easy relaying
.P .PP
.RE .RE
\fB--kind\fR <number> \fB--kind\fR <number>
.RS 4 .RS 4
Set the kind of the note Set the kind of the note
.P .PP
.RE .RE
\fB--created-at\fR <unix timestamp> \fB--created-at\fR <unix timestamp>
.RS 4 .RS 4
Set the created at.\& Optional, this is set automatically.\& Set the created at.\& Optional, this is set automatically.\&
.P .PP
.RE .RE
\fB--sec\fR <hex seckey> \fB--sec\fR <hex seckey>
.RS 4 .RS 4
Set the secret key for signing, otherwise one will be randomly generated.\& Set the secret key for signing, otherwise one will be randomly generated.\&
.P .PP
.RE .RE
\fB--mine-pubkey\fR \fB--mine-pubkey\fR
.RS 4 .RS 4
Mine a pubkey.\& This may or may not be cryptographically dubious.\& Mine a pubkey.\& This may or may not be cryptographically dubious.\&
.P .PP
.RE .RE
\fB--pow\fR <difficulty> \fB--pow\fR <difficulty>
.RS 4 .RS 4
Number of leading 0 bits of the id the mine for proof-of-work.\& Number of leading 0 bits of the id the mine for proof-of-work.\&
.P .PP
.RE .RE
\fB--tag\fR <key> <value> \fB--tag\fR <key> <value>
.RS 4 .RS 4
Add a tag with a single value Add a tag with a single value
.P .PP
.RE
\fB--tagn\fR <N> <value * N .\&.\&.\&>
.RS 4
Add a tag with 0 or more elements
.PP
.RE .RE
\fB-t\fR \fB-t\fR
.RS 4 .RS 4
Shorthand for --tag t <hashtag> Shorthand for --tag t <hashtag>
.P .PP
.RE .RE
\fB-p\fR \fB-p\fR
.RS 4 .RS 4
Shorthand for --tag p <hex pubkey> Shorthand for --tag p <hex pubkey>
.P .PP
.RE .RE
\fB-e\fR \fB-e\fR
.RS 4 .RS 4
Shorthand for --tag e <note id> Shorthand for --tag e <note id>
.P .PP
.P .PP
.RE .RE
.SH Examples .SH Examples
.P .PP
\fBGenerate an event\fR \fBGenerate an event\fR
.P .PP
.nf .nf
.RS 4 .RS 4
$ \&./nostril --sec <key> --content "this is a message" $ \&./nostril --sec <key> --content "this is a message"
@ -101,9 +106,9 @@ $ \&./nostril --sec <key> --content "this is a message"
} }
.fi .fi
.RE .RE
.P .PP
\fBWrap event to send to a relay\fR \fBWrap event to send to a relay\fR
.P .PP
.nf .nf
.RS 4 .RS 4
$ \&./nostril --envelope --sec <key> --content "hello" $ \&./nostril --envelope --sec <key> --content "hello"
@ -119,33 +124,33 @@ $ \&./nostril --envelope --sec <key> --content "hello"
} ] } ]
.fi .fi
.RE .RE
.P .PP
\fBSend to a relay\fR \fBSend to a relay\fR
.P .PP
.nf .nf
.RS 4 .RS 4
nostril --envelope --sec <key> --content "this is a message" | websocat wss://relay\&.damus\&.io nostril --envelope --sec <key> --content "this is a message" | websocat wss://relay\&.damus\&.io
.fi .fi
.RE .RE
.P .PP
\fBSend a nip04 DM\fR \fBSend a nip04 DM\fR
.P .PP
.nf .nf
.RS 4 .RS 4
nostril --envelope --dm <pubkey> --sec <key> --content "this is a secret" | websocat wss://relay\&.damus\&.io nostril --envelope --dm <pubkey> --sec <key> --content "this is a secret" | websocat wss://relay\&.damus\&.io
.fi .fi
.RE .RE
.P .PP
\fBMine a pubkey\fR \fBMine a pubkey\fR
.P .PP
.nf .nf
.RS 4 .RS 4
nostril --mine-pubkey --pow <difficulty> nostril --mine-pubkey --pow <difficulty>
.fi .fi
.RE .RE
.P .PP
\fBReply to an event.\& nip10 compliant, includes the `thread_id`\fR \fBReply to an event.\& nip10 compliant, includes the `thread_id`\fR
.P .PP
.nf .nf
.RS 4 .RS 4
\&./nostril --envelope --sec <key> --content "this is reply message" --tag e <thread_id> --tag e <note_id> | websocat wss://relay\&.damus\&.io \&./nostril --envelope --sec <key> --content "this is reply message" --tag e <thread_id> --tag e <note_id> | websocat wss://relay\&.damus\&.io

View File

@ -1,5 +1,5 @@
{ pkgs ? import <nixpkgs> {} }: { pkgs ? import <nixpkgs> {} }:
with pkgs; with pkgs;
mkShell { mkShell {
buildInputs = [ secp256k1 gdb autoreconfHook ]; buildInputs = [ scdoc ];
} }