[pkg-lynx-maint] Bug#1037353: lynx.1: a few formatting fixes for the manual

[Thomas Dickey]

On Mon, Jun 12, 2023 at 01:56:56AM +0000, Bjarni Ingi Gislason wrote:
> Package: lynx
> Version: 2.9.0dev.12-1
> Severity: minor
> Tags: patch
> 
> Dear Maintainer,
> 
> here are some fixes.
> 
> Input file is lynx.1
> 
> Output from "mandoc -T lint lynx.1"
> mandoc: lynx.1:27:2: WARNING: missing date, using "": TH
> mandoc: lynx.1:109:2: WARNING: unknown font, skipping request: ft C			
> mandoc: lynx.1:317:2: WARNING: unknown font, skipping request: ft C			
> mandoc: lynx.1:366:2: WARNING: unknown font, skipping request: ft C			
> mandoc: lynx.1:831:2: WARNING: unknown font, skipping request: ft C			
> mandoc: lynx.1:838:2: WARNING: unknown font, skipping request: ft C			
> mandoc: lynx.1:1131:2: WARNING: unknown font, skipping request: ft C			

That seems to be harmless for nroff, but mainly is for troff (and groff)
to select a fixed-pitch font for PDFs and PostScript.  I'll see if this
is at least no worse than the plain "C".

Solaris 10 appears to have "CO" for "Courier" (troff), while
an AIX that I can access uses "CR".  But on those systems,
I'm not actually using troff :-)

I've been using "C" quite a while, and hadn't noticed a problem with
the indicated usage (i.e., generating PDFs, etc).

> #######
> 
> Increase size of ~ (tilde) to make it more visible
> with "troff" by using character \(ti.

That appears to be groff-specific.
 
> 264:If none is specified, the default value is ~/.lynx_cookies
> 265:for most systems, but ~/cookies for MS-DOS.
> 
> #####
> 
>   The following issue is not in the patch:
> 
> an.tmac:lynx.1:27: style: .TH missing third argument; suggest document modification date in ISO 8601 format (YYYY-MM-DD)
> an.tmac:lynx.1:27: style: .TH missing fourth argument; suggest package/project name and version (e.g., "lynx ...")

maybe - there are pros/cons (the version number is in the manpage,
and that indirectly gives an accurate date).  If I did put a date,
it would be the modification date for _that_ file.
 
> #####
> 
> --- lynx.1	2023-06-05 16:20:24.000000000 +0000
> +++ lynx.1.new	2023-06-12 01:32:27.000000000 +0000
> @@ -15,7 +15,7 @@
>  .ie n  .in +4
>  .el    .in +2
>  .nf
> -.ft C			\" Courier
> +.ft CR			\" Courier
>  ..
>  .de NE
>  .fi
> @@ -261,8 +261,8 @@ Sets the connection timeout, where N is
>  .TP
>  .B \-cookie_file\fR=\fIFILENAME
>  specifies a file to use to read cookies.
> -If none is specified, the default value is ~/.lynx_cookies
> -for most systems, but ~/cookies for MS-DOS.
> +If none is specified, the default value is \(ti/.lynx_cookies
> +for most systems, but \(ti/cookies for MS-DOS.
>  .TP
>  .B \-cookie_save_file\fR=\fIFILENAME
>  specifies a file to use to store cookies.
> 
> 
> -- System Information:
> Debian Release: 12.0
>   APT prefers testing
>   APT policy: (500, 'testing')
> Architecture: amd64 (x86_64)
> 
> Kernel: Linux 6.1.27-1 (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  libbsd0       0.11.7-2
> ii  libbz2-1.0    1.0.8-5+b1
> ii  libc6         2.36-9
> ii  libgnutls30   3.7.9-2
> ii  libidn2-0     2.3.3-1+b1
> ii  libncursesw6  6.4-4
> ii  libtinfo6     6.4-4
> ii  lynx-common   2.9.0dev.12-1
> ii  zlib1g        1:1.2.13.dfsg-1
> 
> Versions of packages lynx recommends:
> ii  mailcap  3.70+nmu1
> 
> lynx suggests no packages.
> 
> -- no debconf information
> 

-- 
Thomas E. Dickey <dickey at invisible-island.net>
https://invisible-island.net
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 659 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-lynx-maint/attachments/20230614/11767f13/attachment.sig>