[bug #58098] [PATCH] build system man page failure

[Ingo Schwarze]

Update of bug #58098 (project groff):

                Category:                    Core => Macro - mm             
                Severity:              3 - Normal => 1 - Wish               
              Item Group:      Build/Installation => Documentation          
                  Status:                    None => Invalid                
             Open/Closed:                    Open => Closed                 

    _______________________________________________________

Follow-up Comment #1:

It is true that many implementations of man(1) require specific naming
conventions for manual page files, but these naming conventions vary among
man(1) implemenations and among operating systems and for some man(1)
implementations, some of these conventions can also be configured on the
individual machine.  So an upstream build system cannot fully solve the
question where to install manual pages; if whatever the upstream build system
does won't work well on some operating system, it is the job of the downstream
packaging system to adjust where such files are installed on that system.

That said, on *some* systems (not necessarily on all, some will for example
also include character encodings in the path, or vendor or package
directories, or ...), the path "$(mandir)/sv/man7/groff_mm.7" means "a swedish
translation of the manual page "$(mandir)/man7/groff_mm.7".

But that is not what groff_mmse.7 is.  It is not at all a translation of the
manual page groff_mm.7.  It does not even document the macro set "mm"
(implemented in contrib/mm/m.tmac).  Instead, it documents the *different*
macro set "mmse" (implemented in contrib/mm/mse.tmac).

There is no English documentation for the the "mmse" macro set.  So it is
correct that the Swedish documentation gets shown to any user who says "man
groff_mmse", no matter the locale.  Also, there is no Swedish translation of
the documentation of the "mm" macro set.  So it is correct that the English
documentation of "mm" gets shown to readers even if they have selected a
Swedish locale.

So this ticket is invalid and the patch is wrong.  Consequently, i reject the
patch and close the ticket.

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?58098>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/