{"id":624,"date":"2010-05-20T20:14:00","date_gmt":"2010-05-20T19:14:00","guid":{"rendered":"http:\/\/blog.m-ri.de\/?p=624"},"modified":"2010-05-14T19:53:41","modified_gmt":"2010-05-14T18:53:41","slug":"vs-tipps-tricks-kommentare-intelligent-und-einfach-formatieren","status":"publish","type":"post","link":"http:\/\/blog.m-ri.de\/index.php\/2010\/05\/20\/vs-tipps-tricks-kommentare-intelligent-und-einfach-formatieren\/","title":{"rendered":"VS-Tipps &#038; Tricks: Kommentare intelligent und einfach umbrechen"},"content":{"rendered":"<p>\u00a0Wer programmiert, der dokumentiert auch. Denke ich zumindest \ud83d\ude00<\/p>\n<p>Ich zumindest habe teilweise Kommentare, die sich \u00fcber 10 bis zu 100 Zeilen erstrecken. Die sind nah am Code und erkl\u00e4ren, oft was die Hintergr\u00fcnde f\u00fcr das gew\u00e4hlte Design und Vorgehen sind.<\/p>\n<p>Leider ist aber der Editor vom Visual Studio kein Word. D.h. absatzweisen Umbruch kennt das Ding nicht und manuell solche Texte inkl. Einr\u00fcckungen und Listen mit Bindestrichen oder 1., 2., 3. zu formatieren ist etwas was gar keinen Spa\u00df macht. Zudem sind die Kommentar Zeichen \/\/ oder * eher l\u00e4stig als hilfreich beim schreiben.<br \/>\nUnd auch VAX muss hier mal passen. Aber! Netterweise gibt e auch andere Addins.<\/p>\n<p>Ich habe vor langer Zeit schon den <em>Comment Reflower<\/em>\u00a0 entdeckt. Mit dem ist das Ganze ein Klacks.<br \/>\nAus dem nachfolgenden Text:<\/p>\n<pre lang=\"cpp\">\/\/ Dies ist ein Kommentar, den man nicht wirklich hier schreiben\r\n\/\/ m\u00fcsste und der\r\n\/\/ eigentlich nichts bedeutet au\u00dfer\r\n\/\/ die Funktionen von einem netten Addin zu zeigen.\r\n\/\/ Das\r\n\/\/  1. wirklich Arbeit erspart\r\n\/\/  2. total simpel zu bedienen ist\r\n\/\/  3. f\u00fcr alle VS-Versionen von 2005 \u00fcber 2008 bis 2010 verf\u00fcgbar ist.\r\n\/\/ Was bei der Formatierung heraus kommt l\u00e4sst sich sehen.<\/pre>\n<p>Wird in Null-Komma-Nichts der folgende Text:<\/p>\n<pre lang=\"cpp\">\/\/ Dies ist ein Kommentar, den man nicht wirklich hier\r\n\/\/ schreiben m\u00fcsste und der eigentlich nichts bedeutet\r\n\/\/ au\u00dfer die Funktionen von einem netten Addin zu\r\n\/\/ zeigen. Das\r\n\/\/  1. wirklich Arbeit erspart\r\n\/\/  2. total simpel zu bedienen ist\r\n\/\/  3. f\u00fcr alle VS-Versionen von 2005 \u00fcber 2008 bis\r\n\/\/     2010 verf\u00fcgbar ist.\r\n\/\/ Was bei der Formatierung heraus kommt l\u00e4sst sich\r\n\/\/ sehen.<\/pre>\n<p>Wer noch mehr Beispiele sehen will, was das Tool leistet findet hier auf der Sourceforge Seite ein <a href=\"http:\/\/commentreflower.sourceforge.net\/ExampleFile.cpp\" target=\"_blank\">Vorher<\/a> <a href=\"http:\/\/commentreflower.sourceforge.net\/ExampleFileAfter.cpp\" target=\"_blank\">Nacher <\/a>P\u00e4rchen.<\/p>\n<p>Das Addin existiert f\u00fcr alles Visual Studio Versionen ab 2005.<br \/>\nEs kann hier heruntergeladen werden:<\/p>\n<ul>\n<li>VS-2005: <a href=\"http:\/\/commentreflower.sourceforge.net\/\" target=\"_blank\">http:\/\/commentreflower.sourceforge.net\/<\/a><\/li>\n<li>VS-2008 und VS-2010: <a href=\"http:\/\/www.kynosarges.de\/CommentReflower.html\" target=\"_blank\">http:\/\/www.kynosarges.de\/CommentReflower.html<\/a><\/li>\n<\/ul>\n<p>PS: Es empfiehlt sich ein Blick auf die Blockdefnition in den Einstellungen. Dort ist oft ein Leerzeichen hinter dem * bzw. \/\/ eingetragen. Leider l\u00e4sst sich in meiner Version hier RegEx nicht einschalten. Wer also ein &lt;tab&gt;-Zeichen hinter dem * oder \/\/ hat wird sich wundern wenn das Addin keinen Kommentar findet. Ich habe das Leerzeichen einfach entfernt&#8230;<\/p>\n<p>PPS: F\u00fcr alle nicht C++ Entwickler. Das Tool funktioniert auch f\u00fcr VB und C# \u2757<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u00a0Wer programmiert, der dokumentiert auch. Denke ich zumindest \ud83d\ude00 Ich zumindest habe teilweise Kommentare, die sich \u00fcber 10 bis zu 100 Zeilen erstrecken. Die sind nah am Code und erkl\u00e4ren, oft was die Hintergr\u00fcnde f\u00fcr das gew\u00e4hlte Design und Vorgehen sind. Leider ist aber der Editor vom Visual Studio kein Word. D.h. absatzweisen Umbruch kennt &hellip; <a href=\"http:\/\/blog.m-ri.de\/index.php\/2010\/05\/20\/vs-tipps-tricks-kommentare-intelligent-und-einfach-formatieren\/\" class=\"more-link\"><span class=\"screen-reader-text\">\u201eVS-Tipps &#038; Tricks: Kommentare intelligent und einfach umbrechen\u201c <\/span>weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[3,12,76,27,172,31],"tags":[238,36,44,37],"class_list":["post-624","post","type-post","status-publish","format-standard","hentry","category-programmieren","category-software","category-tools","category-vs2008","category-vs2010","category-vs-tipps-tricks","tag-tipps","tag-vs-2005","tag-vs-2008","tag-vs-tippstricks"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/posts\/624","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/comments?post=624"}],"version-history":[{"count":1,"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/posts\/624\/revisions"}],"predecessor-version":[{"id":625,"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/posts\/624\/revisions\/625"}],"wp:attachment":[{"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/media?parent=624"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/categories?post=624"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/blog.m-ri.de\/index.php\/wp-json\/wp\/v2\/tags?post=624"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}