Package: curl Version: 7.64.0-2 Severity: normal Tags: patch Dear Maintainer,
* What led up to the situation? Warnings from "nroff -ww ...", used in "man curl 2> ..." with MANOPT=--warnings=w MAN_KEEP_STDERR=yes troff: <standard input>:531: warning: macro 'foobar'' not defined troff: <standard input>:1147: warning: macro '~/.ssh/id_rsa',' not defined troff: <standard input>:1618: warning: macro 'all',' not defined The patch: >From 655add8444a7e4ddf5bca8b66f5ab7a55252e8ea Mon Sep 17 00:00:00 2001 From: Bjarni Ingi Gislason <bjarn...@rhi.hi.is> Date: Tue, 2 Apr 2019 21:55:11 +0000 Subject: [PATCH] curl.1: Missing lines caused by undefined macros Some lines begin with a "'" (apostrophe, single quote), which is then interpreted as a control character in *roff. Such lines are interpreted as being a call to a macro, and if undefined, the lines are removed from the output. Signed-off-by: Bjarni Ingi Gislason <bjarn...@rhi.hi.is> --- docs/cmdline-opts/data.d | 2 +- docs/cmdline-opts/key.d | 2 +- docs/cmdline-opts/proto.d | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cmdline-opts/data.d b/docs/cmdline-opts/data.d index 7d499665e..d18312aaa 100644 --- a/docs/cmdline-opts/data.d +++ b/docs/cmdline-opts/data.d @@ -24,7 +24,7 @@ chunk that looks like \&'name=daniel&skill=lousy'. If you start the data with the letter @, the rest should be a file name to read the data from, or - if you want curl to read the data from stdin. Multiple files can also be specified. Posting data from a file named -'foobar' would thus be done with --data @foobar. When --data is told to read +\&'foobar' would thus be done with --data @foobar. When --data is told to read from a file like that, carriage returns and newlines will be stripped out. If you don't want the @ character to have a special interpretation use --data-raw instead. diff --git a/docs/cmdline-opts/key.d b/docs/cmdline-opts/key.d index 4877b4238..855e2f7b6 100644 --- a/docs/cmdline-opts/key.d +++ b/docs/cmdline-opts/key.d @@ -5,7 +5,7 @@ Help: Private key file name --- Private key file name. Allows you to provide your private key in this separate file. For SSH, if not specified, curl tries the following candidates in order: -'~/.ssh/id_rsa', '~/.ssh/id_dsa', './id_rsa', './id_dsa'. +\&'~/.ssh/id_rsa', '~/.ssh/id_dsa', './id_rsa', './id_dsa'. If curl is built against OpenSSL library, and the engine pkcs11 is available, then a PKCS#11 URI (RFC 7512) can be used to specify a private key located in a diff --git a/docs/cmdline-opts/proto.d b/docs/cmdline-opts/proto.d index 1513fdc05..e1ece1788 100644 --- a/docs/cmdline-opts/proto.d +++ b/docs/cmdline-opts/proto.d @@ -6,7 +6,7 @@ Added: 7.20.2 --- Tells curl to limit what protocols it may use in the transfer. Protocols are evaluated left to right, are comma separated, and are each a protocol name or -'all', optionally prefixed by zero or more modifiers. Available modifiers are: +\&'all', optionally prefixed by zero or more modifiers. Available modifiers are: .RS .TP 3 .B + -- 2.20.1 -- System Information: Debian Release: buster/sid APT prefers testing APT policy: (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 4.19.28-2 (SMP w/2 CPU cores) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/dash Init: sysvinit (via /sbin/init) Versions of packages curl depends on: ii libc6 2.28-8 ii libcurl4 7.64.0-2 ii zlib1g 1:1.2.11.dfsg-1 curl recommends no packages. curl suggests no packages. -- no debconf information -- Bjarni I. Gislason