bugGNU gettext - Bugs: bug #56111, C# documentation is installed even...

 
 

You are not allowed to post comments on this tracker with your current authentication level.

bug #56111: C# documentation is installed even if csharp support is disabled

Submitted by:  Tomasz Kłoczko <kloczek>
Submitted on:  Tue 09 Apr 2019 04:33:58 PM UTC  
 
Category:  Build Severity:  2 - Minor
Item Group:  None Status:  Wont Fix
Privacy:  Public Assigned to:  Bruno Haible <haible>
Open/Closed:  Closed

Sun 18 Aug 2019 02:10:32 AM UTC, comment #2: 

Should a package have different documentation on different machines, depending on whether the package was built with/without C# support? 25 years ago, before the internet, I would have said yes, because the focus of the user is on their own machine. Nowadays, people often look up the documentation at https://www.gnu.org/software/gettext/manual/ ; therefore the documentation should be independent of configure options.

To make things 100% correct, there are two possibilities:

a) The .exe / .dll files (for C#) or .jar files (for Java) are included in the distribution. The documentation could say "msgfmt and msgunfmt support C# if mono/mcs available at run time".

b) The .exe / .dll files (for C#) or .jar files (for Java) are NOT included in the distribution. This is how it is now. The documentation could say "msgfmt and msgunfmt support C# if mono/mcs available at run time and enabled at build time."

But such a documentation is not really helpful, because the user must try anyway. Possibly we could have an option 'msgfmt --supported-languages' and 'msgunfmt --supported-languages' (or similar). But an extra option, just to tell the user whether to expect an error message or not? This sounds like overkill.

Regarding a) vs. b): The PACKAGING file already mentions the need to have mono installed at build time. a) would have the advantage that fewer build tools are needed. However, it would also introduce versioning issues: what if the C# version of the tarball creator is newer than the C# version of the user who installs the package? So, a) would be nice but would introduce issues. I prefer to stay with b).

In summary, while I agree that there is an issue, I don't see a way to fix it without overkill.

Bruno Haible <haible>
Project AdministratorIn charge of this item.
Tue 09 Apr 2019 04:41:41 PM UTC, comment #1: 

The same is with gettext java support documentation.

Tomasz Kłoczko <kloczek>
Tue 09 Apr 2019 04:33:58 PM UTC, original submission:  

csharp documentation is installed even if --disable-csharp is passed to configure options.

Tomasz Kłoczko <kloczek>

 

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by haible (Updated the item)
  • -email is unavailable- added by kloczek (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2019-08-18 haible Open/ClosedOpen => Closed
    2019-08-18 haible StatusNone => Wont Fix
        Assigned toNone => haible
    2019-04-09 haible CategoryNone => Build
        Severity3 - Normal => 2 - Minor
        Summarycharp documentation is installed even if csharp support is disabled => C# documentation is installed even if csharp support is disabled

    Back to the top


    Powered by Savane 3.5