Talk:Programming Guidelines

From Dreamwidth Notes
Revision as of 07:58, 15 January 2009 by 76.218.67.128 (Talk)

Jump to: navigation, search

A few things:

  • I like 80 as the line length limit, not 120. (I can see a point for a longer limit in actual statements, which may be what you meant, but for comments, 80 is (IMO) better.)
  • "&foo;" should probably be rewritten as "foo();" unless there's a reason why it needs to remain that way. (And if there's a reason, it should be explained in code.)
  • There should be a reference for <LJFUNC> function interface definitions. Or a decision to do away with them. If we keep them, adding them should probably be an ongoing clean-up task.

Pauamma 09:04, 14 August 2008 (UTC)

(LJFUNC should die and we should use something that the rest of the world uses, POD. Xb95 today when I wrote this)

dw-nonfree suggested header

   #!/usr/bin/perl
   #
   # DW::Sort::Pessimal::Bizarre::ThreeNumbers
   #
   # This module sorts three numbers using absurdly many comparisons.
   #
   # Authors:
   #      J. Random Hacker <jrh@example.com>
   #
   # Copyright (c) 2009 by Dreamwidth Studios, LLC.
   #
   # This program is NOT free software or open-source; you can use it as an
   # example of how to implement your own site-specific extensions to the
   # Dreamwidth Studios open-source code, but you cannot use it on your site
   # or redistribute it, with or without modifications.
   #