Bug 217826

Summary: korean/man-doc - groff errors in eqn.1
Product: Ports & Packages Reporter: Ben Bullock <benkasminbullock>
Component: Individual Port(s)Assignee: freebsd-ports-bugs mailing list <ports-bugs>
Status: New ---    
Severity: Affects Only Me CC: hyun, ndowens, w.schwarzenfeld
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
See Also: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=212125

Description Ben Bullock 2017-03-16 06:16:36 UTC
There appear to be a number of errors in the manual page for eqn as follows:

$ nroff -man ./eqn.1 > /dev/null
./eqn.1:20: a space character is not allowed in an escape name
./eqn.1:20: a space character is not allowed in an escape name
./eqn.1:35: a space character is not allowed in an escape name
./eqn.1:35: warning: numeric expression expected (got `j')
./eqn.1:37: a space character is not allowed in an escape name
./eqn.1:37: warning: numeric expression expected (got `i')
./eqn.1:45: a space character is not allowed in an escape name
./eqn.1:46: a space character is not allowed in an escape name
./eqn.1:47: a space character is not allowed in an escape name
./eqn.1:48: a space character is not allowed in an escape name
./eqn.1:49: a space character is not allowed in an escape name
./eqn.1:50: a space character is not allowed in an escape name
./eqn.1:51: a space character is not allowed in an escape name
./eqn.1:52: a space character is not allowed in an escape name
./eqn.1:186: a space character is not allowed in an escape name
./eqn.1:847: a space character is not allowed in an escape name

Of these, I can confirm that the "j" error reported by groff above is definitely not a valid groff command:

.nr a \n(. j

This expands to .nr a 0j, and j is not a recognised groff unit.
Comment 1 w.schwarzenfeld freebsd_triage 2018-01-17 08:42:54 UTC
Submitter: does this error still appears?
Comment 2 Ben Bullock 2018-01-17 12:51:40 UTC
Has anything changed which would mean it doesn't appear any longer? Please tell me what to download to get the new version without the errors.
Comment 3 Nathan 2018-08-21 22:37:00 UTC
I ran nroff -man eqn.1 > /dev/null
and I get no errors?
Comment 4 Ben Bullock 2018-08-21 22:59:18 UTC
Thank you for your input Nathan.

My version of nroff is as follows:

 $ /usr/bin/nroff --version
GNU nroff (groff) version 1.19.2

The MD5 checksum of eqn.1 is as follows:

 $ md5 eqn.1
MD5 (eqn.1) = b9357013cc6e126c788b9fa281f06fa4

As far as I know there have been no changes in the ko-man port:

https://svnweb.freebsd.org/ports/head/korean/man-doc/

To confirm this, I've just downloaded ko-man using pkg, and I copied the eqn.1.gz from /usr/local/share/man/ko/man1/eqn.1.gz and checked its md5 checksum:

 $ md5 eqn.1
MD5 (eqn.1) = b9357013cc6e126c788b9fa281f06fa4

This appears to be exactly the same file. Running the above nroff on the file gives this output:

 $ /usr/bin/nroff -man eqn.1 > /dev/null
eqn.1:20: a space character is not allowed in an escape name
eqn.1:20: a space character is not allowed in an escape name
eqn.1:35: a space character is not allowed in an escape name
eqn.1:35: warning: numeric expression expected (got `j')
eqn.1:37: a space character is not allowed in an escape name
eqn.1:37: warning: numeric expression expected (got `i')
eqn.1:45: a space character is not allowed in an escape name
eqn.1:46: a space character is not allowed in an escape name
eqn.1:47: a space character is not allowed in an escape name
eqn.1:48: a space character is not allowed in an escape name
eqn.1:49: a space character is not allowed in an escape name
eqn.1:50: a space character is not allowed in an escape name
eqn.1:51: a space character is not allowed in an escape name
eqn.1:52: a space character is not allowed in an escape name
eqn.1:186: a space character is not allowed in an escape name
grotty:<standard input>:10935: character above first line discarded
eqn.1:847: a space character is not allowed in an escape name

I also seem to have another nroff in /usr/local/bin/nroff. I tried with that:

$ /usr/local/bin/nroff --version
GNU nroff (groff) version 1.18.1
$ /usr/local/bin/nroff -man eqn.1 > /dev/null
eqn.1:20: a space character is not allowed in an escape name
eqn.1:20: a space character is not allowed in an escape name
eqn.1:35: a space character is not allowed in an escape name
eqn.1:35: warning: numeric expression expected (got `j')
eqn.1:37: a space character is not allowed in an escape name
eqn.1:37: warning: numeric expression expected (got `i')
eqn.1:45: a space character is not allowed in an escape name
eqn.1:46: a space character is not allowed in an escape name
eqn.1:47: a space character is not allowed in an escape name
eqn.1:48: a space character is not allowed in an escape name
eqn.1:49: a space character is not allowed in an escape name
eqn.1:50: a space character is not allowed in an escape name
eqn.1:51: a space character is not allowed in an escape name
eqn.1:52: a space character is not allowed in an escape name
eqn.1:163: name expected (got a magic token): treated as missing
eqn.1:186: a space character is not allowed in an escape name
eqn.1:847: a space character is not allowed in an escape name

The results seem nearly the same.

Can you confirm the version of nroff you are using and the md5 checksum of the file eqn.1 are the same as mine?
Comment 5 commit-hook freebsd_committer 2018-10-20 13:07:04 UTC
A commit references this bug:

Author: tobik
Date: Sat Oct 20 13:06:26 UTC 2018
New revision: 482496
URL: https://svnweb.freebsd.org/changeset/ports/482496

Log:
  Deprecate korean/man-doc

  It is unmaintained, was last updated in 2002, some files have
  encoding errors [1], some appear to be machine translated [1], and
  it documents commands that have changed significantly since then
  with flags that no longer exist, new flags that are not documented,
  etc.

  PR:		212125 [1], 217826, 218176

Changes:
  head/korean/man-doc/Makefile