Skip to content

Commit

Permalink
net-dns/dog: fix man page and add depend on dev-libs/openssl
Browse files Browse the repository at this point in the history
  • Loading branch information
dguglielmi committed Oct 26, 2024
1 parent 8f6d294 commit 643d887
Show file tree
Hide file tree
Showing 2 changed files with 146 additions and 1 deletion.
5 changes: 4 additions & 1 deletion net-dns/dog/dog-0.2.0_pre20211007.ebuild
Original file line number Diff line number Diff line change
Expand Up @@ -141,14 +141,17 @@ SLOT="0"
KEYWORDS="~amd64"

BDEPEND="app-text/ronn-ng"
DEPEND="dev-libs/openssl"

PATCHES=(
"${FILESDIR}"/${P}-update-crates.patch
"${FILESDIR}"/${P}-manpage-fix.patch
)

src_prepare() {
ronn -r man/dog.1.md || die
default

ronn -r man/dog.1.md || die
}

src_install() {
Expand Down
142 changes: 142 additions & 0 deletions net-dns/dog/files/dog-0.2.0_pre20211007-manpage-fix.patch
Original file line number Diff line number Diff line change
@@ -0,0 +1,142 @@
diff '--color=auto' -dNur a/man/dog.1.md b/man/dog.1.md
--- a/man/dog.1.md 2021-10-07 23:48:48.000000000 +0200
+++ b/man/dog.1.md 2024-10-26 15:13:28.969309039 +0200
@@ -1,27 +1,16 @@
-% dog(1) v0.1.0
-
-<!-- This is the dog(1) man page, written in Markdown. -->
-<!-- To generate the roff version, run `just man`, -->
-<!-- and the man page will appear in the ‘target’ directory. -->
-
-
-NAME
-====
+# dog(1) - a command-line DNS client

-dog — a command-line DNS client

+## SYNOPSIS

-SYNOPSIS
-========
+**dog** [<OPTIONS>]... [<DOMAINS>]...

-`dog [options] [domains...]`
+## DESCRIPTION

**dog** is a command-line DNS client.
It has colourful output, supports the DNS-over-TLS and DNS-over-HTTPS protocols, and can emit JSON.

-
-EXAMPLES
-========
+## EXAMPLES

`dog example.net`
: Query the `A` record of a domain using default settings
@@ -38,9 +27,7 @@
`dog -q example.net -t MX -n 1.1.1.1 -T`
: As above, but using explicit arguments

-
-QUERY OPTIONS
-=============
+## QUERY OPTIONS

`-q`, `--query=HOST`
: Host name or domain name to query.
@@ -62,9 +49,7 @@

DNS traditionally uses port 53 for both TCP and UDP. To use a resolver with a different port, include the port number after a colon (`:`) in the nameserver address.

-
-SENDING OPTIONS
-===============
+## SENDING OPTIONS

`--edns=SETTING`
: Whether to opt in to DNS. This can be ‘`disable`’, ‘`hide`’, or ‘`show`’.
@@ -76,8 +61,7 @@
: Set uncommon protocol-level tweaks.


-TRANSPORT OPTIONS
-=================
+## TRANSPORT OPTIONS

`-U`, `--udp`
: Use the DNS protocol over UDP.
@@ -100,8 +84,7 @@
Unlike the others, the HTTPS transport type requires an entire URL, complete with protocol, domain name, and path.


-OUTPUT OPTIONS
-==============
+## OUTPUT OPTIONS

`-1`, `--short`
: Short mode: display nothing but the first result.
@@ -119,8 +102,7 @@
: Print how long the response took to arrive.


-META OPTIONS
-============
+## META OPTIONS

`--help`
: Displays an overview of the command-line options.
@@ -129,18 +111,15 @@
: Displays the version of dog being invoked.


-ENVIRONMENT VARIABLES
-=====================
+## ENVIRONMENT VARIABLES

dog responds to the following environment variables:

-## `DOG_DEBUG`
-
-Set this to any non-empty value to have dog emit debugging information to standard error. For more in-depth output, set this to the exact string ‘`trace`’.
+`DOG_DEBUG`
+: Set this to any non-empty value to have dog emit debugging information to standard error. For more in-depth output, set this to the exact string ‘`trace`’.


-RECORD TYPES
-============
+## RECORD TYPES

dog understands and can interpret the following record types:

@@ -199,8 +178,7 @@
dog also contains a list of record type names that it knows the type number of, but is not able to interpret, such as `IXFR` or `ANY` or `AFSDB`. These are acceptable as command-line arguments, meaning you can send an AFSDB request with ‘`dog AFSDB`’. However, their response contents will still be displayed as numbers. They may be supported in future versions of dog.


-PROTOCOL TWEAKS
-===============
+## PROTOCOL TWEAKS

The `-Z` command-line argument can be used one or more times to set some protocol-level options in the DNS queries that get sent. It accepts the following values:

@@ -217,8 +195,7 @@
: Sets the `CD` (Checking Disabled) bit in the query.


-EXIT STATUSES
-=============
+## EXIT STATUSES

0
: If everything goes OK.
@@ -235,9 +212,7 @@
4
: If there was a problem obtaining the system nameserver information.

-
-AUTHOR
-======
+## AUTHOR

dog is maintained by Benjamin ‘ogham’ Sago.

0 comments on commit 643d887

Please sign in to comment.