-----BEGIN PGP SIGNED MESSAGE----- Moin,
On Monday 18 August 2003 16:17, Michael G Schwern wrote: > On Mon, Aug 18, 2003 at 09:43:34AM -0400, Potozniak, Andrew wrote: > Ironicly, the style you don't like in #1 is the very style you promote in > #2. Replace '"black box" commenting' with POD documentation and you I usually add the _users_ doc at the end, e.g. "What does this function do, what are the input, output etc". Anything like "how does it really work internally" is in comments at the code. Anyway, this is personal style, so there is really no way to "solve" that non-existant problem. Ok, maybe you could build an editor that re-arranges the pod, doc, comments and code so that it suits your taste on-the-fly, and upon saving preserves the original style of the file... Cheers, Tels - -- Signed on Mon Aug 18 18:31:33 2003 with key 0x93B84C15. PGP key on http://bloodgate.com/tels.asc or per email. "I am so hot." - "Thirsty?" - "No, good looking." -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2-rc1-SuSE (GNU/Linux) Comment: When cryptography is outlawed, bayl bhgynjf jvyy unir cevinpl. iQEVAwUBP0D/ZncLPEOTuEwVAQG5fwf7Bbzrm0/pBjiUGvOOWfCNjC24LrZz3s1g b5Ego6sndhfoZ+gPSwi/Dg4EmyeTjJo2GSGl5j4umYeUx5/VFdt6aD7ljO+TSvg5 YfrRr6rJYzXQRUzS8rg0xTmn5n7mbhhkBM4Ox4551O0tGEBTBa2VJw/xderDM836 o6vB1seVg1CGhRBw0Gr0t8k9+mirR+QkqLskvfewwCCd7psg1qrfxZ5abGvZ+7WA c/g3/ZH1yuiRs+RlhBWEIlQAGrL5qnjirOEt+dfkyF9gU6dBzCLOyJsOIZ/h+1Aj FgVK8g+K61SW5JVbjz26hYGtAx+OdpYwPPWVPA+N+17NAz0IxQqGwA== =UitZ -----END PGP SIGNATURE-----
