[Bug 228539] [PATCH] for /usr/bin/man when using multibyte characters (utf-8).

[bugzilla-noreply at freebsd.org]

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 at FreeBSD.org
          Reporter: satoumc at 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.