{"id":2225,"date":"2008-01-27T16:24:00","date_gmt":"2008-01-27T16:24:00","guid":{"rendered":"http:\/\/www.b.shuttle.de\/hayek\/Hayek\/Jochen\/wp\/blog-de\/2008\/01\/27\/software-inline-dokumentation\/"},"modified":"2008-01-27T16:24:00","modified_gmt":"2008-01-27T16:24:00","slug":"software-inline-dokumentation","status":"publish","type":"post","link":"https:\/\/wp.jochen.hayek.name\/blog-de\/2008\/01\/27\/software-inline-dokumentation\/","title":{"rendered":"Software-Inline-Dokumentation"},"content":{"rendered":"<p>\t\t\t\tDa kam im Gespr\u00e4ch mit einem Kollegen das Thema Inline-Dokumentation auf<br \/>\nund ob dieses oder jenes kennen w\u00fcrde.<br \/>\n    <br \/>\nEs scheinen immer mehr alternative Markup-Sprachen mehr oder weniger kurzfristig in Mode zu kommen,<br \/>\nsie hei\u00dfen <q>mark-down<\/q> und anscheinend <q>asciidoc<\/q>.<br \/>\nIch halte das f\u00fcr Quatsch.<br \/>\n    <br \/>\nIm PERL-Umfeld (und wir gingen vom PERL-Umfeld aus) ist eigentlich POD das richtige,<br \/>\ndamit kann man PERL ganz toll inline dokumentieren.<br \/>\n    <br \/>\nUnd dann kann man es mit Getopt::Long verheiraten<br \/>\nund bekommt eine Usage- oder andere Meldung hin,<br \/>\ndie aus der Inline-Dokumentation abgeleitet ist.<br \/>\n    <br \/>\nJede Sprache hat so ihre pr\u00e4ferierte Methode, inline zu dokumentieren,<br \/>\nund bei PERL ist das eben POD,<br \/>\nbei Java Javadoc,<br \/>\nbei Ruby RDoc, &#8230;<br \/>\n    <br \/>\nWenn ihr ein Beispiel f\u00fcr POD und die Kombination mit Getopt::Long brauchst,<br \/>\ndann lasst es mich wissen!<br \/>\n    <br \/>\nWenn ihr allerdings <em>nicht<\/em> inline dokumentieren wollt,<br \/>\ndann ist wohl DocBook <em>die<\/em> Sache.<br \/>\nUnd DocBook ist wirklich toll.<br \/>\nUnd auch mit DocBook lassen sich man-pages gestalten und generieren.\t\t\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Da kam im Gespr\u00e4ch mit einem Kollegen das Thema Inline-Dokumentation auf und ob dieses oder jenes kennen w\u00fcrde. Es scheinen immer mehr alternative Markup-Sprachen mehr oder weniger kurzfristig in Mode zu kommen, sie hei\u00dfen mark-down und anscheinend asciidoc. Ich halte das f\u00fcr Quatsch. Im PERL-Umfeld (und wir gingen vom PERL-Umfeld aus) ist eigentlich POD das [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_crdt_document":"","advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"_share_on_mastodon":"0"},"categories":[352],"tags":[],"class_list":["post-2225","post","type-post","status-publish","format-standard","hentry","category-nicht-zugeordnet"],"share_on_mastodon":{"url":"","error":""},"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/paO0l8-zT","jetpack_likes_enabled":true,"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/posts\/2225","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/comments?post=2225"}],"version-history":[{"count":0,"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/posts\/2225\/revisions"}],"wp:attachment":[{"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/media?parent=2225"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/categories?post=2225"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wp.jochen.hayek.name\/blog-de\/wp-json\/wp\/v2\/tags?post=2225"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}