[LON-CAPA-cvs] cvs: loncom /metadata_database searchcat.pl

Guy Albertelli II lon-capa-cvs@mail.lon-capa.org
Mon, 3 Feb 2003 08:32:49 -0500 (EST)


Hi Scott,

+    # BEWARE ALL WHO TRY TO UNDERSTAND THIS ABSURDLY HORRIBLE SUBROUTINE.
+
+    # Do all sorts of mumbo-jumbo to compute the user's directory.

I understand it can be sometimes more than a little annoying trying to
read/understand some elses code.

I would ask that you not embed comments like this in the code it is
mainly disheartening to others and serves no real useful purpose.

A simple:

# this is code seems to be non-obvious

is sufficient.


Remeber this is a team effort and deriding other members of the team
is not helpful.


-- 
guy@albertelli.com          BM: n^20 t20 z20 qS 
Guy Albertelli -7-7-5-  O-
    Why do ducks have webbed feet?  To stamp out fires.
    Why do elephants have flat feet?  To stamp out burning ducks.