Package: lynx
Version: 2.9.3-2
Severity: minor
Tags: patch
Additional remarks.
Mails from me to "[email protected]" are no longer acknowledged. A
Debian maintainer told me, that he would contact the mail administrator
about me not wanting to send bugs upstream.
-.-
Dear Maintainer,
>From "/usr/share/doc/debian/bug-reporting.txt.gz":
Don't file bugs upstream
If you file a bug in Debian, don't send a copy to the upstream software
maintainers yourself, as it is possible that the bug exists only in
Debian. If necessary, the maintainer of the package will forward the
bug upstream.
-.-
For forwarding bug reports to upstream see:
https://www.debian.org/Bugs/Developer#forward
-.-
"Handling bug reports" in
http://people.debian.org/~enrico/dcg/ch03s02.html
-.-
I do not send reports upstream if I have to get an account there.
The Debian maintainers have one already.
If I get a negative (or no) response from upstream, I send henceforth
bugs to Debian.
-.-
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z < "man page"
[Use
grep -n -e ' $' -e '\\~$' -e ' \\f.$' -e ' \\"' <file>
to find (most) trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
-mandoc -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: forky/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 7.0.10+deb14-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages lynx depends on:
ii libbrotli1 1.2.0-3
ii libbsd0 0.12.2-3
ii libbz2-1.0 1.0.8-6+b2
ii libc6 2.42-16
ii libgnutls30t64 3.8.13-1
ii libidn2-0 2.3.8-5
ii libncursesw6 6.6+20251231-1+b1
ii libtinfo6 6.6+20251231-1+b1
ii lynx-common 2.9.3-2
ii zlib1g 1:1.3.dfsg+really1.3.2-3
Versions of packages lynx recommends:
ii mailcap 3.76
lynx suggests no packages.
-- no debconf information
Input file is lynx.1
Output from "mandoc -T lint lynx.1": (shortened list)
1 STYLE: whitespace at end of input line
Find trailing whitespace with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Output from
test-groff mandoc -Kutf8 -ww -z lynx.1: (shortened list)
1 trailing whitespace [-w trail]
Find trailing whitespace with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
See more information in the attachment "trailing whitespace".
Number of lines affected is
1
-.-.
Add a backslash, if it is missing after \{ at the end of a line.
20:.el \{
-.-.
Split a punctuation from a single argument, if a two-font macro is meant.
730:.B \-restrictions\fR=\fI[option][,option][,option]...
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
[List of affected lines removed.]
-.-.
Use "\-" instead of "-" (rendered as a hyphen (u2010) in UTF-8 encoding)
in web addresses.
362:lynx \fB\-dump\fR https://lynx.invisible-island.net/
-.-.
Additionally:
'=' in options is a constant, therefore typeset in bold.
'[' and ']' in option lines are neutral (indicate additional data), so
typeset in roman.
-.-
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
-.-
Tables:
Use the preprocessor 'tbl' to make tables.
Put data, that are wider than the header in the (centered) last column,
in a "T{...\nT}" block(, when the table gets wider than the output line).
Table headings, that are wider than any data in the corresponding
column, do not need to be centered, so left adjustment (l, L) is
sufficient.
--- lynx.1 2026-06-11 21:38:53.231842692 +0000
+++ lynx.1.new 2026-06-11 22:41:11.729593918 +0000
@@ -17,7 +17,7 @@
.\}
.
.ie n .ds CW R
-.el \{
+.el \{\
.ie \n(.g .ds CW CR
.el .ds CW CW
.\}
@@ -28,7 +28,7 @@
..
.de NS
.ie n .sp
-.el .sp .5
+.el .sp 0.5
.ie n .in +4
.el .in +2
.nf
@@ -45,15 +45,18 @@
lynx \-
a general purpose distributed information browser for the World Wide Web
.SH SYNOPSIS
-.B lynx \fI[options] [optional paths or URLs]
+.B lynx \c
+.RI [ options "] [" "optional paths or URLs" ]
.sp
-.B lynx \fI[options] [path or URL]\fP \fB\-get_data
+.B lynx \c
+.RI [ options "] [" "path or URL" "] "\fB\-get_data\fR
.br
.I data
.br
.B \-\-
.sp
-.B lynx \fI[options] [path or URL]\fP \fB\-post_data
+.B lynx \c
+.RI [ options "] [" "path or URL" "] " \fB\-post_data\fR
.br
.I data
.br
@@ -163,18 +166,18 @@ The default is \*(``off\*(''.
.B \-anonymous
apply restrictions for anonymous account, see also \fB\-restrictions\fR.
.TP
-.B \-assume_charset\fR=\fIMIMEname
+.B \-assume_charset=\fIMIMEname
charset for documents that do not specify it.
.TP
-.B \-assume_local_charset\fR=\fIMIMEname
+.B \-assume_local_charset=\fIMIMEname
charset assumed for local files,
i.e., files which \fILynx\fP creates such as
internal pages for the options menu.
.TP
-.B \-assume_unrec_charset\fR=\fIMIMEname
+.B \-assume_unrec_charset=\fIMIMEname
use this instead of unrecognized charsets.
.TP
-.B \-auth\fR=\fIID\fR:\fIPASSWD
+.B \-auth=\fIID\fR:\fIPASSWD
set authorization ID and password for protected documents at startup.
Be sure to protect any script files which use
this switch.
@@ -183,7 +186,7 @@ this switch.
prepend a request URL comment and BASE tag to text/html
outputs for \fB\-source\fR dumps.
.TP
-.B \-bibhost\fR=\fIURL
+.B \-bibhost=\fIURL
specify a local bibp server (default http://bibhost/).
.TP
.B \-blink
@@ -207,7 +210,7 @@ addresses enclosed in angle brackets wil
false news links, and uuencoded messages can be trashed.
The default is \*(``on\*(''.
.TP
-.B \-cache\fR=\fINUMBER
+.B \-cache=\fINUMBER
set the NUMBER of documents cached in memory.
The default is 10.
.TP
@@ -221,7 +224,7 @@ Normally table cells are centered on the
Set this option \*(``on\*('' to disable centering.
The default is \*(``off\*(''.
.TP
-.B \-cfg\fR=\fIFILENAME
+.B \-cfg=\fIFILENAME
specifies a \fILynx\fP configuration file other than the default
lynx.cfg.
.TP
@@ -235,10 +238,10 @@ exit on left-arrow in startfile, but all
print/mail options.
The default is \*(``off\*(''.
.TP
-.B \-cmd_log\fR=\fIFILENAME
+.B \-cmd_log=\fIFILENAME
write keystroke commands and related information to the specified file.
.TP
-.B \-cmd_script\fR=\fIFILENAME
+.B \-cmd_script=\fIFILENAME
read keystroke commands from the specified file.
You can use the data written using the \fB\-cmd_log\fR option.
\fILynx\fP will ignore other information which the command-logging may have
@@ -285,22 +288,22 @@ startup has the same effect.
A saved show_color=never found
in \&.lynxrc on startup is overridden by this flag.
.TP
-.B \-connect_timeout\fR=\fIN
+.B \-connect_timeout=\fIN
Sets the connection timeout, where \fIN\fP is given in seconds.
The default is 300.
.TP
-.B \-convert_to\fR=\fIPARAM
+.B \-convert_to=\fIPARAM
convert input, setting output format in MIME type notation
(e.g., \fIwww/present\fP, \fIwww/source\fP),
and optionally setting the current character set
(i.e., adding \*(``;\*('' followed by \fBcharset=\fIVALUE\fP).
.TP
-.B \-cookie_file\fR=\fIFILENAME
+.B \-cookie_file=\fIFILENAME
specifies a file to use to read cookies.
If none is specified, the default value is \s+3~\s-3/.lynx_cookies
for most systems, but \s+3~\s-3/cookies for MS-DOS.
.TP
-.B \-cookie_save_file\fR=\fIFILENAME
+.B \-cookie_save_file=\fIFILENAME
specifies a file to use to store cookies.
If none is specified, the value given by
\fB\-cookie_file\fR is used.
@@ -342,10 +345,10 @@ The default is \*(``on\*(''.
add \fIDebugSecs\fP delay after each progress-message.
The default is 0.
.TP
-.B \-display\fR=\fIDISPLAY
+.B \-display=\fIDISPLAY
set the $DISPLAY variable for X exec-ed programs.
.TP
-.B \-display_charset\fR=\fIMIMEname
+.B \-display_charset=\fIMIMEname
set the charset for the terminal output.
.TP
.B \-dont_wrap_pre
@@ -359,7 +362,7 @@ specified on the command line to standar
Unlike interactive mode, all documents are processed.
This can be used in the following way:
.NS
-lynx \fB\-dump\fR https://lynx.invisible-island.net/
+lynx \fB\-dump\fR https://lynx.invisible\-island.net/
.NE
.IP
Files specified on the command line are formatted as HTML if
@@ -368,7 +371,7 @@ as \*(``.htm\*('' or \*(``.html\*(''.
Use the \fB\-force_html\fP option to format files whose names do not follow
this convention.
.TP
-.B \-editor\fR=\fIEDITOR
+.B \-editor=\fIEDITOR
enable external editing, using the specified
EDITOR.
(vi, ed, emacs, etc.)
@@ -382,7 +385,7 @@ toggles compatibility with communication
(may be incompatible with some curses packages).
The default is \*(``off\*(''.
.TP
-.B \-error_file\fR=\fIFILE
+.B \-error_file=\fIFILE
define a file where \fILynx\fP will report HTTP access codes.
.TP
.B \-exec
@@ -483,7 +486,7 @@ hidden links do not appear even in listi
toggles use of \*(``>\*('' or \*(``\-\->\*('' as a terminator for comments.
The default is \*(``off\*(''.
.TP
-.B \-homepage\fR=\fIURL
+.B \-homepage=\fIURL
set homepage separate from start page.
.TP
.B \-html5_charset
@@ -495,7 +498,7 @@ The default is \*(``off\*(''.
toggles inclusion of links for all images.
The default is \*(``off\*(''.
.TP
-.B \-index\fR=\fIURL
+.B \-index=\fIURL
set the default index file to the specified URL.
.TP
.B \-ismap
@@ -507,7 +510,7 @@ The default is \*(``off\*(''.
do justification of text.
The default is \*(``off\*(''.
.TP
-.B \-link\fR=\fINUMBER
+.B \-link=\fINUMBER
starting count for lnk#.dat files produced by \fB\-crawl\fR.
The default is 0.
.TP
@@ -537,7 +540,7 @@ enable local program execution from loca
\fILynx\fP was compiled with local execution enabled).
The default is \*(``off\*(''.
.TP
-.B \-lss\fR=\fIFILENAME
+.B \-lss=\fIFILENAME
specify filename containing color-style information.
The default is lynx.lss.
If you give an empty filename, \fILynx\fP uses a built-in monochrome
@@ -554,10 +557,10 @@ The default is \*(``on\*(''.
toggles nested-tables logic (for debugging).
The default is \*(``on\*(''.
.TP
-.B \-newschunksize\fR=\fINUMBER
+.B \-newschunksize=\fINUMBER
number of articles in chunked news listings.
.TP
-.B \-newsmaxchunk\fR=\fINUMBER
+.B \-newsmaxchunk=\fINUMBER
maximum news articles in listings before chunking.
.TP
.B \-nobold
@@ -645,9 +648,9 @@ The default is \*(``off\*(''.
.B \-nounderline
disable underline video-attribute.
.TP
-.B \-nozap\fR=\fIDURATION
+.B \-nozap=\fIDURATION
disables checks for \*(``z\*('' key initially
-if \fIDURATION\fP is \*(``initially\*(''
+if \fIDURATION\fP is \*(``initially\*(''
or completely otherwise.
.TP
.B \-number_fields
@@ -662,7 +665,7 @@ The default is \*(``off\*(''.
toggles display partial pages while loading.
The default is \*(``on\*(''.
.TP
-.B \-partial_thres\fR=\fINUMBER
+.B \-partial_thres=\fINUMBER
number of lines to render before repainting display
with partial-display logic
.TP
@@ -670,7 +673,7 @@ with partial-display logic
toggles passive ftp connections.
The default is \*(``on\*(''.
.TP
-.B \-pauth\fR=\fIID\fR:\fIPASSWD
+.B \-pauth=\fIID\fR:\fIPASSWD
set authorization ID and password for a protected proxy server at startup.
Be sure to protect any script files which use this switch.
.TP
@@ -718,7 +721,7 @@ The default is \*(``off\*(''.
restricts access to URLs in the starting realm.
The default is \*(``off\*(''.
.TP
-.B \-read_timeout\fR=\fIN
+.B \-read_timeout=\fIN
Sets the read-timeout, where \fIN\fP is given in seconds.
The default is 18000.
.TP
@@ -727,7 +730,8 @@ flushes the cache on a proxy server
(only the first document given on the command-line is affected).
The default is \*(``off\*(''.
.TP
-.B \-restrictions\fR=\fI[option][,option][,option]...
+.BR \-restrictions= \c
+.RI [ option ][ ,option ][ ,option ]...\&
allows a list of services to be disabled selectively.
Dashes and underscores in option names can be intermixed.
The following list is printed if no options are specified.
@@ -896,13 +900,13 @@ The default is \*(``on\*(''.
.B \-selective
require \&.www_browsable files to browse directories.
.TP
-.B \-session\fR=\fIFILENAME
+.B \-session=\fIFILENAME
resumes from specified file on startup and saves session to that file on exit.
.TP
-.B \-sessionin\fR=\fIFILENAME
+.B \-sessionin=\fIFILENAME
resumes session from specified file.
.TP
-.B \-sessionout\fR=\fIFILENAME
+.B \-sessionout=\fIFILENAME
saves session to specified file.
.TP
.B \-short_url
@@ -993,7 +997,7 @@ read the startfile from standard input
(UNIX only).
The default is \*(``off\*(''.
.TP
-.B \-syslog\fR=\fItext
+.B \-syslog=\fItext
information for syslog call.
.TP
.B \-syslog_urls
@@ -1008,13 +1012,13 @@ The default is \*(``off\*(''.
disable recognition of telnet commands.
The default is \*(``off\*(''.
.TP
-.B \-term\fR=\fITERM
+.B \-term=\fITERM
tell \fILynx\fP what terminal type to assume it is talking to.
(This may be useful for remote execution, when, for example,
\fILynx\fP connects to a remote TCP/IP port that starts a script that,
in turn, starts another \fILynx\fP process.)
.TP
-.B \-timeout\fR=\fIN
+.B \-timeout=\fIN
For win32, sets the network read-timeout, where N is given in seconds.
.TP
.B \-tlog
@@ -1032,7 +1036,7 @@ Destination of trace output depends
on \fB\-tlog\fP.
The default is \*(``off\*(''.
.TP
-.B \-trace_mask\fR=\fIvalue
+.B \-trace_mask=\fIvalue
turn on optional traces, which may result in very large trace files.
Logically OR the values to combine options:
.RS
@@ -1158,7 +1162,7 @@ The default is \*(``off\*(''.
enable Waterloo tcp/ip packet debug (print to watt debugfile).
This applies only to DOS versions compiled with WATTCP or WATT-32.
.TP
-.B \-width\fR=\fINUMBER
+.B \-width=\fINUMBER
number of columns for formatting of dumps, default is 80.
This is limited by the number of columns that \fILynx\fP could display,
typically 1024 (the \fIMAX_LINE\fP symbol).
Check the output from "lintian" in the Debian distribution.
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
To find most trailing spaces use
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
The same goes for man pages that are used as an input.
-.-
For a style guide use
mandoc -T lint
-.-
For general input conventions consult the man page "nroff(7)" (item
"Input conventions") or the Texinfo manual about the same item.
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
-.-
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
"git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")
-.-
Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced when that has been fixed.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original
and patched file can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -b -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
--- Begin Message ---
Trailing whitespace is so unnecessary, that its presence may be removed
before files containing it are distributed.
Some programs have a tool to point out its presence, like
gcc
with option "-Wtrailing-whitespace"
git
with option "apply --whitespace=..."
and in ".git/config"
[core]
whitespace=...
grep
with option -e '[[:blank:]]$'
less
with command "/ $"
mandoc -T lint
default action
--- End Message ---
