Date: Sun, 27 May 2018 10:42:38 +0000 From: bugzilla-noreply@freebsd.org To: bugs@FreeBSD.org Subject: [Bug 228539] [PATCH] for /usr/bin/man when using multibyte characters (utf-8). Message-ID: <bug-228539-227@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=228539 Bug ID: 228539 Summary: [PATCH] for /usr/bin/man when using multibyte characters (utf-8). Product: Base System Version: 11.1-RELEASE Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: bin Assignee: bugs@FreeBSD.org Reporter: satoumc@as.airnet.ne.jp Created attachment 193757 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=193757&action=edit patch itself. The /usr/bin/man command has the following problems, when using the manual source files of UTF-8 encoding, source written in the multi-byte characters language. A: When using the 'mandoc' command in man command A1: Folding of the character strings are quite low quality, and the text formats are often corrupted. B: When using the 'groff' command in man command (it is used when a problem occurs in mandoc) B1: Command can not recognize that the source is UTF-8 and users can not read because the outputs are garbled. B2: Folding of the character string is quite low quality, and the text formats are often corrupted. B3: The new mdoc(7) format is not supported. I made a patch to solve these problems. It is very short. - User can select whether to use 'mandoc' or 'groff', with the environment variable MANPROC. - Use the new groff with appropriate options (-D$nroff_dev, -mandoc). - User can give necessary options to groff with the environment variable MANROFFOPT. User can avoid the problems as follows: A1: User can solve it by setting MANPROC="groff" and letting groff handle the process. After the 'mandoc' command is improved in the future, user can undo it. B1: By setting -D$nroff_dev with new groff, it will be solved automatically. B2: In the Japanese-speaking area, problems can be solved if the user sets MANROFFOPT="-mja". Perhaps users want to use "-mfr" in French-speaking countries and "-mde" in German-speaking countries. B3: Because we set -mandoc instead of -man with newer groff, It automatically identifies man(7) and mdoc(7) and performs appropriate formatting. There is no change for this modification to English-speaking users who currently have no problem, No new problems will occur for them. -- You are receiving this mail because: You are the assignee for the bug.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-228539-227>