SubMain - CodeIt.Right The First Time!

/Community

A Support Community for SubMain Products
 Home Products Services Download Purchase Support
in Search
 
Home Forums Blogs Tutorials Downloads
Welcome to SubMain Community Sign in | Join | Help

Change language of comments

Last post 06-10-2010, 1:25 AM by AlexNek. 6 replies.
Sort Posts: Previous Next
  •  10-29-2009, 10:00 AM 966

    Change language of comments

    Hello,

    I have my comments in french and I would like to get them in english so that we can generate documentation in english for non-french people.

    I read from a previous post that the language of comments depends of the localized .NET framework language.

    Actually in my installed programs, I see for example some additional language resources:

    • Module linguistique Microsoft .NET Framework 3.5 SP1 - fra
    • Microsoft .NET Framework 3.0 Service Pack 2 Language Pack - FRA
    • Module de prise en charge linguistique de Microsoft .NET Framework 2.0 - fra

    Isn't it possible to have an option for choosing if GhostDoc has to use the localized version of .NET framework or the original english version?

    If it not possible, could you provide the english support separately?

    I know that it is a common issue for a lot of people and it could be great to find a solution apart the one consisting to uninstall the .NET language resources.

    Thanks.

    Regards,
    Adriano

  •  10-29-2009, 1:18 PM 967 in reply to 966

    Re: Change language of comments

    Hi Adriano,

    GhostDoc will go look for the information in the .NET assemblies referenced in your specific solution. You may have multiple frameworks/versions installed but you are only referencing one of them in the solution.

    From the list of the installed frameworks you provided above I see ver 2.0, 3.0 and 3.5 but they all seem to be French locale. It looks like you don't even have the English version installed?

    Thanks!

     


    Thank you,
    Serge Baranovsky
    http://submain.com - .NET Developer Tools  |  Microsoft VB MVP  |  http://vbcity.com - VB Developer Community
    » » (Static Code Analysis + Automatic Refactoring) / Painless Coding Guidelines = CodeIt.Right - http://submain.com/codeit.right
    » » C#/VB .NET Coding Guidelines - FREE 100+ page ebook (PDF) http://submain.com/guidelines
  •  06-10-2010, 12:13 AM 1283 in reply to 967

    Re: Change language of comments

    Hi Serge,

    I personally thinking that it is very bad idea choose comment language automatically. Why not over user setting?

    I have the same trouble - how can I force English language for comments?

     

  •  06-10-2010, 12:19 AM 1284 in reply to 1283

    Re: Change language of comments

    Alex,

    GhostDoc generates comment only in one language - English. This is true for the comments based on the code element name.

    When GhostDoc pulls the base class comment from the .NET Framework, it only can get the base class comment from the FW that your reference in your project. So, if you are referencing non-English FW, then the "inherited" comments will in the language of the FW.

    I hope this makes sense.

    Thanks!


    Thank you,
    Serge Baranovsky
    http://submain.com - .NET Developer Tools  |  Microsoft VB MVP  |  http://vbcity.com - VB Developer Community
    » » (Static Code Analysis + Automatic Refactoring) / Painless Coding Guidelines = CodeIt.Right - http://submain.com/codeit.right
    » » C#/VB .NET Coding Guidelines - FREE 100+ page ebook (PDF) http://submain.com/guidelines
  •  06-10-2010, 12:22 AM 1285 in reply to 1283

    Re: Change language of comments

    And to answer your question how you force GhostDoc to populate English "inherited" comments - make sure that your solution is referencing English version of the .NET Framework. That's it.

     


    Thank you,
    Serge Baranovsky
    http://submain.com - .NET Developer Tools  |  Microsoft VB MVP  |  http://vbcity.com - VB Developer Community
    » » (Static Code Analysis + Automatic Refactoring) / Painless Coding Guidelines = CodeIt.Right - http://submain.com/codeit.right
    » » C#/VB .NET Coding Guidelines - FREE 100+ page ebook (PDF) http://submain.com/guidelines
  •  06-10-2010, 1:21 AM 1287 in reply to 1284

    Re: Change language of comments

    I hope this makes sense.

    >2 different comment languages for one project dependent from the base class? It is nichtmare, i think.

    ..

    PS: It is worst as I thinking. I can have 2 different comment languages in one class!!

     

    /// <summary> Gets or sets a value indicating whether [hook mouse down].  </summary>

    /// <value><c>true</c> if [hook mouse down]; otherwise, <c>false</c>.</value>

    public virtual bool HookMouseDown

    ...

    /// <summary> Ruft den aktuellen Text in der <see cref="T:System.Windows.Forms.TextBox"/> ab oder legt diesen fest. /// </summary>

    /// <value></value>/// <returns> Der im Steuerelement angezeigte Text. /// </returns>

    public override string Text

    ...

    Ps1:But comments itself is great.

    Ps2: I think I understood why you did it. "It is better to copy comments from the parent class as create it new". For me it make sence to create 2 settings: Don't copy comments from system library, don't copy comments from parent class.

  •  06-10-2010, 1:25 AM 1288 in reply to 1285

    Re: Change language of comments

    >make sure that your solution is referencing English version of the .NET Framework.

    I must found the answer - how I know it and where I found english version because Microsoft say

    "Microsoft .NET Framework Redistributable Package Version 2.0

    There is no language pack for the English version of this redistributable package. If you wish to install the language pack for a different language, please return to the Microsoft Download Center page where you found this download and select a different language."

    ..

    PS: I check version of installed Dlls Language - "English USA" but windows and MSVC is in Germany.

    PS2: I found how I can make it (copied from an other "English computer") but it is not a solution because all team members must have exact the same development envinroment as the most of our customers.

View as RSS news feed in XML
 
     
 
Home |  Products |  Services |  Download |  Purchase |  Support |  Community |  About Us |